cloro

cloro MCP サーバー

cloro MCP サーバーのソースです。ChatGPT、Perplexity、Gemini、Copilot、Grok、Google AI Mode、Google Search、Google News に問い合わせるツールを、MCP 対応エージェントに提供します。エージェントに 「ChatGPT が最良の SERP API として当社を推奨しているか確認して」 と頼むと、cloro API を呼び出し、解析された回答と引用元について推論します。

mcp.cloro.dev でホスト版を実行するか、stdio 経由でローカル実行できます。

エージェントを cloro MCP サーバーに接続するには？

Claude では OAuth でサインインするため、キーは不要です。

1. Customize → Connectors に移動し、Add custom connector を選択します。
2. https://mcp.cloro.dev/mcp を入力します。Authentication で Sign in when needed を選択します。
3. Claude に cloro ツールを使うよう依頼します。cloro にサインインし、呼び出しのクレジットを支払う組織を選択します。

その他のクライアントでは、ダッシュボードの cloro API キーを使います。ホスト版サーバーは Streamable HTTP に対応しています。カスタムヘッダーを設定できないクライアントでも動作するよう、キーを URL パスに含めます。

{
  "mcpServers": {
    "cloro": {
      "type": "http",
      "url": "https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp"
    }
  }
}

クライアントでヘッダーを設定できる場合は、https://mcp.cloro.dev/mcp と Authorization: Bearer YOUR_CLORO_API_KEY を使います。Claude Code では次のようにします。

claude mcp add --transport http cloro https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp

Cursor の場合

このリポジトリは Cursor プラグインでもあります。Cursor マーケットプレイスからインストールするか、Cursor にリポジトリを指定すると、Cursor が 1 つの変数の入力を求めます。

変数	値
CLORO_API_KEY	ダッシュボードで取得したキー

Cursor はキーを自身の側で保存し、Authorization: Bearer として送信するため、キーが URL やリポジトリに含まれることはありません。マニフェストは .cursor-plugin/plugin.json、サーバー定義は mcp.json です。

自分で実行する

npm install
npm run build
MCP_TRANSPORT=stdio CLORO_API_KEY=your_key node dist/index.js

MCP_TRANSPORT は http（デフォルト）または stdio です。stdio モードではクライアントがプロセスを起動し、キーは CLORO_API_KEY から取得されます。http モードではキーはリクエストごとに渡され、サーバーにはキーを設定しません。PORT のデフォルトは 8095、CLORO_API_URL のデフォルトは https://api.cloro.dev です。

CLERK_ISSUER を設定しない限り、OAuth は無効です。ホスト版サーバーでは https://clerk.cloro.dev に設定されています。api.cloro.dev が受け入れるのはこの発行元のトークンのみであるため、そこにリクエストを転送するセルフホストサーバーでも同じ値を使用する必要があります。MCP_PUBLIC_URL（デフォルトは https://mcp.cloro.dev）は、保護対象リソースのメタデータに含めるリソース URL を設定します。

どのようなツールを提供していますか？

ツール	エンドポイント
scrape_chatgpt	POST /v1/monitor/chatgpt
scrape_gemini	POST /v1/monitor/gemini
scrape_copilot	POST /v1/monitor/copilot
scrape_perplexity	POST /v1/monitor/perplexity
scrape_grok	POST /v1/monitor/grok
scrape_google_ai_mode	POST /v1/monitor/aimode
scrape_google	POST /v1/monitor/google
scrape_google_news	POST /v1/monitor/google/news
list_countries	GET /v1/countries
list_states	GET /v1/states

アシスタント用ツールでは、prompt と country（ISO 3166-1 alpha-2）を指定します。また、米国の州単位で対象を指定する場合は、任意で state も指定できます。Google 用ツールでは、結果の地域を指定する gl と、任意のインターフェース言語 hl を指定します。非推奨の別名である country も、引き続き gl として機能します。scrape_google_ai_mode では、state ではなく location または uule を使って国より細かい地域を対象にします。scrape_google は、query と gl を指定する方法と、検索クエリとページネーション情報を含む完全な google.com/search URL を指定する方法のどちらでも実行でき、Google の AI Overview 用に include.aioverview も指定できます。どのツールでも、より多くのペイロードフィールドを取得する場合は任意の include オブジェクトを指定できます。最小限のレスポンスにするには、指定しないでください。

scrape_grok は登録されていますが、Grok は提供を終了しています。ログアウト状態のユーザーには grok.com でサインアップ画面が表示されます。cloro API は呼び出しを 400（MODEL_UNAVAILABLE）で拒否し、これらの呼び出しにクレジットはかかりません。

仕組み

サーバーにはビジネスロジックもシークレットもありません。各リクエストでは、呼び出し元自身の認証情報である API キーまたは OAuth アクセストークンを Bearer トークンとして api.cloro.dev に転送します。そのため、認証、クレジット請求、レート制限、同時実行はすべて、このサーバーではなく API によって適用されます。http モードでは、各 POST リクエストで呼び出し元の認証情報に紐づけた新しいサーバーとトランスポートを作成するため、セッション状態を持たずに1つのデプロイですべてのユーザーに対応できます。

initialize と tools/list は認証情報なしで応答するため、クライアントはサインイン前にツールの一覧を取得できます。認証情報なしで最初の tools/call を実行すると、/.well-known/oauth-protected-resource/mcp を示す WWW-Authenticate ヘッダーとともに 401 が返されます。OAuth クライアントはそこから認可サーバーを読み取り、フローを実行します。サーバーは発行者の公開 JWKS に照らしてトークンの署名を検証する（コードは src/oauth-tokens/ にあります）ため、Clerk のシークレットは必要ありません。

ツールの入力スキーマには、API が検証に使用するのと同じ zod スキーマを使っています。これらは cloro のバックエンドから src/schemas/ にベンダーコピーされています。このパッケージは公開されていないため、インポートではなくコピーしています。両者に食い違いがある場合は、API リファレンスが正式な情報源です。

FAQ

これをセルフホストする必要がありますか？

いいえ。mcp.cloro.dev はホスト済みで、ほとんどのユーザーにおすすめの方法です。このリポジトリは、実行される内容を確認したり、環境に応じてセルフホストしたりできるように用意されています。

クレジットはかかりますか？

スクレイピングツールは課金対象のエンドポイントを呼び出すため、API と同じ料金がかかります。list_countries と list_states は固定の参照リストを読み込むだけなので、料金はかかりません。料金をご覧ください。

API キーが URL に含まれているのはなぜですか？

複数の MCP クライアントでは、カスタムヘッダーを設定できないためです。使用中のクライアントで設定できる場合は、代わりに Authorization ヘッダー形式を使用し、キーをパスに含めないでください。クライアントが OAuth に対応している場合は OAuth を使用すれば、キーは不要です。URL パスで使用できるのは API キーのみで、OAuth トークンは使用できません。

リクエストのタイムアウトはどのくらいですか？

320 秒です。同期スクレイピングはサーバー側で最大 5 分かかることがあるため、クライアントのタイムアウトには余裕を持たせています。長時間実行するバッチには、MCP ではなく非同期タスク APIを使用してください。

詳細情報

• インテグレーションガイド： cloro.dev/docs/integrations/mcp
• API リファレンス： cloro.dev/docs

ライセンス

MIT。LICENSEを参照してください。