---
title: "Claude Code・Codex・Cursor・VS Code に Beatra MCP を接続"
summary: "MCP ツールに https://mcp.beatra.ai/mcp を追加し、ブラウザで Beatra にサインインすると、チャットから動画・画像・音楽・ナレーションを生成できます。API キーは不要です。"
url: "https://beatra.ai/ja/mcp"
language: "ja"
last_verified: "2026-11-16"
---

# Beatra を MCP ツールに接続

MCP に対応したツールに https://mcp.beatra.ai/mcp を追加し、ブラウザで Beatra にサインインして「許可する」を押すだけです。接続すると、チャットから動画・画像・音楽・ナレーションを直接生成できます。API キーは要りません。

サーバーアドレス

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

[Agent が Skill に対応しているなら、Skill のほうが手軽です](https://beatra.ai/ja/install)

## 3 ステップで接続

1. **アドレスを追加**: ツールにサーバーアドレスを貼り付けるか、下のワンクリックボタンを使います。
2. **ブラウザでサインイン**: ツールがブラウザで Beatra のサインインページを開きます。
3. **確認して「許可する」**: 接続するアプリの名前がページに表示されます。合っていれば「許可する」を押し、ツールに戻ります。

## ツール別の手順

お使いのツールを選びます。個別のタブがあるツールは、どれも実際に接続して確認しています。

### Claude Code

1. ターミナルで次のコマンドを実行し、Beatra を追加します。

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

2. Claude Code を開いて `/mcp` と入力し、beatra を選んで案内に沿ってサインインします。

3. ブラウザで Beatra にサインインします。アプリ名は「名前のないアプリ」と表示されます。認可の送信先が「このコンピューター上のアプリ」であることを確かめて、「許可する」を押します。

**SSH 接続先（ブラウザなし）**

手順 2 の代わりに次のコマンドを実行します。表示されたリンクを任意の端末で開き、サインインして「許可する」を押します。ページが開けなくても、ブラウザのアドレス欄に表示されたアドレスをコピーして、ターミナルに貼り付けます。

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

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

2026-11-16 確認 · Claude Code 2.1.326

### Codex

1. ターミナルで次のコマンドを実行します。Codex が Beatra を追加し、サインイン用にブラウザを開きます。

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

2. ブラウザが開かないときや、接続を解除したあとで再接続するときは `codex mcp login beatra` を実行します。

3. Beatra にサインインし、アプリ名を確認して「許可する」を押します。

**SSH 接続先（ブラウザなし）**

上の手順は使わず、「ブラウザのないサーバー」の手順に沿って、`--host` に `codex` を指定します。表示されたリンクは任意の端末で開けます。

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

2026-11-16 確認 · Codex 0.166.0

### Cursor

1. 「Cursor に追加」を押し、Cursor でインストールを確定します。

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

2. Cursor の MCP 設定で、beatra の横にあるサインインの案内を押します。

3. Beatra にサインインし、アプリ名を確認して「許可する」を押します。

**手動で追加する場合**

または、次の設定を Cursor の MCP 設定（`~/.cursor/mcp.json`）に追加します。

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

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

### VS Code

1. 「VS Code にインストール」を押し、VS Code でインストールを確定します。

[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 が、Beatra へのサインインと Web ページを開いてよいかを尋ねます。どちらも同意します。尋ねられない場合は、Copilot にサインインしてから、VS Code のチャットでメッセージを 1 件送ります。

3. Beatra にサインインし、アプリ名を確認して「許可する」を押します。以降は VS Code のチャットで Beatra を使えます。チャットには Copilot へのサインインが必要です。

**手動で追加する場合**

または、macOS か Linux のターミナルで次のコマンドを実行します。

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

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

### Claude

1. Claude で「カスタマイズ → コネクタ」を開きます。「追加」を押し、「カスタムコネクタを追加」を選びます。

2. 名前に Beatra と入力し、下のサーバーアドレスを貼り付けます。案内に沿って「追加」を押します。

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

3. 「接続」を押して Beatra にサインインし、アプリ名を確認して「許可する」を押します。

4. カスタムコネクタを追加できるプランは、Claude の案内に従います。

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

2026-11-16 確認 · Claude

### その他の MCP ツール

1. ツールでリモート MCP サーバーを追加し、サーバーアドレスを貼り付けます。種類を選ぶ場合は streamable HTTP を選びます。

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

2. ツールがブラウザを開いたら、Beatra にサインインして「許可する」を押します。

3. ブラウザでサインインできないツールでは、「ブラウザのないサーバー」のガイドに沿って接続するか、Skill をインストールします。

**手動で追加する場合**

多くのツールはこの設定形式を使います。

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

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

### ブラウザのないサーバー

Agent に送るメッセージ

```text
https://docs.beatra.ai/ja/docs/agent-connect の手順で、このマシンの Agent ツールへの Beatra MCP の接続をお願いします。承認が必要なときは、リンクと接続コードを送ってもらえますか。
```

1. 自分で実行することもできます。最後の行の `--host` を、お使いのツール（`claude-code`・`codex`・`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. 初回の実行でリンクと接続コードが表示されます。任意のスマートフォンやパソコンでリンクを開いてサインインし、接続コードが一致していれば「許可する」を押します。

3. 接続完了と表示されるまで同じコマンドを実行し、ツールの MCP サーバーを再読み込みします。

[詳しい手順とほかのツール](https://docs.beatra.ai/ja/docs/agent-connect)

接続できたか確かめるには、最近の Beatra タスクを一覧表示するよう頼みます。この接続で作ったタスクだけが表示されるので、接続した直後は空の一覧です。クレジットは消費しません。

## 接続するとできること

### 動画

> 「海辺の夕日を 8 秒の縦型タイムラプスにして」

### 画像

> 「見出しの余白を残して、春の新商品ポスターを作って」

### 音楽

> 「ボーカルなしの明るいオープニング曲を 30 秒で」

### ナレーション

> 「この原稿を、落ち着いた温かい声で読み上げて」

## MCP か Skill か

どちらも同じアカウント・同じクレジット・同じ機能を使います。

### Skill

Skill はツールに加えて、使い方の手順も Agent に伝えます。たとえば、クレジットを使う前の価格確認、二重課金しない再試行、ローカルファイルのアップロードです。Skill をインストールできるツールなら、Skill がおすすめです。

[Skill をインストール](https://beatra.ai/ja/install)

### MCP

ツールだけを接続し、使い方はツールに任せます。MCP アドレスしか追加できないツールや、自作の Agent には MCP を使います。

## 安全とコントロール

### API キー不要

ブラウザでサインインするだけです。コピーする秘密鍵も、チャットに貼るものもありません。

### 許可の前に接続先を確認

「許可する」を押す前に、どのアプリが接続を求めていて、認可がどこに送られるかがページに表示されます。

### いつでも接続を解除

許可したアプリはすべて、コンソールの[「デバイス → 接続済みのアプリ」](https://console.beatra.ai/apps)に表示されます。接続を解除すると、次の呼び出しから拒否されます。

## よくある質問

### 料金はかかりますか？

接続は無料です。動画・画像・音楽・ナレーションの生成にはクレジットを使い、Skill と共通です。プランとクレジットの計算方法は[料金ページ](https://beatra.ai/ja/pricing)で確認できます。

### API キーは必要ですか？

必要ありません。ツールがブラウザで Beatra を開くので、サインインして「許可する」を押すだけです。ブラウザでサインインできないツールは、「ブラウザのないサーバー」を参照してください。

### どのツールで使えますか？

個別のタブがあるツールは、どれも実際に接続して確認しています。リモート MCP サーバーとブラウザでのサインインに対応したツールなら、たいてい同じように接続できます。

### Grok Build で使えますか？

現時点では使えません。Grok Build が Beatra のツール名を受け付けないためです。代わりに [Skill のインストール](https://beatra.ai/ja/install)をおすすめします。

### ブラウザのないサーバーではどうしますか？

「ブラウザのないサーバー」のコマンドを使います。リンクと接続コードが表示されます。任意のスマートフォンやパソコンでリンクを開き、コードを確認して「許可する」を押します。

### 接続を解除するには？

コンソールで[「デバイス → 接続済みのアプリ」](https://console.beatra.ai/apps)を開き、「接続を解除」を押します。ツールの次の呼び出しは拒否されます。再び使うときは、もう一度接続します。

### どのくらいでサインインし直しますか？

定期的なサインインは不要です。ツールがバックグラウンドでアクセスを更新し、1 年ほど使わなかった場合だけサインインし直します。
