UnifAPI MCP を Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、OpenClaw、Hermes に接続し、最初の公開データ Skill を実行する手順。

要点: 本記事は MCP セットアップを調べている方向けのオンボーディング記事です。ホスト型の UnifAPI サーバーを追加し、OAuth で認証し、すでに使っているエージェントクライアントから Skill を実行します。

互換性のある汎用エージェント、リサーチエージェント、コーディングエージェント、あるいは MCP 対応クライアントに UnifAPI の公開データへのアクセスを与える最速の方法は、ホスト型の MCP サーバーを接続することです。URL を 1 つ追加し、クライアントが求めたときに認証すれば、エージェントはグルーコードを書いたりプラットフォーム固有の API キーを貼り付けたりせずに Skill を実行できます。

UnifAPI MCP サーバーの正規 URL は https://mcp.unifapi.com です。クライアントが対応している場合は OAuth を使ってください。API キーによるベアラー認証も互換性のための経路として残っていますが、ほとんどの運用者にとって最初のセットアップ手段にすべきではありません。

何を接続するのか

MCP はエージェントにツールのサーフェスを与えます。UnifAPI のホスト型 MCP サーバーは 3 つのカタログツールを公開します。発見用の list_operations、スキーマと例の確認用の get_operation、そして具体的な公開データオペレーションを呼び出すための call_api です。エージェントは API エンドポイントごとに個別のツールを用意する必要はありません。

項目	値
サーバー URL	`https://mcp.unifapi.com`
推奨される認証	MCP クライアント経由の OAuth
互換用の認証	クライアントが静的トークンを要求する場合は API キーのベアラーヘッダー
課金されるもの	ライブ API が返す公開データのレコード
UnifAPI が課金しないもの	すでに支払っているモデルトークンやエージェントプラン

はじめる前に

MCP 対応のクライアント、OAuth が開いたときの UnifAPI アカウント、そして公開データのレコードを返すのに十分なワークスペースのクレジットが必要です。サインインする前に Skills を閲覧できます。サインインのタイミングは、エージェントが実際にツールを呼び出す必要が生じたときにすべきです。

Claude Desktop や Claude.ai のカスタムコネクタでテストする場合、リモートコネクタは Anthropic のクラウドを介して仲介されることを忘れないでください。あなたの MCP サーバーは公開インターネットから到達可能でなければなりません。https://mcp.unifapi.com についてはそれで問題ありません。問題になるのはプライベートなローカルサーバーの場合だけです。

Codex

Codex は Codex CLI と共有設定を通じてリモートの HTTP MCP サーバーに対応しています。UnifAPI を次のコマンドで追加します。

codex mcp add unifapi --url https://mcp.unifapi.com

次に、サーバーが設定されたことを確認します。

codex mcp list

新しい Codex セッションを開き、単なる汎用的な API 呼び出しではなく Skill 形式のタスクを依頼します。たとえば: Run a KOL pricing pass for these Twitter/X creators using UnifAPI public data. Return ranges, evidence, confidence, and follow-up questions.

Claude Code

Claude Code の最新リファレンスは、利用可能な場合はクラウド MCP サーバーにリモート HTTP を推奨しています。Claude Code に使わせたいプロジェクトから UnifAPI を追加します。

claude mcp add --transport http unifapi https://mcp.unifapi.com

プロジェクト横断でサーバーを利用したい場合はユーザースコープを使います。

claude mcp add --transport http --scope user unifapi https://mcp.unifapi.com

Claude Code の中で /mcp を実行して接続状態を確認し、必要なら OAuth を完了します。サーバーが .mcp.json を通じてプロジェクトスコープになっている場合、Claude Code は使用前に承認を求めることがあります。

Claude Desktop と Claude.ai

Claude Desktop または Claude.ai のリモート MCP コネクタでは、Customize -> Connectors -> + -> Add custom connector を使います。UnifAPI のような分かりやすい名前を入力し、コネクタ URL に https://mcp.unifapi.com を使い、Connect をクリックして認証します。

