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

# Connect the MCP Server

> Add the hosted VideoDB MCP Server to Claude, Claude Code, Cursor, or MCP Inspector

Add this URL to your client:

```text theme={null}
https://mcp.videodb.io/mcp
```

You need a VideoDB account. Sign up free at [console.videodb.io](https://console.videodb.io/auth?utm_source=docs_videodb_io\&utm_medium=docs_link\&utm_campaign=console_auth\&utm_content=docs_link\&id=docs) - no credit card.

***

## Claude

Works on web, desktop and mobile.

<Steps>
  <Step title="Open connector settings">
    **Settings → Connectors → Add custom connector**.

    On Team and Enterprise plans, an admin adds it under **Organization settings → Connectors**.
  </Step>

  <Step title="Paste the server URL">
    ```text theme={null}
    https://mcp.videodb.io/mcp
    ```
  </Step>

  <Step title="Click Connect">
    A VideoDB page opens in your browser.
  </Step>

  <Step title="Log in and authorize">
    If you're not already signed in, it takes you to log in (or sign up) at [console.videodb.io](https://console.videodb.io) first. Click **Authorize**. The browser hands you back to Claude with the connector enabled.
  </Step>
</Steps>

***

## Claude Code

```bash theme={null}
claude mcp add --transport http videodb https://mcp.videodb.io/mcp
```

Run `/mcp` inside Claude Code to authorize, then confirm it registered:

```bash theme={null}
claude mcp list
```

***

## Cursor

Open **Settings → Cursor Settings → MCP → Add new global MCP server** and add:

```json theme={null}
{
  "mcpServers": {
    "videodb": {
      "url": "https://mcp.videodb.io/mcp"
    }
  }
}
```

Cursor opens console.videodb.io on first use. Log in and click Authorize there.

***

## MCP Inspector

```bash theme={null}
npx @modelcontextprotocol/inspector
```

Set the transport to **Streamable HTTP**, enter `https://mcp.videodb.io/mcp`, and connect.

***

## Any other client

Add it as a remote server over Streamable HTTP with the same URL. There is nothing else to configure.

***

## Verify It Works

Ask your client:

```text theme={null}
list my videodb collections
```

You get back your collections with their IDs and names.

***

## Troubleshooting

| Symptom                                                    | Fix                                                                                                  |
| :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |
| The VideoDB page never opens                               | Allow popups for the client, and check whether a corporate proxy blocks `mcp.videodb.io`.            |
| Authorization fails after you log in                       | Sign out and back in at [console.videodb.io](https://console.videodb.io), then reconnect.            |
| Tools are missing after connecting                         | Disconnect and reconnect so the client re-lists the tools.                                           |
| A long upload or index call returns `status: "processing"` | The job is still running. Re-check it with the read tool named in the response's `retry_with` field. |
| The connection stopped working                             | Disconnect the connector and connect again.                                                          |

***

## Local Server

An older package, `videodb-director-mcp`, runs a local MCP server over stdio. Use it if your client only supports stdio. See [Local MCP Server](/pages/mcp/local-server).