> ## 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.

# Delphina MCP Server (Beta)

> Call Delphina from Claude Code, Claude Desktop/Cowork, Codex, Cursor, and custom MCP clients

<Note>
  This feature is in beta. Please contact your administrator for access. GA is coming soon.
</Note>

The Delphina MCP server lets you call Delphina's analytics agent from MCP-compatible clients. Ask data questions directly from your development environment, or integrate Delphina into automated workflows.

## How it works

Delphina exposes an MCP server using the Streamable HTTP transport. MCP clients connect to it and gain access to tools for starting chats, sending messages, and retrieving results — the same capabilities available through the web app and Slack.

Delphina uses OAuth for MCP authorization when your client supports it. OAuth is preferred because it is usually simpler to set up and more secure: supported clients can handle the browser-based sign-in flow for you, and you do not need to copy or store a long-lived API key in client configuration. If your MCP client does not support OAuth, use API key authorization instead.

## Configure Delphina MCP

In Delphina, go to **Settings > Connect to Delphina MCP**. The page includes setup tabs for **General**, **Claude Code**, **Claude Desktop/Cowork**, **Codex**, and **Cursor**.

### General

Use this MCP server URL for any MCP-compatible client:

```txt theme={null}
https://app.delphina.ai/api/mcp
```

### Claude Code

Choose an installation scope in Delphina:

* **User** (`--scope user`) — available in all projects for the current user.
* **Local** (`--scope local`) — available only in the current project directory.

Then run the copied command in your terminal:

```bash theme={null}
claude mcp add --scope user --transport http delphina https://app.delphina.ai/api/mcp
```

Use `--scope local` instead if you selected **Local**.

### Claude Desktop/Cowork

In Claude Desktop/Cowork, go to **Customize > Connectors > Add custom Connector**, then paste the Delphina MCP server URL:

```txt theme={null}
https://app.delphina.ai/api/mcp
```

### Codex

Add the Delphina MCP server:

```bash theme={null}
codex mcp add delphina --url https://app.delphina.ai/api/mcp
```

Then authenticate Codex with Delphina OAuth:

```bash theme={null}
codex mcp login delphina
```

### Cursor

In Delphina, use the **Cursor** tab to open the Cursor install link.

If the link does not open Cursor, create or edit `~/.cursor/mcp.json` for global setup or `.cursor/mcp.json` for project setup, then paste this JSON:

```json theme={null}
{
  "mcpServers": {
    "Delphina": {
      "url": "https://app.delphina.ai/api/mcp",
      "headers": {}
    }
  }
}
```

## API key authorization

OAuth is preferred because it is usually simpler to set up and more secure than copying a long-lived API key into client configuration. If your MCP client does not support OAuth, go to **Settings > Connect to Delphina MCP > General**, expand **API Key Authorization**, and copy the **Authorization Header** value.

Use that value as the `Authorization` header in your MCP client configuration:

```txt theme={null}
Authorization: Bearer YOUR_API_KEY
```

For JSON-based MCP configs, include the header like this:

```json theme={null}
{
  "mcpServers": {
    "delphina": {
      "url": "https://app.delphina.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

You can also find your API key in **Settings > API Key** if that tab is enabled for your account. Keep your API key secure — do not commit it to source control.