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

# MCP Connections

> Extend the agent with tools from external services

MCP connections extend the analytics agent with tools from external services. Add a connection, and the agent can use those tools during new chats — for example, searching GitHub issues, reading Notion docs, or looking up Slack conversations.

## Adding a connection

1. Go to **Org Admin > MCP Connections**.
2. Click **Add Connection**.
3. Choose a workspace and usage, then fill in **Name**, **Description**, **URL**, **Auth Type**, and any auth details.
4. Click **Create**.

For OAuth connections, **Token Binding** controls whose authorization is used. Choose **Per-user** when each Delphina user should authorize with their own account, or **Shared by workspace** when one admin-owned OAuth grant should be used for everyone. If **Per-user** is selected, users will see a **Connect** banner before they can use that connection.

## Common connections

| Service                                                                 | URL                                  | Auth Type    | Notes                                                                       |
| ----------------------------------------------------------------------- | ------------------------------------ | ------------ | --------------------------------------------------------------------------- |
| [Attio](https://docs.attio.com/mcp/overview)                            | `https://mcp.attio.com/mcp`          | OAuth        |                                                                             |
| [GitHub](https://github.com/settings/personal-access-tokens)            | `https://api.githubcopilot.com/mcp/` | Bearer Token | Use a fine-grained PAT scoped to the repos and permissions the agent needs. |
| Google Workspace                                                        | `mcp://internal/google-workspace`    | None         | Authorization will be configured automatically.                             |
| [Linear](https://linear.app/docs/mcp)                                   | `https://mcp.linear.app/mcp`         | OAuth        |                                                                             |
| [Notion](https://developers.notion.com/guides/mcp/get-started-with-mcp) | `https://mcp.notion.com/mcp`         | OAuth        |                                                                             |
| Slack                                                                   | `mcp://internal/slack`               | None         | Authorization will be configured automatically.                             |

### Attio

Add a connection with URL `https://mcp.attio.com/mcp`, Auth Type **OAuth**, your preferred Token Binding, and blank **Advanced** fields unless you need a pre-registered OAuth client.

The agent can search and manage CRM records, notes, tasks, comments, meetings, emails, and reports according to the connected Attio user's permissions.

### GitHub

1. Create a [fine-grained PAT](https://github.com/settings/personal-access-tokens) with read access to Contents, Issues, Pull requests, and Metadata.
2. Add a connection with URL `https://api.githubcopilot.com/mcp/` and the PAT as the bearer token.

The agent can then search code, read files, list issues/PRs, and get commit history from your repos. Start read-only; add write permissions only if you want the agent to create or update GitHub resources.

### Google Workspace

Add a connection with URL `mcp://internal/google-workspace`, Auth Type **None**, and no token. Delphina recognizes this internal URL and configures Google OAuth automatically.

After users connect OAuth, the agent can use Google Workspace tools for Calendar, Docs, Drive, Gmail, Slides, Sheets, and Tasks. Default scopes are `calendar`, `documents`, `drive`, `gmail.modify`, `presentations`, `spreadsheets`, and `tasks`.

### Linear

Add a connection with URL `https://mcp.linear.app/mcp`, Auth Type **OAuth**, your preferred Token Binding, and blank **Advanced** fields unless you need a pre-registered OAuth client.

The agent can find, create, and update Linear issues, projects, and comments according to the connected Linear user's permissions.

### Notion

Add a connection with URL `https://mcp.notion.com/mcp`, Auth Type **OAuth**, your preferred Token Binding, and blank **Advanced** fields unless you need a pre-registered OAuth client.

The agent can read and write Notion workspace content according to the connected Notion user's access.

### Slack

Add a connection with URL `mcp://internal/slack`, Auth Type **None**, and no token. Delphina recognizes this internal URL and configures Slack OAuth automatically.

After users connect OAuth, the agent can list readable channels, read channels and threads, and search messages. Slack enforces membership, so users can only read channels, DMs, and group DMs their Slack account can access.

## Managing connections

* **Edit** — click the pencil icon to update name, URL, usage, or auth details.
* **Delete** — click the trash icon.

## Troubleshooting

| Problem                    | Fix                                                                                                                                                 |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Can't access private repos | Edit the PAT on GitHub to include those repos.                                                                                                      |
| "Unauthorized" errors      | Token expired or grant revoked — reconnect OAuth or update the bearer token.                                                                        |
| OAuth discovery fails      | Verify the URL is the Streamable HTTP MCP endpoint. For Google Workspace and Slack, use Auth Type **None** with the exact `mcp://internal/...` URL. |
| Tools not appearing        | Start a new chat after creating the connection and verify the URL matches the MCP server endpoint exactly.                                          |
| User sees a Connect banner | Per-user OAuth is expected; that user must click **Connect** once before using the tools.                                                           |