Skip to main content
This guide explains how to connect your AI tool to your Chariow store using the Model Context Protocol.

​
MCP endpoint

All AI tools connect to the same endpoint:
This endpoint uses the Streamable HTTP transport. The legacy HTTP+SSE transport is not supported.

​
Claude

Claude supports MCP through custom connectors on both Claude Desktop and Claude.ai (Pro/Max plans).
1

Open Settings

In Claude Desktop or Claude.ai, go to Settings → Connectors.
2

Add custom connector

Click Add custom connector and enter:
  • URL: https://mcp.chariow.com/public
3

Authenticate

Click Add. You’ll be redirected to Chariow to authorise access to your store.
4

Start using

Open a new conversation and ask Claude about your store. For example: “Show me my recent sales”.
Custom connectors require Claude Pro, Max, Team, or Enterprise. See Claude’s MCP documentation for details.

​
ChatGPT

ChatGPT supports MCP connectors for accessing external tools.
1

Enable developer mode

Go to Settings → Apps & Connectors → Advanced settings and enable developer mode.
2

Create connector

Navigate to Settings → Connectors → Create and enter:
  • Connector name: Chariow
  • Description: Access your Chariow store data
  • Connector URL: https://mcp.chariow.com/public
3

Authenticate

Complete the OAuth flow to connect your Chariow account.
4

Use in chat

Start a new chat, click +, select More, and choose Chariow from your available tools.
ChatGPT will show tool-call confirmations. Write operations require approval unless you choose to remember your decision.

​
Cursor

Cursor connects to remote MCP servers through configuration files.
1

Open MCP settings

Go to Settings → Features → MCP.
2

Add server

Click Add new MCP server and enter the Chariow URL, or create a configuration file at .cursor/mcp.json:
1

Authenticate

When you first use a Chariow tool, you’ll be prompted to authenticate via OAuth.
See Cursor’s MCP documentation for more configuration options.

​
Windsurf

Windsurf supports remote MCP servers through its extensions settings.
1

Open settings

Go to Settings → Extensions → MCP.
2

Add server

Add a new MCP server with:
1

Authenticate

Complete the OAuth flow when prompted to connect your Chariow account.

​
Claude Code (CLI)

For Claude Code, add the Chariow server using the CLI:
You’ll be prompted to authenticate via OAuth on first use.

​
Other MCP clients

Any MCP client that supports remote servers with OAuth can connect. The server follows the MCP authorisation specification, so most clients only need the endpoint URL and discover the rest automatically. Registration rules:
  • Any https redirect URI is accepted.
  • Loopback redirect URIs (http://localhost, http://127.0.0.1, http://[::1]) are accepted on any port, for native clients.
  • Custom schemes such as cursor:// or claude:// are accepted only for clients Chariow has verified. Plain http outside loopback, and URIs with credentials or a fragment, are rejected.
  • A registered client stays valid for 30 days. Registration is limited to 10 requests per minute and 100 per day per IP address.
The consent screen shows clients Chariow has reviewed as verified, and warns about every other client. Check the client name and redirect address before you approve. The access token is a store API key dedicated to the connection. It carries the read scopes your team role allows, never write scopes. No refresh token is issued: when the connection is revoked or expires, the client must go through the authorisation flow again.

​
Verify connection

After setup, verify your connection is working:
  1. Start a new conversation with your AI tool
  2. Ask: “Show me my Chariow store information”
  3. The AI should display your store name, URL, and settings
Try these example prompts:
  • “List my recent sales”
  • “How many customers do I have?”
  • “What are my best-selling products?”

​
Troubleshooting

  • Verify the URL is correct: https://mcp.chariow.com/public
  • Restart your AI tool completely
  • Try removing and re-adding the connector
  • Ensure you’re logged into your Chariow account
  • Check that your store is active and that you are an active member of its team
  • Clear browser cookies and try again
  • If the client reports an invalid redirect URI, it uses a redirect address Chariow does not accept (see Other MCP clients)
  • Some tools are hidden by your team role: a tool outside your role is neither listed nor callable (see Supported tools)
  • Restart your AI tool
  • For file-based config, verify JSON syntax is valid
  • In ChatGPT, click Refresh in Connectors settings
The MCP server allows 60 requests per minute per connection. Wait a moment before continuing.
  • Connections unused for 30 days are revoked automatically
  • Connections are deleted when the team member who approved them loses access to the store
  • Reconnecting the same client from the same account replaces the previous token
In each case, remove the connector and add it again to authorise a new connection.

​
Revoke access

To disconnect an AI tool from your store:
  1. Go to your Chariow Dashboard
  2. Navigate to Settings → API Keys
  3. Find the MCP connection and click Revoke

​
Next steps

Supported tools

See all 46 available tools

Security

Learn about data sharing and security