# Connect with MCP

> Add Frames to Claude, ChatGPT, Cursor, Claude Code, Codex and other AI apps.

MCP (Model Context Protocol) is an open standard that lets AI apps use outside tools. Frames runs an MCP server, so any app that supports MCP can use it. Add Frames once, sign in with your Frames account, and your AI can use it whenever it needs data.

This is the server address you'll paste into your app:

```text title="Server address"
https://api.frames.ag/mcp
```

## How signing in works

- **Most apps:** after you add Frames, the app opens a Frames sign-in page. Sign in and click **Approve**; there's no key to copy. The connection uses your account's plan and credits, and a plan upgrade applies on the next request without reconnecting.
- **Scripts and agents without a browser:** send your Frames API key as a header instead, `Authorization: Bearer <your key>`, read from an environment variable.
- **Apps that only run local MCP servers:** bridge with `npx mcp-remote https://api.frames.ag/mcp`.

## Set up your app

Pick your app below. Each setup was checked against the app's own docs on the date shown. Apps move their menus now and then, so if a step doesn't match what you see, the app's help pages have the current path.

### Claude

_Web, desktop and mobile. Last checked 2026-09-17._

1. Go to **Customize → Connectors**, or open Frames' [pre-filled add link](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Frames&connectorUrl=https%3A%2F%2Fapi.frames.ag%2Fmcp).
2. Click **+ → Add custom connector**, name it **Frames**, paste the server address and click **Add**.
3. Click **Connect** and sign in. In a chat, turn Frames on under **+ → Connectors**.

Free plans allow one custom connector. On Team and Enterprise, an owner adds it first under **Organization settings → Connectors**. Once added, it also works in the desktop and mobile apps.

### ChatGPT

_Last checked 2026-09-17._

1. At [chatgpt.com](https://chatgpt.com), switch on **Developer mode** in **Settings → Security and login**.
2. At [chatgpt.com/plugins](https://chatgpt.com/plugins), click **+**, name it **Frames**, choose **OAuth** and paste the server address.
3. Click **Create** and sign in, then type **@Frames** in a chat.

Web only, on paid plans. Menu names vary by account.

### Grok Bot

_xAI's always-on agents. Last checked 2026-09-18._

1. In a chat with your Bot, ask it to add a **custom MCP server** named **Frames** at the server address.
2. When the Bot asks, sign in with your Frames account and allow access. Frames is then on for every Bot on your account.
3. Type **@** and pick **Frames** to attach it to a task, then ask for live data.

xAI's docs don't describe adding a server by URL yet, so these steps follow published setup guides. If a step doesn't match, ask your Bot how to add a custom MCP server.

### Cursor

_Last checked 2026-09-17._

1. Open the [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=frames&config=eyJ1cmwiOiJodHRwczovL2FwaS5mcmFtZXMuYWcvbWNwIn0=) link and confirm. Or add Frames by hand:

   ```json title="~/.cursor/mcp.json"
   {
     "mcpServers": {
       "frames": { "url": "https://api.frames.ag/mcp" }
     }
   }
   ```
2. Sign in when Cursor asks.
3. Ask the agent for live data.

Install links need Cursor 3.15.12 or later.

### Claude Code

_Last checked 2026-09-17._

1. In your terminal, run:

   ```bash
   claude mcp add --transport http --scope user frames https://api.frames.ag/mcp
   ```
2. Start Claude Code, type `/mcp`, pick **frames** and sign in.
3. Ask for data. Frames works in all your projects.

Without a browser, add `--header "Authorization: Bearer $FRAMES_API_KEY"` after the URL. If you signed in to Claude Code with a claude.ai account, connectors added on claude.ai show up automatically.

### Codex

_Last checked 2026-09-17._

1. In your terminal, run:

   ```bash
   codex mcp add frames --url https://api.frames.ag/mcp
   ```
2. Sign in when your browser opens, or run `codex mcp login frames`.
3. Type `/mcp` in Codex to check the connection.

The same setup covers the Codex IDE extension. Without a browser, add `--bearer-token-env-var FRAMES_API_KEY`.

### VS Code

_With GitHub Copilot. Last checked 2026-09-17._

1. Open the Command Palette and run **MCP: Add Server**. Choose **HTTP** and paste the server address.
2. Trust the server and sign in when asked.
3. Use Frames from Chat in **Agent** mode.

Copilot Business and Enterprise need the organization's MCP policy switched on. VS Code also has a one-click install: [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22frames%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.frames.ag%2Fmcp%22%7D).

### OpenCode

_Last checked 2026-09-17._

1. Add Frames to your OpenCode config:

   ```json title="~/.config/opencode/opencode.json"
   {
     "mcp": {
       "frames": {
         "type": "remote",
         "url": "https://api.frames.ag/mcp",
         "enabled": true
       }
     }
   }
   ```
2. Run `opencode mcp auth frames` and sign in.
3. Start OpenCode and ask for data.

### OpenClaw

_Last checked 2026-09-17._

1. In your terminal, run:

   ```bash
   openclaw mcp add frames --url https://api.frames.ag/mcp --transport streamable-http --auth oauth
   ```
2. Run `openclaw mcp login frames` and follow the link.
3. Check it with `openclaw mcp doctor frames --probe`.

### Hermes

_Nous Research's agent. Last checked 2026-09-19._

1. In your terminal, run:

   ```bash
   hermes mcp add frames --url https://api.frames.ag/mcp --auth oauth
   ```
2. Run `hermes mcp test frames` and sign in with your Frames account in the browser.
3. In a running session, type `/reload-mcp`, then ask Hermes for live data.

### Other apps

Add a remote MCP server that uses Streamable HTTP, with the server address `https://api.frames.ag/mcp`. If the app supports sign-in (OAuth), it opens the Frames sign-in page. If not, use the API key header from [How signing in works](#how-signing-in-works).