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

# Set up Atlas in your assistant

> Connect Atlas to Claude, ChatGPT, Claude Code or Codex in about two minutes.

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

> [tab] Claude
>
> **1. Add Atlas as a custom connector**
>
> Go to [Claude connector settings](https://claude.ai/customize/connectors) and select **Add custom connector**.
>
> **2. 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
> ```
>
> **3. Add and connect**
>
> Click **Add**, then select **Connect** on the new Atlas row.
>
> **4. Sign in to Atlas**
>
> Sign in with your Atlas Merchant Portal account, not a personal account. Choose the merchant you want Claude to see, then approve the connection.
>
> **5. 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.

> [tab] ChatGPT
>
> **1. Open Atlas in ChatGPT**
>
> Go to [Atlas in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_69fc453d9f388191b28b287ff7624643). One tap, nothing to copy.
>
> **2. Connect your Atlas account**
>
> Follow the prompts to sign in. Choose the merchant you want ChatGPT to see, then approve the connection.
>
> **3. Add Atlas to a chat**
>
> Start a new chat and add **Atlas** from the tools menu. Then ask away.
>
> > [!NOTE]
> >
> > ChatGPT reads and writes Atlas data through the chat itself. Its canvases and apps can't call Atlas directly, so you confirm each change in the conversation. Use Claude if you want a dashboard that saves to Atlas as you edit it.

> [tab] Claude Code
>
> If you sign in to Claude Code with the same Claude account, connect Atlas once from [Claude connector settings](https://claude.ai/customize/connectors) and it appears here automatically. Run `/mcp` to check for **claude.ai Atlas**.
>
> Otherwise, add it from your terminal:
>
> ```bash theme={null}
> 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.

> [tab] Codex
>
> Add Atlas to `~/.codex/config.toml`:
>
> ```toml theme={null}
> [mcp_servers.atlas]
> url = "https://mcp.atlas.kitchen"
>
> [mcp_servers.atlas.oauth]
> client_id = "F-9hyHU9Or0O59Zf9w9pSZ2UHf8Zo9Aoi5oq1CWtV-k"
> ```
>
> Then sign in:
>
> ```bash theme={null}
> 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

> [accordion] Sign-in fails or loops back
>
> * Sign in with your Atlas Merchant Portal account, not a personal account.

> [accordion] 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.

> [accordion] 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](#switch-merchants) below.

> [accordion] 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.

> [accordion] 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](mailto: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](https://claude.ai/customize/connectors)
* **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](https://help.atlas.kitchen/connect/admin-api/authentication.md). The same token works with the MCP headers above.

## Next steps

> [card] [Quickstart](https://help.atlas.kitchen/connect/mcp/recipes.md)
>
> Copy-paste prompts for costs, allergens, cross-sells and modifiers

> [card] [What Atlas MCP can do](https://help.atlas.kitchen/connect/mcp/overview.md)
>
> What your assistant can see and change


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.