> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callivox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI connections (MCP) overview
> Connect an AI assistant to your Callivox workspace so it can read your conversations, agents, channels and billing — and manage agents for you.
Callivox can be connected to an AI assistant — the kind you run as a desktop or web AI client — so
you can ask it questions about your workspace in plain language and have it act on the answers. It
uses **MCP** (Model Context Protocol), the standard way AI clients connect to outside systems.
## What it is for
Once connected, your AI assistant can answer questions that would otherwise mean clicking through
several pages:
* *"How many conversations came in on WhatsApp this week?"*
* *"Which of my AI agents are turned off?"*
* *"What's my credit balance, and what did we spend it on?"*
* *"Summarise the last conversation with this customer."*
* *"Create a support agent for the web widget with these instructions."*
It reads live data from your own workspace only. It never sees another Callivox customer's data.
## Where to find it
Go to **Settings → AI Connections**. The page holds two cards:
Your workspace's address. Copy it and paste it into your AI client — the client then walks you
through sign-in and consent.
Every client that has been granted access, what it was allowed to do, when it connected and when
it was last used — with a **Revoke** button on each.
The page is **Admin only**, and it appears only on plans that include AI features. If you do not see
it, check your role and your plan.
## How access is controlled
Access is granted per client, and per **scope**. A scope is one category of access — reading
conversations, reading channels, managing agents, and so on. When a client connects, Callivox shows
you a consent screen listing exactly what it is asking for, and you approve or deny it.
Two rules matter:
* **Admins can grant every scope. Members can only grant "Read conversations."** Anything else a
client asks a Member for is shown locked, marked **admin only**, and is not granted.
* **A connection can be revoked at any time**, from the same page, and access stops immediately.
[Tools and scopes](/mcp/tools-and-scopes) lists each scope and everything it unlocks.
With the **Create & manage AI agents** scope granted, the assistant's changes are real and take
effect on your live configuration straight away — including deleting an agent. Grant that scope
only to a client you trust, and be specific about what you ask it to change.
## Next steps
The end-to-end setup, from copying the URL to approving the consent screen.
Every scope, who can grant it, and what the assistant can do with it.