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

# Connect ChatSyncs to Claude

> Step-by-step instructions for connecting the ChatSyncs MCP server to Claude Desktop, claude.ai and Claude Code, including where to find your ChatSyncs API key, what the connect page asks for, and how to revoke access. Use when a customer asks how to set up the MCP, where to paste their API key, or how to disconnect.

Connecting takes about a minute. You do it **once** per app, and the connection then stays
active until you revoke it.

## First: get your API key

<Steps>
  <Step title="Open the Developer page">
    In ChatSyncs, go to **Control Panel → Developer**
    ([direct link](https://platform.chatsyncs.com/api/developer/console)).
  </Step>

  <Step title="Copy your API key">
    It's shown at the top of the page as **Your API key**.
  </Step>
</Steps>

<Warning>
  **Treat this key like your password.** Anyone holding it can send WhatsApp messages and read
  your customer data. Never paste it into a chat message, a support ticket, or a public
  repository — only into the connect screens below.
</Warning>

## Claude Desktop and claude.ai

The easiest route: you'll be shown a page that asks for your key.

<Steps>
  <Step title="Open connector settings">
    In Claude, go to **Settings → Connectors** and choose **Add custom connector**.
  </Step>

  <Step title="Enter the ChatSyncs server URL">
    Paste this and click **Add**:

    ```
    https://mcp.chatsyncs.com
    ```
  </Step>

  <Step title="Paste your API key">
    Claude opens a ChatSyncs page in your browser asking for your API key. Paste it and click
    **Connect**.

    We check the key with ChatSyncs straight away, so you'll see **"Connected as \<your
    business name>"** if it worked — and a clear error if the key was wrong, rather than a
    connection that silently fails later.
  </Step>

  <Step title="Done">
    You're returned to Claude and the ChatSyncs tools are available. Try asking
    *"What WhatsApp numbers are on my ChatSyncs account?"*
  </Step>
</Steps>

<Check>
  Only paste your key into a page whose address starts with `https://mcp.chatsyncs.com`. If the
  address is anything else, close it — someone is trying to collect your key.
</Check>

## Claude Code

One command, with your key sent as a header:

```bash theme={null}
claude mcp add --transport http chatsyncs https://mcp.chatsyncs.com/mcp \
  --header "Authorization: Bearer YOUR_CHATSYNCS_API_KEY"
```

Then check it:

```bash theme={null}
claude mcp list
```

## Other MCP apps

Any app that supports MCP over HTTP works. Use:

| Setting | Value |
| - | - |
| Server URL | `https://mcp.chatsyncs.com/mcp` |
| Transport | HTTP (sometimes called "Streamable HTTP") |
| Authentication | `Authorization: Bearer YOUR_CHATSYNCS_API_KEY` |

If your app's settings screen has no place for a header, you can put the key in the URL instead:

```
https://mcp.chatsyncs.com/mcp/k/YOUR_CHATSYNCS_API_KEY
```

<Warning>
  **Prefer the header if your app offers one.** A key inside a URL can end up recorded in server
  logs and browser history. Use the URL form only when there's no alternative, and regenerate your
  key if you think it has been exposed.
</Warning>

## Check that it worked

Ask your assistant:

> "Show me my ChatSyncs account details."

You should get your plan name, your usage, and each connected WhatsApp number. If you get an
error instead, see [Troubleshooting](/mcp/troubleshooting).

## Security

<AccordionGroup>
  <Accordion title="Where is my API key stored?">
    In your AI assistant's own credential storage — on your device, or in your Claude account.
    The ChatSyncs MCP server keeps **no database of customer keys**: your key arrives with each
    request, is used, and is discarded.
  </Accordion>

  <Accordion title="How do I revoke access?">
    Go to **Control Panel → Developer** in ChatSyncs and regenerate your API key. Every assistant
    still holding the old key stops working immediately. Then reconnect with the new key
    wherever you still want access.

    You can also remove the connector in your assistant's settings, which deletes its copy of
    the key.
  </Accordion>

  <Accordion title="Can the assistant do anything without asking me?">
    No. Claude requests your approval before each action. Actions that delete a contact or block
    someone are marked so you get a stronger warning.
  </Accordion>

  <Accordion title="Does ChatSyncs see my conversations with the AI?">
    No. Only the actions you approve reach ChatSyncs, as ordinary API calls. Your chat with the
    assistant stays between you and your AI provider.
  </Accordion>

  <Accordion title="Can I give the assistant read-only access?">
    Not from your side — a ChatSyncs API key carries all the permissions of the account it came
    from; there is no read-only key. The practical control is that Claude asks before every
    action, so nothing is sent without you approving it.
  </Accordion>
</AccordionGroup>

## Frequently asked

<AccordionGroup>
  <Accordion title="Do I have to install anything?">
    No. The server is hosted by ChatSyncs. You only add its address in your assistant's
    settings.
  </Accordion>

  <Accordion title="Can I connect more than one ChatSyncs account?">
    Yes — add it as a second connector with the other account's API key. Give them distinct
    names so you can tell them apart.
  </Accordion>

  <Accordion title="I have several WhatsApp numbers. Which one does it use?">
    If you have one number, it's used automatically. With several, the assistant lists them and
    asks which to use — so say which number you mean, e.g. *"send it from the support number"*.
  </Accordion>

  <Accordion title="How long does the connection last?">
    Until you revoke it. Claude refreshes its access quietly in the background; you won't be
    asked to paste your key again.
  </Accordion>
</AccordionGroup>