Connecting clients

​

MCP URL (copy this)

https://mcp.keystoneb2b.io/mcp

​

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).

​

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.”

​

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:

https://mcp.keystoneb2b.io/mcp

{
  "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

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.

​

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

​

Related

• Overview — what Keystone MCP can and cannot do
• Authentication & security — OAuth, scopes, and privacy
• Platform Settings — enable MCP for the brand
• AI Assistant (Gus) — same read-only tools inside Keystone