Connecting an external AI client with Assistant MCP


Cavalry Intelligence
Last Updated: 7 hours ago

You can connect an MCP-compatible AI client, such as Claude, ChatGPT, or Cursor, directly to your Kodif account and administer it from there.

Getting the connection URL

Go to Administration > Assistant MCP. The page shows an MCP server URL.

It only appears when you are signed in through your organization login rather than the storefront login, and the connect flow authenticates through that same organization login.

Connecting

Add the URL as a remote MCP connector in your AI client. The client opens your Kodif organization login followed by a consent screen, then mints a token automatically. There is no API key to copy or store.

Consent grants one of two levels:

  • Read. Questions, analytics, and reviewing staged changes.

  • Read and write. Everything above, plus applying configuration changes.

To change the level later, reconnect.

What you can do once connected

Scoped to a storefront you choose:

  • List the storefronts the connection can manage

  • Ask analytics questions in plain language, covering orders, shipments, returns, revenue, conversations, and more

  • Ask or instruct the configuration assistant, which can answer configuration questions or stage changes to policies, escalation, AI settings, SOPs, and use cases

  • Review pending staged suggestions and apply them, which requires write access

Access and safety

Every action validates the target storefront against your live organization access. The connection cannot reach storefronts you do not already have permission for, and revoking someone's Kodif access revokes what their connected client can do.

💡 If you are unsure, start with Read. It covers analytics questions and lets you review anything the assistant proposes, without the ability to apply changes. You can reconnect with write access once you are comfortable.


Was this article helpful?