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

# MCP troubleshooting

> Fixes for the common problems when connecting or using the ChatSyncs MCP server — connection failures, invalid API key errors, messages not delivering because of the 24-hour window, missing tools, the wrong WhatsApp number being used, and subscriber or credit limits. Use when a customer reports the MCP not connecting or an action failing.

## Connection problems

<AccordionGroup>
  <Accordion title="The connect page says ChatSyncs did not accept that key">
    The key was rejected by ChatSyncs itself, so it's wrong, expired, or regenerated since you
    copied it.

    Go to **Control Panel → Developer** in ChatSyncs and copy the key again. Take care not to
    include a trailing space — that's the most common cause. If you regenerated the key
    recently, any older connection stops working and needs reconnecting with the new one.
  </Accordion>

  <Accordion title="Claude says the connector failed to connect">
    Check the URL is exactly `https://mcp.chatsyncs.com` with no trailing slash and no typo.
    Then try removing the connector and adding it again — this restarts the process cleanly.
  </Accordion>

  <Accordion title="The connection worked but there are no tools">
    Restart your AI assistant. Claude Desktop in particular only picks up a new connector's
    tools after a restart.
  </Accordion>

  <Accordion title="I was asked for my key again">
    That happens if the connection was revoked — usually because the API key was regenerated in
    ChatSyncs. Paste the current key and it will reconnect.
  </Accordion>
</AccordionGroup>

## Messages not sending

<AccordionGroup>
  <Accordion title="The message was rejected and mentions a 24-hour window">
    WhatsApp only allows free-form messages within **24 hours** of the customer last messaging
    you. After that, only an approved template is delivered.

    Ask the assistant to send a template instead: *"Send them the re-engagement template."* If
    you don't have one, create it in ChatSyncs — see
    [Creating a WhatsApp message template](/learn/chatsyncs-message-templates/creating-a-whatsapp-message-template-in-chatsyncs).
  </Accordion>

  <Accordion title="Subscriber limit has been exceeded">
    Your plan's contact limit is full, and messaging a new number would create a new contact.
    Remove contacts you no longer need, or upgrade your plan.
  </Accordion>

  <Accordion title="The template was rejected with a format mismatch">
    The template expects a header — an image, video or document — that wasn't supplied. Templates
    with variables or media headers often need fields this assistant can't fill in yet. Send it
    from ChatSyncs, or use the API Developer Console to build the exact request.
  </Accordion>

  <Accordion title="It says the message sent, but nothing arrived">
    Ask *"check the delivery status of that message."* A message can be accepted by WhatsApp and
    still fail to deliver — a blocked number, an invalid number, or a phone that's been offline.
    Also confirm the number included the country code and no `+`.
  </Accordion>
</AccordionGroup>

## Wrong number or wrong account

<AccordionGroup>
  <Accordion title="It sent from the wrong WhatsApp number">
    With several connected numbers, say which you mean: *"send it from the support number."* To
    see them all, ask *"show me my account."*
  </Accordion>

  <Accordion title="It says this account has no connected WhatsApp number">
    The API key is valid but no number is connected to that ChatSyncs account. Follow
    [Connect your number to ChatSyncs](/learn/chatsyncs-setup-and-configuration/connect-your-number-to-chatsyncs).
  </Accordion>

  <Accordion title="It keeps asking which number to use">
    Your account has several and the assistant won't guess. Name the number once and it will use
    it for the rest of the conversation.
  </Accordion>
</AccordionGroup>

## Things it won't do

<AccordionGroup>
  <Accordion title="It refuses to message my whole contact list">
    There's no bulk-send ability, on purpose — see
    [the tool reference](/mcp/tools#frequently-asked). Use
    [Broadcasting](/learn/chatsyncs-broadcasting/send-a-broadcast-message-in-chatsyncs).
  </Accordion>

  <Accordion title="It can't find the agency tools">
    `connect_whatsapp_account`, `get_direct_login_url` and `create_user_login_url` are disabled
    by default. Contact ChatSyncs support if you resell ChatSyncs and need them.
  </Accordion>

  <Accordion title="It asks me to confirm every single action">
    That's your assistant's own safety behaviour, not ChatSyncs'. Most clients let you approve a
    tool for the rest of a session — check your assistant's permission settings.
  </Accordion>
</AccordionGroup>

## Still stuck

Tell support:

1. What you asked the assistant to do
2. The **exact** error text it showed you
3. Which app you're using (Claude Desktop, claude.ai, Claude Code)

<Warning>
  **Never include your API key** in a support message, a screenshot or a bug report. If you think
  it's been exposed, regenerate it immediately under **Control Panel → Developer**.
</Warning>