エージェントを接続する

UnifAPI を Claude、ChatGPT、Cursor、Codex、Claude Code、OpenClaw、Hermes、その他の MCP クライアントに接続します。プロンプトを 1 つ貼り付けるか、Web コネクタを追加します — 読み取り専用、OAuth、API キー不要。オプションのスキルバンドルと、高度な手動 MCP サーバーおよび API キーのベアラーセットアップも扱います。

公開データ MCP サーバーをエージェントに接続します — 読み取り専用、OAuth、API キー不要。オープンソースのエージェントとスキルは github.com/unifapi-agent/agents にあります。

ほとんどのクライアントでは、設定ファイルに触れたりトークンを貼り付けたりする必要はありません。サーバー（貼り付けたプロンプトまたは Web コネクタ）を追加し、エージェントやスキルを実行して、エージェントが最初にライブデータを必要としたときに OAuth でサインインします。

OAuth が推奨されるパスです。UnifAPI は読み取り専用で、公開データに限定されています。OAuth はあなたの UnifAPI ワークスペースとクレジットを認可するものであり、ユーザーのプライベートなソースアカウントを認可するものではありません。接続に API キーは不要です。

エージェントを接続する

お使いのクライアント向けのパスを選択してください。それぞれがライブデータ用にホスト型 MCP サーバー（https://mcp.unifapi.com）を接続します。エージェントスキルは npx skills add unifapi-agent/agents で追加します。

プロンプトを 1 つ貼り付ける

Claude Code、Codex、Cursor、OpenClaw、Goose、Hermes — 自身の MCP サーバーを管理するあらゆるエージェント。これを貼り付けると、サーバーが追加され OAuth サインインが実行されます：

Install the UnifAPI MCP server for me, then confirm it connected. It's a remote
(streamable HTTP) MCP server at https://mcp.unifapi.com. UnifAPI uses OAuth — open
the browser sign-in when prompted. It's read-only public data, no API key to paste.

Web コネクタ（Claude、ChatGPT、Perplexity、Grok）

https://mcp.unifapi.com を指すカスタムコネクタを追加し、OAuth で認可します。ChatGPT では Developer Mode（Plus、Pro、Team、Enterprise）が必要です：

Settings -> Connectors -> Advanced -> enable Developer Mode
Connectors -> Create
MCP server URL: https://mcp.unifapi.com
Authentication: OAuth

Codex

Codex は MCP とスキルを別々に接続します。MCP サーバーを ~/.codex/config.toml に追加します：

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

その後、ログインしてスキルを追加します：

codex mcp login unifapi
npx skills add unifapi-agent/agents

Claude 互換のプラグインホスト

Claude Code、Claude Desktop、OpenClaw は、スキルと MCP サーバーをワンショットでまとめてインストールできます：

/plugin marketplace add unifapi-agent/agents
/plugin install unifapi@unifapi

その後でエージェントやスキルを実行し、プロンプトが表示されたら OAuth サインインを完了します。

その他の MCP クライアント

スキルを追加してから、ライブデータ用にクライアントをホスト型 MCP サーバーに向けます：

npx skills add unifapi-agent/agents

MCP server URL: https://mcp.unifapi.com

実行する

インストール後、新しいチャットやスレッドを開始し、タスク結果を依頼します。エージェントスキルは、必要に応じて MCP を通じて公開データ操作を発見して呼び出します：

Analyze these Twitter/X KOLs for an AI developer-tool campaign: @vercel, @shadcn, @rauchg.
Use UnifAPI public data and return price ranges, evidence, confidence, and follow-up questions.

OAuth は、エージェントが最初に UnifAPI ツールを呼び出すか、ワークスペースクレジットを消費する必要があるときにのみ開きます。そのため、サインインする前に閲覧してタスクを開始できます。ワークフローモデルについては Skills を参照してください。

エージェントができること

接続すると、エージェントは UnifAPI の背後にあるライブな公開データ操作にアクセスできるようになります。次のような作業に役立ちます：

Twitter/X KOL 分析とインフルエンサーのショートリスト
TikTok、YouTube、Instagram、Reddit、その他のサポートされているプラットフォームにわたるクリエイター発見
公開された投稿、プロフィール、コメント、トレンドからの競合モニタリング
公開ソーシャルシグナルからの市場リサーチ
公開された LinkedIn 形式のデータからのリードと企業のエンリッチメント

エージェントは通常、生の API ダンプではなく、ブリーフ、テーブル、ショートリスト、価格レンジ、フォローアッププランを返すべきです。

MCP で公開されるツール

UnifAPI は 3 つの MCP ツールを公開します。API エンドポイントごとに個別の MCP ツールを登録することはありません。

ツール	用途
`list_operations`	プラットフォーム/キーワードでライブな公開データ操作を検索します。
`get_operation`	パラメータ、スキーマ、呼び出し例を確認します。
`call_api`	具体的な操作を呼び出し、データと課金情報を返します。

典型的なエージェントフロー：

操作を発見する。 エージェントが正確な API パスを知らないときは list_operations を使用します。

呼び出す前に確認する。 get_operation を使用して、パラメータ、リクエストボディの形状、例を読み取ります。

公開データを呼び出す。 プレースホルダーが埋められた後、/x/tweets/search/recent や /tiktok/videos/{id} などの具体的なパスで call_api を使用します。

