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

# MCP接続ガイド

> MCPでAIエージェントをToAPIsに接続し、200以上のモデルで画像と動画を生成します。

MCPで、いつも使っているエージェントにToAPIsを接続します。APIキーをコピーする代わりにブラウザでログインして承認。エージェントがモデルを選び、パラメータを確認し、タスクを送信して結果を取得します。

> [!NOTE]
>
> アカウントと残高があるサイトの接続先を選んでください。以下は国際サイトの例です。toapis.cnのアカウントでは `https://api.toapis.com/mcp` を `https://api.toapis.cn/mcp` に置き換え、toapis.cnのコンソールを使います。両サイトのアカウントと残高は別です。

| サイト | MCP endpoint |
| - | - |
| 国際サイト | `https://api.toapis.com/mcp` |
| 中国本土サイト | `https://api.toapis.cn/mcp` |

## 接続前の準備

Streamable HTTPによるリモートMCP対応クライアントが必要です。ToAPIs skillsはモデル選択とプロンプト作成を支援する任意の機能です。`npx skills add` にはNode.jsが必要ですが、skillsを入れなくてもMCPは使えます。

ブラウザ承認では対応するToAPIsサイトにログインし、クライアント名を確認して、APIキーを選ぶか上限付きの専用キーを作成し、許可します。ヘッダー認証では [API Tokens](https://toapis.com/dashboard/tokens) で専用キーを作成し、ローカルで `<API_KEY>` を置き換えてください。実際のキーをチャットやバージョン管理に含めないでください。

## クライアントを選んで数ステップで接続

> [accordion] Claude Code
>
> ### Claude Code
>
> ターミナルで以下を実行します。最初は任意のskillsのインストール、次はMCPサーバーの追加です。その後 `/mcp` で承認し、`claude mcp list` で接続を確認します。
>
> ```bash theme={null}
> npx skills add toapis/skills -g --agent claude-code -y
> claude mcp add --transport http --scope user toapis https://api.toapis.com/mcp --header "X-Locale: ja"
> ```
>
> ### /mcpで承認
>
> Claude Codeで /mcpと入力し、toapisを選んでブラウザでログインします。一覧にtoapisがない場合は、先にClaude Codeを再起動してください。

> [accordion] Claude
>
> ### 手動で追加
>
> 設定 > コネクタ を開いてカスタムコネクタを追加します。名前はToAPIs、URLは下のアドレスを入力し、OAuth Client IDとSecretは空欄のままにします。
>
> ```text theme={null}
> https://api.toapis.com/mcp
> ```
>
> ### 接続して承認
>
> Add、続いてConnectをクリックし、ToAPIsのページでログインしてAPIキーを選び「許可」をクリックします。
>
> ClaudeはAnthropicのサーバーからToAPIsにアクセスするため、IP許可リストを設定したキーは選ばないでください。Freeプランで追加できるカスタムコネクタは1つです。

> [accordion] Codex
>
> ### Codex
>
> ターミナルで以下を実行します。最初は任意のskillsのインストールです。サーバー追加時にブラウザ承認が始まったら、完了してから続けます。`codex mcp list` に `Not logged in` と表示された場合は `codex mcp login toapis` を実行し、承認後に再確認します。設定後は新しいチャットを開始してください。
>
> ```bash theme={null}
> npx skills add toapis/skills -g --agent codex -y
> codex mcp add toapis --url https://api.toapis.com/mcp
> codex mcp list
> ```
>
> ### ブラウザで承認
>
> CodexがToAPIsの承認ページを開きます。ログインしてクライアント名を確認し、APIキーを選ぶか利用上限付きの専用キーを作成して「許可」をクリックします。デスクトップアプリでは 設定 > MCP serversでtoapisの横にあるAuthenticateからも承認できます。
>
> Codex CLIとデスクトップアプリは同じ設定を共有するため、一度設定すれば両方で使えます。
>
> [Codex MCP](https://developers.openai.com/codex/mcp/)

> [accordion] Cursor
>
> ### ToAPIsを追加
>
> 以下を `~/.cursor/mcp.json` に統合し、MCP設定から接続します。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "url": "https://api.toapis.com/mcp",
>       "headers": {
>         "X-Locale": "ja"
>       }
>     }
>   }
> }
> ```
>
> 任意のskillsのインストール：
>
> ```bash theme={null}
> npx skills add toapis/skills -g --agent cursor -y
> ```
>
> ### ログインして承認
>
> CursorのMCP設定でtoapisの横にあるConnectをクリックし、ブラウザでToAPIsにログインしてAPIキーを選び「許可」をクリックします。

> [accordion] Devin
>
> ### ToAPIsを追加
>
> Devin DesktopとDevin CLIは同じ設定を共有します。ターミナルで次のコマンドを実行するか、Devinに実行を頼んでください：
>
> ```bash theme={null}
> devin mcp add -s user toapis https://api.toapis.com/mcp
> devin mcp login toapis
> ```
>
> ### ブラウザで承認
>
> devin mcp login toapisを実行するとブラウザが開きます。ToAPIsにログインし、APIキーを選んで「許可」をクリックします。実行しなかった場合も、Devinが初めてtoapisを使うときにログインを求めます。

> [accordion] Antigravity
>
> ### MCP設定に追加
>
> Antigravityのアプリ、IDE、CLIは `~/.gemini/config/mcp_config.json` を共有します。下の設定をマージして保存し、CLIで /mcpと入力するか設定でサーバーを再読み込みしてください。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "serverUrl": "https://api.toapis.com/mcp",
>       "headers": {
>         "X-Locale": "ja"
>       }
>     }
>   }
> }
> ```
>
> 既存の設定に `toapis` エントリを追加し、他のサーバーを残してください。
>
> ### 承認してコードを貼り付ける
>
> Cmd + ,（WindowsはCtrl + ,）でAntigravityの設定を開き、Customizationsでtoapisの横にあるAuthenticateをクリックします。ブラウザでToAPIsにログインして「許可」をクリックすると認証コードが表示されるので、設定画面に貼り付けてSubmitをクリックします。

