Connect Claude

Add Kentro MCP to Claude on the web or Claude desktop as a custom connector, then approve the connection in Kentro.

Claude on the web (claude.ai) and Claude desktop connect to Kentro MCP as a custom connector. There is no API key: you sign in to Kentro in a browser window and approve the connection.

Before you start

  • A Kentro user in a workspace where Kentro Assistant is on.
  • Your workspace key: the first part of the address you sign in at (acme for acme.kentro.app).
  • A Claude plan and organization settings that allow custom connectors. In a Claude organization, an owner may have to allow or add the connector first.

1. Copy the endpoint

In Kentro IQ, open Assistant > Assistant Settings (https://<workspace>.kentro.app/iq/assistant-settings). In the Connect your AI tools (MCP) panel, copy the Endpoint:

https://apis.kentro.live/kiq/v1/copilot/mcp

2. Add the connector in Claude

  1. In Claude, open Settings, then Connectors.
  2. Choose Add custom connector.
  3. Name it Kentro and paste the endpoint URL.
  4. Confirm. Claude opens a browser window to Kentro; if it does not, connect the new connector from its entry in Connectors.

Claude desktop uses the same steps in its own Settings.

3. Sign in and approve

  1. If you are not signed in to Kentro, the window asks for your workspace: type your Workspace key, click Continue, and sign in as usual.
  2. The page Connect to Kentro Assistant names the client, the host it returns to (claude.ai for Claude) and your workspace, and states that the client acts with exactly your permissions.
  3. Click Approve. The window hands control back to Claude, and the connector shows as connected.

Deny ends the request, and Claude receives an access-denied answer. A connection request lasts 10 minutes; after that, start again from Claude.

4. Use it

Start a chat with the Kentro connector enabled and ask:

Use getSessionContext and tell me which workspace and user you are connected as.

Then try a task for the assistant:

Using askCopilot, produce a daily operations digest: new orders and revenue today vs yesterday, anything stuck in fulfillment, and inventory that needs attention.

Where Claude lists a connector's prompts, the Kentro prompts daily-ops-digest and investigate-order start the same kind of request.

Several workspaces

A connection belongs to the workspace you approved it in. To connect another workspace, add a second connector with the same URL and a different name (Kentro EU), and sign in to the other workspace when the window opens.

Troubleshooting

What you seeWhat to do
This connection request has expired. Go back to your AI client and try connecting again.The request is older than 10 minutes or was already used. Start again from Claude.
Your workspace's billing needs attention before an AI client can be connected.An admin resolves billing in Kentro under Billing, then you connect again.
A tool answers This workspace is out of Copilot credit. An admin can top up in Billing.An admin adds credit under Billing.
A tool answers Rate limit exceeded. Retry in 30s.Wait for the time shown. The limits are on Security and data.
Only knowledge base and tutorial tools appearYour permissions limit the assistant to Help Center content. Ask an admin.
The connector stopped workingThe connection may have been revoked in Assistant Settings. Remove the connector in Claude and add it again.

Related


Did this page help you?