高度な設定: MCP サーバー URL と API キーのベアラー

上記のパスはほとんどのクライアントをカバーします。MCP を手動で接続する場合、 HTTP MCP トランスポート上に構築する場合、または明示的な設定を必要とするクライアント向けに接続を製品化する場合は、このセクションを使用してください。

UnifAPI は、ホスト型 MCP サーバーを通じて公開データレイヤーを公開します：

https://mcp.unifapi.com

手動 MCP セットアップ

クライアントがプラグインの代わりに生のコネクタ URL を受け取る場合は、ホスト型サーバーを直接追加します。

Claude / Claude Desktop カスタムコネクタ：

Customize -> Connectors -> + -> Add custom connector
Name: UnifAPI
URL: https://mcp.unifapi.com
Connect -> complete OAuth

Team および Enterprise プランでは、最初に Owner が Organization settings -> Connectors からコネクタを追加します。その後、メンバーが Customize -> Connectors からそれを接続します。古いローカル専用の Claude Desktop セットアップでは、mcp-remote が claude_desktop_config.json を通じてホスト型サーバーをブリッジできます：

{
  "mcpServers": {
    "unifapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.unifapi.com"]
    }
  }
}

Claude Code CLI：

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

Codex CLI：

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

OpenClaw リモート Streamable HTTP サーバー：

openclaw mcp add unifapi \
  --url https://mcp.unifapi.com \
  --transport streamable-http \
  --auth oauth

openclaw mcp login unifapi
openclaw mcp doctor unifapi --probe

Hermes ~/.hermes/config.yaml：

mcp_servers:
  unifapi:
    url: "https://mcp.unifapi.com"
    auth: oauth

hermes mcp login unifapi

Cursor .cursor/mcp.json：

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

VS Code .vscode/mcp.json：

{
  "servers": {
    "unifapi": {
      "type": "http",
      "url": "https://mcp.unifapi.com"
    }
  }
}

その他の MCP クライアント — 正規のサーバー URL で Streamable HTTP を使用します：

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

OAuth の詳細

UnifAPI の MCP サーバーは OAuth 保護リソースです。

フィールド	値
MCP サーバー URL	`https://mcp.unifapi.com`
保護リソースのメタデータ	`https://mcp.unifapi.com/.well-known/oauth-protected-resource`
認可サーバー	`https://api.unifapi.com/api/auth`
必要な MCP スコープ	`unifapi:mcp`
トランスポート	Streamable HTTP

保護リソースのメタデータは、互換性のあるクライアントに、どこで認可するか、どのスコープが必要かを伝えます。OAuth トークンにはワークスペースのクレームが含まれているため、ツール呼び出しは直接的な HTTP API 呼び出しと同じワークスペースクレジットを消費します。OAuth は UnifAPI を認可するものであり、ユーザーのプライベートなソースアカウントへのアクセスを付与するものではありません。

MCP クライアントが明示的にサポートしていない限り、クライアント設定にカスタムスコープフィールドを追加しないでください。互換性のあるクライアントは、保護リソースのメタデータを発見し、必要なスコープを要求するはずです。

API キーのベアラーフォールバック

これは、クライアントが OAuth を完了できない場合、またはベアラートークン/ヘッダーを明示的に要求する場合にのみ使用してください。上記の OAuth パスでは API キーは不要です。

UnifAPI ダッシュボードにサインインします。
API キーを作成します。
それを認可ヘッダーとして送信するよう MCP クライアントを設定します：

Authorization: Bearer YOUR_UNIFAPI_KEY

Cursor スタイルの JSON 例：

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_UNIFAPI_KEY"
      }
    }
  }
}

UnifAPI は、Authorization を設定できないクライアントのために X-API-Key と X-UnifAPI-Key ヘッダーも受け付けますが、Authorization: Bearer ... が推奨されます。

課金とクレジット

MCP 呼び出しは、HTTP 呼び出しと同じ課金モデルを使用します。

MCP サーバーの接続（およびスキルの追加）は無料です。
call_api は、公開データ操作を呼び出すときにワークスペースクレジットを消費します。
課金メタデータは、操作レスポンスにそれが含まれている場合、ツール結果に返されます。
ワークスペースにクレジットが残っていない場合、呼び出しは insufficient_credits で失敗します。

リクエスト制限についてはレート制限を、公開エラー語彙についてはエラーを参照してください。

リソース/オーディエンス：https://mcp.unifapi.com/
スコープ：unifapi:mcp

クライアントがトークン交換中にリソース/オーディエンスを送信しない場合、MCP 保護リソースで検証できないトークンを受け取る可能性があります。

エージェントを接続する

エージェントを接続する

プロンプトを 1 つ貼り付ける

Web コネクタ（Claude、ChatGPT、Perplexity、Grok）

Codex

Claude 互換のプラグインホスト

その他の MCP クライアント

実行する

エージェントができること

MCP で公開されるツール

高度な設定: MCP サーバー URL と API キーのベアラー

手動 MCP セットアップ

OAuth の詳細

API キーのベアラーフォールバック

課金とクレジット

トラブルシューティング

クライアントが API キーを要求する

OAuth は成功するがツール呼び出しが失敗する

`401 unauthorized`

`insufficient_credits`

ツール一覧が古いように見える

関連リソース

Skills

API リファレンス

認証

マーケティング MCP ページ

このページの内容