> [accordion] Doubao（豆包）
>
> ### 専用キーを作成
>
> このクライアントはリクエストヘッダーでのキー指定のみに対応しています。ToAPIsコンソールでキーを作成し（利用上限の設定をおすすめします）、コピーしておいてください。下の設定の `<API_KEY>` をこのキーに置き換えます。
>
> [APIトークンを開く](https://toapis.com/dashboard/tokens)
>
> ### カスタムプラグインを作成
>
> 豆包デスクトップ版を開き、左側の「插件·技能·伙伴」をクリックし、「插件」ページ右上の「+ 添加」から「新建自定义插件」を選びます。サーバー名にToAPIs、トランスポートにHTTPを選び、サーバーURLに下のアドレスを入力します。
>
> ```text theme={null}
> https://api.toapis.com/mcp
> ```
>
> ### 認証ヘッダーを入力して保存
>
> 「自定义Headers」の「+ 添加」をクリックし、ヘッダー名にAuthorization、値に下の行を入力して（`<API_KEY>` は自分のキーに置き換え）、「保存」をクリックします。
>
> ```text theme={null}
> Bearer <API_KEY>
> ```
>
> 豆包デスクトップ版（WindowsまたはmacOS）で追加してください。企業アカウントでカスタムプラグインを使えるかは、管理者の設定によります。

> [accordion] QwenWork（千问办公）
>
> ### 専用キーを作成
>
> このクライアントはリクエストヘッダーでのキー指定のみに対応しています。ToAPIsコンソールでキーを作成し（利用上限の設定をおすすめします）、コピーしておいてください。下の設定の `<API_KEY>` をこのキーに置き換えます。
>
> [APIトークンを開く](https://toapis.com/dashboard/tokens)
>
> ### JSON設定を貼り付け
>
> 千问办公の左側で「扩展」→「连接器」を開き、右上の「+ 添加」→「粘贴JSON配置」をクリックし、下の設定を貼り付けて（`<API_KEY>` は自分のキーに置き換え）「导入」をクリックします。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "type": "streamable-http",
>       "url": "https://api.toapis.com/mcp",
>       "headers": {
>         "Authorization": "Bearer <API_KEY>",
>         "X-Locale": "ja"
>       }
>     }
>   }
> }
> ```
>
> ### コネクタをオンにする
>
> コネクタは初期状態でオフです。一覧でtoapisをオンにしてから、新しいタスクを作成すると使えるようになります。既存の会話では使えません。

> [accordion] Qwen Code
>
> ### ターミナルで実行
>
> 1行目でToAPIsスキルをインストールし（Node.jsが必要です。なくてもMCPは使えます）、2行目でToAPIs MCPサーバーを追加します：
>
> ```bash theme={null}
> npx skills add toapis/skills -g --agent qwen-code -y
> qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "X-Locale: ja"
> ```
>
> ### ブラウザで承認
>
> qwenを実行してQwen Codeを起動すると、ToAPIsに接続するときにブラウザで承認ページが開きます。ログインしてキーを選び、許可してください。Qwen Codeで /mcpと入力すると、toapisの接続と承認の状態を確認できます。
>
> ### ブラウザで承認できない場合はAPIキーを使う
>
> コンソールの「APIトークン」でキーを作成し、下のコマンドの `<API_KEY>` をそのキーに置き換えて実行します。
>
> ```bash theme={null}
> qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "Authorization: Bearer <API_KEY>" --header "X-Locale: ja"
> ```

> [accordion] Trae CN
>
> ### 専用キーを作成
>
> このクライアントはリクエストヘッダーでのキー指定のみに対応しています。ToAPIsコンソールでキーを作成し（利用上限の設定をおすすめします）、コピーしておいてください。下の設定の `<API_KEY>` をこのキーに置き換えます。
>
> [APIトークンを開く](https://toapis.com/dashboard/tokens)
>
> ### MCPサーバーを手動で追加
>
> Traeで「设置」>「MCP」を開き、「MCP Servers管理」右上の「添加」>「手动添加」をクリックし、下の設定を貼り付けて（`<API_KEY>` は自分のキーに置き換え）「确认」をクリックします。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "url": "https://api.toapis.com/mcp",
>       "headers": {
>         "Authorization": "Bearer <API_KEY>",
>         "X-Locale": "ja"
>       }
>     }
>   }
> }
> ```
>
> ### スキルをインストール（推奨）
>
> エージェントがモデル選びやプロンプト作成をうまくこなせるようになります（Node.jsが必要です。なくてもMCPは使えます）：
>
> ```bash theme={null}
> npx skills add toapis/skills -g --agent trae-cn -y
> ```

