Set up Atlas in your assistant

What this does

This connects your assistant to your live Atlas data. After it’s done, you can ask about sales, edit menus, or 86 an item in plain language. Pick your assistant below and follow the steps to connect Atlas.

Claude
ChatGPT
Claude Code
Codex

Add Atlas as a custom connector

Go to Claude connector settings and select Add custom connector.

Fill in the connector details

Name: Atlas
Remote MCP server URL: https://mcp.atlas.kitchen
OAuth Client ID: F-9hyHU9Or0O59Zf9w9pSZ2UHf8Zo9Aoi5oq1CWtV-k
Client Secret: leave empty

Add and connect

Click Add, then select Connect on the new Atlas row.

Sign in with your Atlas Merchant Portal account, not a personal account. Choose the merchant you want Claude to see, then approve the connection.

Turn Atlas on in a chat

Start a new chat. Select the + button below the message box, then switch on Atlas.

You only connect once. The connector follows your Claude account, so it works in the browser, the desktop app, the mobile app and Claude Code.

If you sign in to Claude Code with the same Claude account, connect Atlas once from Claude connector settings and it appears here automatically. Run /mcp to check for claude.ai Atlas.Otherwise, add it from your terminal:

claude mcp add-json --scope user atlas \
  '{"type":"http","url":"https://mcp.atlas.kitchen","oauth":{"clientId":"F-9hyHU9Or0O59Zf9w9pSZ2UHf8Zo9Aoi5oq1CWtV-k","callbackPort":48321,"scopes":"mcp"}}'

Then run /mcp, select Atlas and sign in. Choose a merchant, then approve the connection.

Add Atlas to ~/.codex/config.toml:

[mcp_servers.atlas]
url = "https://mcp.atlas.kitchen"

[mcp_servers.atlas.oauth]
client_id = "F-9hyHU9Or0O59Zf9w9pSZ2UHf8Zo9Aoi5oq1CWtV-k"

Then sign in:

codex mcp login atlas --scopes mcp

Codex opens Atlas in your browser. Sign in, choose a merchant, then approve the connection.

What should happen

Ask your assistant: “Using Atlas, how many orders did we do yesterday?” You should get a real number from your outlet within a few seconds, not a general answer about restaurants. The assistant shows you when it calls an Atlas tool.

If it doesn’t work

The assistant answers without touching Atlas

Turn Atlas on for that chat. In Claude, select the + button and switch on Atlas. In ChatGPT, add Atlas from the tools menu.
Start the request with “Using Atlas, …” so the assistant reaches for the connector.

You see the wrong outlet's data

You picked a different merchant when you signed in. Reconnect and choose the right one — see Switch merchants below.

Your assistant says it can't reach Atlas

Open your connector settings and check Atlas is still connected. Reconnect if it shows an error.
Sign-ins expire. Reconnecting fixes most one-off failures.

A change didn't show up in the Merchant Portal

Refresh the Merchant Portal page. If it’s still missing, ask the assistant to read the item back from Atlas. It will tell you whether the change actually saved.

If it still doesn’t work, contact support at hello@atlas.kitchen. Tell us which assistant you used and what you asked for.

Switch merchants

You connect to one merchant at a time. To change:

Claude: Reconnect Atlas from Claude’s connector settings
ChatGPT: Reconnect Atlas from ChatGPT’s app settings
Claude Code: Run /mcp, select Atlas, then Clear authentication. Sign in again and choose another merchant
Codex: Run codex mcp logout atlas, then codex mcp login atlas --scopes mcp. Sign in again and choose another merchant

Other clients

Any MCP-capable client can connect:

Setting	Value
URL	`https://mcp.atlas.kitchen`
Transport	Streamable HTTP
Headers	`X-Api-Key`, `X-Merchant-Id`

Need an API token? Follow the API authentication guide. The same token works with the MCP headers above.

Set up Atlas in your assistant

What this does

What should happen

If it doesn’t work

Switch merchants

Other clients

Next steps

Quickstart

What Atlas MCP can do

​What this does

​What should happen

​If it doesn’t work

​Switch merchants

​Other clients

​Next steps

Quickstart

What Atlas MCP can do

What this does

What should happen

If it doesn’t work

Switch merchants

Other clients

Next steps