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

# Connectors

> Connect external tools to Primo AI by registering Model Context Protocol (MCP) servers.

Connectors give [Primo AI](/ai/primo-ai) access to tools outside the platform. A connector is a Model Context Protocol (MCP) server that you register by URL. Once connected, the assistant can call that server's tools during a conversation — for example, to look up a page in Notion or act in another system.

## When to use a connector

Add a connector when you want the assistant to reach beyond Primo's own data:

* **Query another system** — pull information from a tool your team already uses.
* **Act in another system** — let the assistant perform tasks in a connected service.
* **Extend the assistant** — bring in any tool that speaks the Model Context Protocol.

If you only need the assistant to work with Primo data or your company's own instructions, you don't need a connector — use [knowledge base items](/ai/knowledge-base-items) instead.

## Prerequisites

* The **AI agent write** permission to add, re-authenticate, or delete connectors.
* The URL of an MCP server that supports OAuth authentication.

## Add a connector

<Steps>
  <Step title="Go to Settings > AI > Connectors">
    Open **Settings**, select the **AI** section, then the **Connectors** tab.
  </Step>

  <Step title="Click 'Add connector'">
    The connector dialog opens.
  </Step>

  <Step title="Enter the connector details">
    * **Name** — a label for the connector, for example `Notion`.
    * **Server URL** — the MCP endpoint, for example `https://example.com/mcp`.
  </Step>

  <Step title="Add advanced settings if needed">
    Expand **Advanced settings** only if your MCP server does not support Dynamic Client Registration. Register Primo in the provider's OAuth console, then enter the **Client ID** and **Client secret**. Leave the secret empty for public clients that use PKCE.
  </Step>

  <Step title="Click 'Connect'">
    Primo redirects you to authenticate with the MCP server. After you authorize access, the connector returns to Primo and its status becomes **Connected**.
  </Step>
</Steps>

## Connector statuses

| Status                     | Meaning                                          |
| -------------------------- | ------------------------------------------------ |
| **Pending authentication** | Created, but authentication is not yet complete. |
| **Connected**              | Authenticated and available to the assistant.    |
| **Error**                  | The connection failed. Re-authenticate to retry. |

## Manage connectors

From the Connectors tab you can:

* **Re-authenticate** — refresh access when a connector expires or errors.
* **Delete** — remove a connector and its stored credentials.

## How Primo AI uses connectors

When a conversation needs an external tool, the assistant selects the relevant one from your connected connectors and asks you to approve the action before it runs. Open Primo AI and use the **Connectors** control in the message box to choose which connectors are active for a conversation. See [Primo AI](/ai/primo-ai).