> [accordion] WorkBuddy
>
> ### カスタムコネクタを追加
>
> WorkBuddyのサイドバーからコネクタを開き、右上の「カスタムコネクタ」をクリックして、下の設定を貼り付けて保存します。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "type": "http",
>       "url": "https://api.toapis.com/mcp"
>     }
>   }
> }
> ```
>
> ### 接続して承認
>
> TrustとConnectをクリックし、開いたToAPIsのページでログインしてAPIキーを選び「許可」をクリックします。

> [accordion] その他のクライアント
>
> ### リモートMCPサーバーを追加
>
> 下のURLでリモートMCPサーバー（Streamable HTTP）を追加し、認証方式にOAuthを選びます。Client IDとSecretは空欄のままにします。
>
> ```text theme={null}
> https://api.toapis.com/mcp
> ```
>
> ### ブラウザでのログインに対応していない場合
>
> ヘッダー認証のみに対応している、またはブラウザでの承認を完了できないクライアントもあります。コンソールで専用キーを作成し、Authorization: Bearerヘッダーで接続してください。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "toapis": {
>       "url": "https://api.toapis.com/mcp",
>       "headers": {
>         "Authorization": "Bearer <API_KEY>",
>         "X-Locale": "ja"
>       }
>     }
>   }
> }
> ```

## 接続を確認

新しいチャットで下の文を送ってください。残高が表示されれば接続できています（確認は無料）。ログインを求められたり、認証に失敗したり、ToAPIsのツールが見つからなかったりする場合は、上の手順を見直してください。

