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

# AI Assistants (MCP)

> Connect Claude, ChatGPT or any MCP client to your FlowIQ account and work with your WhatsApp business by asking.

FlowIQ runs a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server, so an AI assistant can work with your FlowIQ account directly. Ask about your chats, broadcast results, orders or abandoned carts, and, if you allow it, have the assistant prepare broadcasts, tag contacts or update your AI agent's replies.

```
https://mcp.flowiq.live/mcp
```

***

## Connect Claude or ChatGPT

<Steps>
  <Step title="Add a custom connector">
    In Claude or ChatGPT, open the connector settings and add a custom connector.
  </Step>

  <Step title="Paste the address">
    Use `https://mcp.flowiq.live/mcp`.
  </Step>

  <Step title="Sign in with FlowIQ">
    Sign in with your FlowIQ login, choose the account to connect, and choose what the assistant may do (see [Permissions](#permissions)).
  </Step>
</Steps>

## Connect with an API key

MCP clients that support custom headers, such as Claude Code or Cursor, can connect with an API key instead of signing in:

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http flowiq https://mcp.flowiq.live/mcp \
    --header "Authorization: Bearer fiq_YOUR_API_KEY"
  ```

  ```json MCP config (JSON) theme={null}
  {
    "mcpServers": {
      "flowiq": {
        "url": "https://mcp.flowiq.live/mcp",
        "headers": { "Authorization": "Bearer fiq_YOUR_API_KEY" }
      }
    }
  }
  ```
</CodeGroup>

The key selects the organization, exactly as it does for the REST API.

***

## Permissions

Every connection has one or more of three permissions:

| Permission | Lets the assistant |
| - | - |
| `read` | Look up conversations, contacts, orders, subscriptions, broadcasts and reports |
| `send` | Send WhatsApp messages and broadcasts, to one contact or everyone with a tag |
| `write` | Change things in your account: contact tags and details, keyword replies, your AI agent's prompt, turning the AI on or off for a contact, and uploading files |

Automations (flows) send messages on their own, so creating or changing one needs both `send` and `write`.

* **Signing in** connects with `read` only, unless you tick more on the consent screen. Organization members can grant `read` only; admins can grant all three.
* **API keys** have all three permissions by default.

<Warning>
  Sends, broadcasts and changes to your AI agent's replies happen in two steps: the assistant first shows you a preview (for a broadcast, including how many people it will reach) and only acts after you confirm. A sent WhatsApp message can't be recalled, so read the preview.
</Warning>

***

## What you can ask

* "How many new contacts did we get this week, and how many orders came from WhatsApp?"
* "How did Tuesday's broadcast do? Who didn't receive it and why?"
* "Show me today's escalated conversations."
* "Which products are customers asking about most this month?"
* "Draft a broadcast to everyone tagged `vip` announcing the winter sale."

The read-only questions use the same data as the [Reporting API](/flowiq-api-reference/reporting-api), so the numbers match your dashboard and your scheduled reports.


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