> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Connections
> Connect Slack, Linear, and Airtable so they can start agent sessions, and add MCP servers that give Conversion AI chats and agents external tools.
The **Connections** tab of the [AI](/product-docs/workspace-settings/ai/overview) settings page has two sections: **Integrations**, which are services that can start sessions with your agents, and **MCP servers**, which extend AI chats and agents with external tools.
## Integrations
Connect services that can start sessions with your [agents](/product-docs/conversion-ai/agents/overview). Only administrators can connect, reconnect, or disconnect them; other members see the connection status.
| Integration | What it enables | Setup guide |
| ------------ | ------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| **Slack** | Agents respond to mentions, messages, and reactions. | [Slack triggers](/product-docs/conversion-ai/agents/slack) |
| **Linear** | Agents respond to issues and comments. | [Linear triggers](/product-docs/conversion-ai/agents/linear) |
| **Airtable** | Agents respond to records and comments. Not enabled for every workspace. | [Airtable triggers](/product-docs/conversion-ai/agents/airtable) |
Click **Connect** next to a service and complete its authorization flow. Once connected, the row shows a green **Connected** badge along with the connected Slack workspace, Linear organization, or Airtable bases, and the options menu offers **Reconnect**.
The Slack connection here is separate from the Slack integration under [Integrations](/product-docs/workspace-settings/integrations/slack), which workflows use to post messages. If Slack was connected before agents were available, the row shows *Reconnect Slack to allow agents to respond to messages and reactions*. Click **Reconnect** to grant the additional permissions.
For Airtable, the options menu also offers **Connection details**, which shows the status of each base subscription and any events waiting to be retried, and **Disconnect**. A yellow **Needs attention** badge means a subscription needs to be restarted or the account reconnected.
## MCP servers
Connect [MCP](https://modelcontextprotocol.io) servers to expose tools from third-party platforms in AI chats and agents. Administrators add and manage servers; every member can then use them, connecting their own account first when the server uses OAuth.
This section is about adding *other* MCP servers to Conversion. To connect an external AI client to Conversion's own MCP server, see [Connecting to the MCP server](/product-docs/mcp/connecting).
### Adding a server
Click **Add MCP server** (or **Add server** below an existing list) and fill in:
| Field | Description |
| ------------------ | ------------------------------------------------------------------ |
| **Name** | How the server appears to members. |
| **Server URL** | The server's endpoint, such as `https://mcp.example.com/mcp`. |
| **Transport** | **Streamable HTTP** or **SSE**, matching what the server supports. |
| **Authentication** | **None**, **API key / header (shared)**, or **OAuth (per user)**. |
The authentication method decides what else you enter:
* **API key / header (shared)**: a **Header name** (for example `Authorization`) and a **Header value** (for example `Bearer sk-...`). The value is stored once and shared by everyone in the workspace. When editing, leave the value blank to keep the current key, or tick **Remove current API key** to clear it.
* **OAuth (per user)**: an optional **OAuth client ID** and **OAuth client secret**. Leave the client ID blank to let Conversion register itself with the server automatically (Dynamic Client Registration); supply a secret only when the server requires one. Users authorize this server individually.
Click **Add server**. Conversion then inspects the server to discover its tools.
### Server list
Each server in the list shows its name and URL, plus:
| Badge or button | Meaning |
| --------------- | ----------------------------------------------------------------- |
| **Disabled** | An administrator has turned the server off for everyone. |
| **Unreachable** | Conversion could not reach the server during its last inspection. |
| **Authorized** | You have connected your account to this OAuth server. |
| **Connect** | This OAuth server needs your authorization before you can use it. |
| **View** | Opens the server's page. |
For OAuth servers you've authorized, the options menu offers **Disconnect**, which removes your own authorization. You can connect again at any time.
### Server page and tools
The server page shows the server's status badges and a **Tools** tab listing every tool the server exposes, with its description. For each tool, choose how it may be used:
| Mode | Behavior |
| -------------------- | ------------------------------------------- |
| **Auto-approve** | The tool runs without asking. |
| **Require approval** | Conversion AI asks before running the tool. |
| **Disabled** | The tool is never offered. |
Click **Refresh tools** to inspect the server again after it adds or changes tools. Inspection time varies between servers.
If the tools list is empty, the page tells you why: the server is disabled (*An administrator must enable this server before it can be connected or refreshed*), you haven't connected your account yet (*Connect to view tools*), Conversion could not connect (*Unable to connect*, with a **Try again** button), or the server exposes no tools.
The options menu on the server page offers administrators **Disable** or **Enable**, **Edit** (the connection settings above), **Rename**, and **Delete**.
Deleting a server makes it immediately unavailable for all members. If it's added again, members will have to reconnect and reconfigure tools. Use **Disable** to turn a server off temporarily instead.