```text theme={null}
ToAPIs の残りクレジットと今日の利用額を教えて
```

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

やりたいことを普段の言葉で伝えるだけ。エージェントがモデルを選び、ドキュメントに沿ってパラメータを用意し、タスクを送信して最後まで追跡します。

### 画像を生成

テキストから画像、参照画像での編集、アスペクト比や枚数の指定に対応。

```text theme={null}
ToAPIs で夜明けの灯台を 16:9 で生成して
```

### 動画を生成

テキストから動画、画像から動画。初期設定ではSeedanceがおすすめです。

```text theme={null}
この商品写真を 5 秒の縦型プロモーション動画にして
```

### ローカルファイルを使う

ローカル画像のパスを伝えると、エージェントがアップロードして参照画像として使います。

```text theme={null}
./product.png を参考に、商品を白い背景に置いて
```

エージェントは生成前にモデル資料を読み、ローカル素材を `create_upload` でアップロードし、`get_generation` で進捗を確認します。実行中は再送せず完了を待ちます。送信の応答を受け取れなかった場合、再試行では同じ `client_request_id` を使います。別のIDでは新たに課金されるタスクが作成される可能性があります。状態が `unknown` ならコンソールのタスク一覧を先に確認してください。結果URLを保存してください。クライアントによってはローカルにもダウンロードできます。

## 利用できるツール

| ツール | 用途 |
| - | - |
| `list_models` | 現在のキーで利用できる画像・動画モデル、価格、`docs_available` を取得。 |
| `get_model_docs` | 生成前にパラメータ資料を取得。`docs_available: true` のモデルを選択。 |
| `generate_image` | 画像を生成。有料。 |
| `generate_video` | 動画を生成。有料。 |
| `get_generation` | `client_request_id` でMCP生成の進捗と結果を確認。 |
| `get_task` | `task_id` で画像・動画タスクを確認。 |
| `create_upload` | ローカル画像・動画・音声用の一回限りのアップロードURLを作成。 |
| `get_balance` | キーの割り当てとアカウント残高を確認。 |
| `list_tasks` | 現在のキーの最近のタスクを取得。 |
| `get_usage` | 現在のキーの請求額を最大31日間で集計。返金は差し引かれません。 |

## よくある質問

> [accordion] APIキーは必要ですか？
>
> コピーする必要はありません。承認時にToAPIsのページで既存のキーを選ぶか専用キーを作成すると、エージェントはアクセストークン経由でそのキーを使います。ヘッダー認証のみに対応したクライアントは、APIキーで接続することもできます。

> [accordion] 料金はどうなりますか？
>
> APIを直接呼び出す場合と同じく、モデル料金が選んだキーとアカウントのクレジットから差し引かれます。モデル一覧、残高、タスクの確認は無料で、課金されるのは画像と動画の生成だけです。

> [accordion] CodexでFull accessが必要なのはなぜですか？
>
> スキルのインストールとMCPサーバーの追加はパソコン上のCodex設定に書き込みますが、初期設定の権限モードではエージェントがワークスペース外のファイルを変更できません。必要なのは設定時だけで、終わったら元に戻せます。ターミナルで自分でコマンドを実行することもできます。

> [accordion] 接続を解除するには？
>
> コンソールの「接続済みアプリ」で解除してください。承認が取り消され、この接続用に作成した専用キーも無効になります（ほかの接続で使用中の場合を除く）。クライアントでtoapisを削除する（例：codex mcp remove toapis）だけでは、ローカルの設定が消えるだけです。

> [accordion] toapis.comとtoapis.cnの違いは？
>
> 2つのサイトはアカウントとクレジットが別々です。toapis.comのアカウントはapi.toapis.com/mcp、toapis.cnのアカウントはapi.toapis.cn/mcpを使います。もう一方のサイトでログインすると、サイトが一致しない旨が表示されます。

> [accordion] どのクライアントに対応していますか？
>
> リモートMCPとOAuthに対応したデスクトップやコマンドラインのクライアントなら、ほとんどが「その他のクライアント」の手順で接続できます。承認に失敗する場合はAPIキーで接続してください。今後も対応クライアントの手順を追加していきます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.