---
title: "MCP setup: Claude Code, Codex, Cursor, VS Code"
summary: "Add https://mcp.beatra.ai/mcp to your MCP tool, sign in to Beatra in the browser, and generate video, images, music and voiceovers from chat. No API key."
url: "https://beatra.ai/en/mcp"
language: "en"
last_verified: "2026-11-16"
---

# Connect Beatra to your MCP tools

Add https://mcp.beatra.ai/mcp to any tool that supports MCP, sign in to Beatra in the browser, and click Allow. Then generate video, images, music and voiceovers right from the chat, with no API key.

Server address

```text
https://mcp.beatra.ai/mcp
```

[Can your agent install Skills? The Skill is easier](https://beatra.ai/en/install)

## Connect in three steps

1. **Add the address**: Paste the server address into your tool, or use its one-click button below.
2. **Sign in to Beatra**: Your tool opens the Beatra sign-in page in your browser.
3. **Check, then allow**: The page names the app that's connecting. If it's right, click Allow and go back to your tool.

## Steps for your tool

Pick your tool. Every tool with its own tab has been connected and tested.

### Claude Code

1. Run this in your terminal to add Beatra.

```sh
claude mcp add --transport http --scope user beatra https://mcp.beatra.ai/mcp
```

2. Open Claude Code, type `/mcp`, choose beatra and follow the sign-in prompt.

3. Sign in to Beatra in the browser. The app shows as Unnamed app. Check that authorization goes to an app on this computer, then click Allow.

**Over SSH, with no browser**

Instead of step 2, run this. Open the link it prints on any device, sign in and click Allow. Copy the address your browser ends up on, even if the page doesn't load, and paste it into the terminal.

```sh
claude mcp login beatra --no-browser
```

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

Tested 2026-11-16 · Claude Code 2.1.326

### Codex

1. Run this in your terminal. Codex adds Beatra and opens the browser to sign in.

```sh
codex mcp add beatra --url https://mcp.beatra.ai/mcp
```

2. If no browser opens, or to reconnect after you disconnect, run `codex mcp login beatra`.

3. Sign in to Beatra, check the app name and click Allow.

**Over SSH, with no browser**

Skip the steps above. Follow Servers without a browser and set `--host` to `codex`. The link it prints opens on any device.

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

Tested 2026-11-16 · Codex 0.166.0

### Cursor

1. Click Add to Cursor and confirm the install in Cursor.

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=beatra&config=eyJ1cmwiOiJodHRwczovL21jcC5iZWF0cmEuYWkvbWNwIn0=)

2. In Cursor's MCP settings, click the sign-in prompt next to beatra.

3. Sign in to Beatra, check the app name and click Allow.

**Or add it by hand**

Or add this to Cursor's MCP settings in `~/.cursor/mcp.json`.

```json
{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.ai/mcp"
    }
  }
}
```

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

### VS Code

1. Click Install in VS Code, then confirm the install in VS Code.

[Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22beatra%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.beatra.ai%2Fmcp%22%7D)

2. VS Code asks to sign in to Beatra and to open a web page. Agree to both. If it doesn't ask, sign in to Copilot and send a message in VS Code's chat.

3. Sign in to Beatra, check the app name and click Allow. Beatra is now available in VS Code's chat, which needs a Copilot sign-in.

**Or add it by hand**

Or run this in a terminal on macOS or Linux.

```sh
code --add-mcp '{"name":"beatra","type":"http","url":"https://mcp.beatra.ai/mcp"}'
```

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

### Claude

1. In Claude, open Customize → Connectors. Click Add, then Add custom connector.

2. Name it Beatra and paste the server address below. Then follow the prompts and click Add.

```text
https://mcp.beatra.ai/mcp
```

3. Click Connect, sign in to Beatra, check the app name and click Allow.

4. Which plans can add custom connectors is up to Claude.

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

Tested 2026-11-16 · Claude

### Other MCP tools

1. Add a remote MCP server in your tool and paste the server address. If it asks for a type, choose streamable HTTP.

```text
https://mcp.beatra.ai/mcp
```

2. When your tool opens the browser, sign in to Beatra and click Allow.

3. If your tool can't open a browser sign-in, follow the guide under Servers without a browser, or install the Skill.

**Or add it by hand**

Many tools use this config format.

```json
{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.ai/mcp"
    }
  }
}
```

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

### Servers without a browser

Send this to your agent

```text
Please follow https://docs.beatra.ai/en/docs/agent-connect to connect Beatra MCP to the agent tool on this machine. When it needs my approval, send me the link and the connection code.
```

1. Or run these yourself. On the last line, set `--host` to your tool: `claude-code`, `codex` or `cursor`.

```sh
mkdir -p ~/.beatra/connector
curl -fsSL https://api.beatra.ai/oauth/connector/connect.py -o ~/.beatra/connector/beatra_connect.py
python3 ~/.beatra/connector/beatra_connect.py --host claude-code
```

2. The first run prints a link and a connection code. Open the link on any phone or computer, sign in, check that the code matches and click Allow.

3. Run the same command again until it says the connection is ready, then reload your tool's MCP servers.

[Full instructions and other tools](https://docs.beatra.ai/en/docs/agent-connect)

To check the connection, ask your tool to list recent Beatra tasks. It lists only tasks made through this connection, so right after connecting the list is empty. This costs no credits.

## What you can do once connected

### Video

> “Make an 8-second vertical time-lapse of a beach sunset.”

### Images

> “Design a spring launch poster with room for the headline.”

### Music

> “Write a 30-second upbeat intro with no vocals.”

### Voiceovers

> “Read this script in a warm, calm voice.”

## MCP or the Skill?

Both use the same account, the same credits and the same creative tools.

### Skill

Beyond the tools, it tells your agent to confirm the price before spending credits, how to retry without being charged twice, and how to upload your local files. If your tool can install Skills, use the Skill.

[Install the Skill](https://beatra.ai/en/install)

### MCP

Connects the tools only, and your tool decides how to use them. Use MCP if your tool can only add an MCP address, or if you're building your own agent.

## Safe and in your control

### No API key

You sign in through your browser. There's no secret key to copy, and nothing to paste into the chat.

### See who's connecting

Before you click Allow, the page shows which app is asking and where the authorization goes.

### Disconnect any time

Every app you've allowed is listed in the console under [Devices → Connected apps](https://console.beatra.ai/apps). Disconnect one and its next call is refused.

## Questions

### Does it cost anything?

Connecting is free. Generating video, images, music and voiceovers uses credits, the same credits as the Skill. See [pricing](https://beatra.ai/en/pricing) for plans and how credits are counted.

### Do I need an API key?

No. Your tool opens Beatra in the browser, you sign in and click Allow. If your tool can't open a browser sign-in, see Servers without a browser.

### Which tools does it work with?

Every tool with its own tab on this page has been connected and tested. Other tools that support remote MCP servers and browser sign-in usually work too.

### Does Grok Build work?

Not yet. Grok Build currently rejects Beatra's tool names, so [install the Skill](https://beatra.ai/en/install) instead.

### My server has no browser. What now?

Use the commands under Servers without a browser. They print a link and a connection code. Open the link on any phone or computer, check the code and click Allow.

### How do I disconnect?

In the console, open [Devices → Connected apps](https://console.beatra.ai/apps) and click Disconnect. Your tool's next call is refused. To use it again, connect once more.

### How often do I sign in again?

You stay signed in. Your tool renews access in the background, and you only sign in again after about a year without use.
