PoYo MCP Server
すべての PoYo モデルを、AI Agent から利用。
一度接続するだけで、Codex、Claude Code、Cursor、VS Code が画像、動画、音声、チャット、3D モデルを検索し、最新の Schema と公開料金を確認して、PoYo 経由でタスクを実行できます。
MCP は、API リクエストを自分で書かなくても AI Agent が PoYo モデルを利用できる安全な接続です。
npx -y @poyoapi/mcpVS Code または stdio 専用クライアント向けのローカルブリッジです。Node.js 20+ が必要です。下の設定を使用してください。
設定方法
3 ステップで接続できます。カテゴリやモデルを制限するときだけ詳細設定を開いてください。
API Key を準備
最初に PoYo API Key を作成します。クライアントの接続時に使用します。
実際の API Key を共有設定ファイルや URL に書き込まないでください。
クライアントを選び、設定場所を確認
使用中のアプリを選択すると、該当する設定場所だけが表示されます。
手動設定ファイル
~/.codex/config.toml適用範囲
現在のユーザーのすべてのプロジェクト
クライアントで MCP 設定を開きます。画面上の入口がない場合は、上のファイルを開くか作成してください。
./ で始まるパスは、現在開いているプロジェクト内にあります。必要ならフォルダやファイルを作成してください。
設定を追加して確認
選択したクライアントの設定をコピーし、MCP を再読み込みして無料の接続確認を行います。
既存の設定は上書きせず、結合してください
ファイルに他の MCP Server がある場合は、poyo サーバーのエントリだけを結合し、既存の内容をすべて残してください。
次の設定を追加する場所 ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45クライアントを起動する前に、API Key を環境変数 POYO_API_KEY に保存してください。 保存後、新しい Codex セッションを開始して MCP 設定を再読み込みしてください。
POYO_API_KEY の設定方法
OS に合うコマンドをコピーし、your_api_key を実際の Key に置き換えて、同じターミナルセッションからクライアントを起動してください。
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"これらのコマンドは現在のターミナルセッションだけに有効です。実際の Key をプロジェクトファイル、スクリーンショット、公開ログに残さないでください。
Agent に安全な設定を手伝ってもらう
既存設定を保持し、実際の Key をファイルに書かず、書き込み前に差分を表示するよう制限した Prompt をコピーします。
接続を確認
次の順番で確認します。有料モデルのタスクは開始されません。
- 1クライアントに PoYo ツールが表示されれば、設定は読み込まれています。
- 2poyo_account がアカウント情報を返せば、API Key は有効です。
- 3poyo_search_models がモデルを返せば、カタログにアクセスできています。
接続できない場合
- ツールがない場合：設定場所を確認し、MCP Server を再読み込みしてください。
- アカウント確認に失敗する場合：POYO_API_KEY を確認し、同じ環境からクライアントを再起動してください。
- 接続に失敗する場合：https://api.poyo.ai/mcp と、ネットワークまたはプロキシの HTTPS 許可を確認してください。
ツール、アカウント、カタログの確認がすべて成功すれば、PoYo MCP の接続は完了です。
標準で 8 個のコンパクトツールを利用可能
事前にモデルを選ぶ必要はありません。Agent がカタログを検索し、その後 Schema と料金を確認します。
poyo_search_modelspoyo_get_model_schemapoyo_get_pricingpoyo_chatpoyo_run_modelpoyo_submit_jobpoyo_check_jobpoyo_account
Endpoint
https://api.poyo.ai/mcp[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45設定には環境変数または安全な入力欄を使用します。API Key が URL に含まれることはありません。
PoYo MCP で Agent は何ができますか？
自然言語でタスクを伝えると、Agent が適切なモデルを検索し、入力と料金を確認して実行します。長時間ジョブの場合は、完了後に結果を返します。
モデルを検索
自然言語のタスクから、現在利用できる画像、動画、音声、チャット、3D モデルを検索
poyo_search_models入力を確認
最新の入力 Schema、例、プロトコル、機能を確認
poyo_get_model_schema料金を確認
有料リクエストを実行する前に、現在の公開料金を確認
poyo_get_pricing短時間タスクを実行
短い待ち時間で結果を返せるチャットや生成タスクを完了
poyo_chatpoyo_run_model長時間ジョブを継続
長時間タスクを送信し、task_id を保持して、後から状態と出力を確認
poyo_submit_jobpoyo_check_jobアカウントを確認
モデル実行前に、現在のアカウントとクレジット情報を確認
poyo_accountMCP、CLI、REST API はどのように使い分けますか？
Agent にモデルの選択と呼び出しを任せる場合は MCP、ターミナルや CI の自動化には PoYo CLI、アプリケーション通信やトークン単位の出力には REST API を使用します。
AI アシスタントまたはコーディング Agent
選択
MCP
Streamable HTTP適している理由
エディタや会話内で、Agent がモデルを検索し、Schema と料金を確認してツールを呼び出せます。
ターミナルスクリプトまたは CI
選択
PoYo CLI
@poyoapi/cli適している理由
シェルからモデル検索、生成、ジョブ完了待機を行い、JSON、JSONL、CSV を出力できます。
アプリケーションのバックエンド
選択
REST API
HTTP + JSON / SSE適している理由
アプリケーション通信、トークンストリーミング、ポーリング、Webhook、バッチジョブを処理します。
よくある質問
MCP 接続、API Key、ツール範囲、課金、長時間ジョブの再開について説明します。
API Key を作成し、MCP ドキュメントに沿ってクライアントへ PoYo を追加したら、アカウント、モデル Schema、公開料金を確認してください。