メニューを使わずに済ませることもできます。このリンクを開くと、名前と URL が入力済みの同じダイアログが表示されます。確認して Add、続けて Connect をクリックします。

リモートコネクタを、古いローカル専用の Desktop MCP 設定と混同しないでください。リモートコネクタは Claude の設定 UI で追加し、接続後は Claude の各サーフェスをまたいで利用できます。デスクトップ設定で構成するローカルの stdio サーバーは、別の仕組みです。

Cursor

Cursor は mcp.json を通じて MCP に対応しています。グローバルなセットアップには ~/.cursor/mcp.json を作成または編集します。プロジェクト限定のセットアップには、プロジェクト内に .cursor/mcp.json を作成します。

このリモートサーバーの形を使います。

{ "mcpServers": { "unifapi": { "url": "https://mcp.unifapi.com" } } }

サーバーがすぐに表示されない場合は Cursor を再起動するか、MCP ツールのビューを更新してください。Cursor のエージェントは関連する場面で有効な MCP ツールを使い、設定によってはツールを実行する前に承認を求めることがあります。

最初に実行する Skill

エージェントに、どんな成果を求めているか、どんな根拠を確認すべきかを伝えるタスクプロンプトを使います。良い初回実行はこれです。

Find Twitter/X KOLs discussing AI coding tools and summarize the best outreach angles. Use UnifAPI public data through MCP. Return a ranked shortlist, public evidence, risk notes, and follow-up questions. Keep the workflow bounded to public data.

もう 1 つ役立つテストはこれです。

Find the top three TikTok videos about Anthropic this week. Use UnifAPI MCP. Show the public records you used, then summarize the pattern in one paragraph.

エージェントはオペレーションを発見し、適切なオペレーションを確認し、それを呼び出し、結果を統合すべきです。カタログを確認せずにエンドポイント名を推測しようとする場合は、まず list_operations と get_operation を呼び出すよう頼んでください。

課金されるもの

ワークスペースのクレジットは 1 件あたり $0.001 です。標準的な課金対象レコードは 1 クレジットで、より高コストなオペレーションは OpenAPI で最小クレジットを公開しています。初回チャージの 2,000 クレジットの一回限りのボーナスは、いくつかの軽いワークフローの形をテストするのに十分です。繰り返し実行する準備ができたら、従量課金の残高をチャージしてください。

最も重要なコスト習慣は、プロンプトに制限をかけることです。まず上位 10 件または上位 20 件のレコードを依頼し、回答が役立つ場合だけ深掘りします。「この市場についてすべてリサーチして」のような曖昧な依頼は、多数のオペレーションに広がりかねません。「Reddit のスレッドを 20 件取得して、繰り返し出てくる反論をまとめて」のような制限された依頼は、確認も予算管理もしやすくなります。

トラブルシューティング

症状	考えられる原因	対処法
サーバーは表示されるがツールが使われない	エージェントが MCP ツールを選ばなかった	まず利用可能な UnifAPI オペレーションを列挙するよう頼む
OAuth が完了しない	ブラウザ/認証フローが終わらなかった	`/mcp` またはクライアントのコネクタ設定を開き直して再接続する
ツール呼び出しが unauthorized を返す	認証経路の誤りまたはトークンの期限切れ	OAuth で再認証するか、ベアラートークンの設定を確認する
結果が広すぎる	プロンプトに制約がなかった	プラットフォーム、対象期間、レコード数、出力フォーマットを追加する
回答が過剰に主張する	プロンプトが境界を設定しなかった	根拠、確度、未知の事項を求める

確認したソース

このセットアップガイドは 2026 年 6 月 2 日に、公式の OpenAI Docs MCP ページ、Claude Code MCP リファレンス、Anthropic のカスタムコネクタのヘルプセンター記事、そして Cursor の MCP ドキュメントに照らして更新されました。

次に読むべきもの

MCP セットアップ - 最新のホスト型コネクタの手順を 1 か所にまとめています。

MCP で KOL 料金算定エージェントを動かす - セットアップ後の最初のタスクを示します。

MCP カタログツールの設計 - エージェントがオペレーションを発見し呼び出す仕組みを解説します。