> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keystoneb2b.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting clients

> Step-by-step setup for Claude, Cursor, and ChatGPT with Keystone MCP.

<Note>
  **Who this is for:** Brand users and sales reps. A brand **Administrator** must enable MCP under [Platform Settings](/settings/platform-settings) before anyone can connect. Buyer (account) users cannot connect.
</Note>

## MCP URL (copy this)

Paste this into your AI tool. The `/mcp` path is required.

```text theme={null}
https://mcp.keystoneb2b.io/mcp
```

You can also copy it from Keystone: **Settings → MCP connections**.

## Before you start

1. Confirm MCP is **enabled** for your brand (**Settings → Platform Settings → Enable MCP**).
2. Sign in to Keystone as a **brand** or **rep** user (same account you use every day).
3. Use an AI client that supports **remote MCP with OAuth** (browser sign-in).

When you connect, the AI tool opens Keystone in your browser. Sign in if needed, then choose **Allow read-only access**. Keystone never asks for a separate MCP password.

***

## Claude (claude.ai or Claude Desktop)

1. Open Claude → **Settings** → **Connectors** (sometimes labeled **Integrations**).
2. Add a **custom** / **remote MCP** connector.
3. Paste `https://mcp.keystoneb2b.io/mcp` as the server URL.
4. Complete the browser flow: Keystone login (if needed) → **Allow read-only access**.
5. Return to Claude and start a chat. Ask something like: “Show my open orders this month.”

Claude loads Keystone tools automatically after a successful connection.

***

## Cursor

1. Open **Cursor Settings** → **MCP** (or **Features → MCP**).
2. Add a new MCP server and choose a **remote / URL** connection (not a local command).
3. Set the URL to:

```text theme={null}
https://mcp.keystoneb2b.io/mcp
```

Or add this to your Cursor MCP config (`mcp.json`):

```json theme={null}
{
  "mcpServers": {
    "keystone": {
      "url": "https://mcp.keystoneb2b.io/mcp"
    }
  }
}
```

4. Save, then complete the browser OAuth flow on Keystone (**Allow read-only access**).
5. Confirm the server shows as connected and tools such as `whoami` or `find_sales_orders` appear.
6. In Agent/Chat, ask a Keystone question (for example, “Which accounts haven’t ordered in 90 days?”).

***

## ChatGPT

Menu names vary by plan (Team / Enterprise / custom connectors).

1. Open ChatGPT settings for **connectors**, **custom MCP**, or **apps** (wording depends on your workspace).
2. Add a new connector and paste `https://mcp.keystoneb2b.io/mcp`.
3. Authorize in the Keystone browser window when it opens.
4. Enable the connector in a chat, then ask a read-only question about accounts, orders, or inventory.

If your ChatGPT plan does not support remote MCP connectors yet, use Claude or Cursor instead.

***

## After connecting

* Ask **whoami** (or “Who am I in Keystone?”) to confirm your role and active brand.
* Multi-brand reps: use **list\_brands** / **set\_active\_brand** to switch brands (same idea as the in-app brand switcher). Data tools follow the active brand.
* Revoke anytime in Keystone: **Settings → MCP connections → Revoke**.
* Turning off **Enable MCP** in Platform Settings blocks new connections and stops existing ones on the next tool call.

## Troubleshooting

| Symptom                            | What to check                                                                                               |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Consent says MCP is not available  | You are a buyer account, or no brand has MCP enabled. Ask an admin to enable MCP; use a brand/rep login.    |
| Tools return empty / access denied | Confirm MCP is still on for your **active** brand; try `list_brands`. Reps only see their book of business. |
| OAuth window closes with an error  | Start the connection again from the AI client; authorize within \~10 minutes.                               |
| Wrong brand’s data                 | Call `list_brands`, then `set_active_brand` with the correct brand.                                         |

## Related

* [Overview](/mcp/overview) — what Keystone MCP can and cannot do
* [Authentication & security](/mcp/authentication) — OAuth, scopes, and privacy
* [Platform Settings](/settings/platform-settings) — enable MCP for the brand
* [AI Assistant (Gus)](/features/ai-assistant) — same read-only tools inside Keystone