チャットウィンドウにスクリーンショットをコピー＆ペーストするのは、GEOデータを扱うには非効率的な方法です。Model Context Protocol (MCP)を使用すれば、そのステップを省略できます。AIエージェントがライブデータソースに直接接続し、必要な数値をオンデマンドで取得します。このガイドでは、GEOlyのGEO MCPサーバーをClaude、Cursor、Codex、Claude Codeに接続する方法を説明します。これにより、「現在『エンタープライズCRM』で私のブランドの可視性はどのくらいか？」といった質問をエディター内で行い、ダッシュボードのタブを切り替えることなくリアルな回答を得ることができます。
このガイドを終える頃には、OAuthまたは読み取り専用トークンを使用してMCPを接続し、どのツールを使用すべきかを理解し、GEOly CLIを通じてターミナルやCI作業に同じツールセットを適用する方法を学べます。
主なポイント
- MCPはオープンスタンダードであり、AIクライアント（Claude、Cursor、Codex、Claude Codeなど）が外部ツールを直接呼び出せるようにします。これにより、エージェントは古いエクスポートデータではなく、ライブのGEOデータを読み取ることができます。 - GEOlyは、`app.geoly.ai/api/mcp`で最大62のツールを提供するGEO MCPサーバーを提供しています。このサーバーは、2つのデータプレーン（自社ブランド用データ：KPI、プロンプト、引用、競合分析、監査、GA4などと、業界公開データ：ブランドランキング、カテゴリのホワイトスペース、Share of Card、引用元など）をサポートしています。 - OAuthブラウザ認証または読み取り専用APIトークンのいずれかを使用して、1行の設定で接続できます。 - 同じツールはGEOly CLIを通じてターミナルでも利用可能です。これにより、Claude Code、Codex、n8n、またはCIパイプライン内のエージェントが同一の数値をゼロドリフトで取得できます。 - MCPツールはGrowプランから利用可能です。新規アカウントにはapp.geoly.aiで3日間の無料トライアルが付与されます。
ステップ1: GEOにおけるMCPの利点を理解する
MCPは、AIアプリのためのUSB-Cポートとよく例えられます。これは、モデルが定義されたツールセットを通じて外部サーバーと安全かつ予測可能に通信できるようにするオープンスタンダードです。レポートを取得して貼り付ける代わりに、エージェントがツールを呼び出し、構造化されたJSONを受け取り、それを基に推論を行います。
GEO作業において、これには3つの実用的な利点があります。エージェントが週遅れのCSVではなく、ライブの可視性データを読み取ることができること。ランディングページを編集している間に、ターゲットクエリの現在のAIGVRを確認できること。そして、無人でページを監査したり、スケジュールに基づいて競合の動きを取得したりできることです。
GEOlyは1つのサーバーを通じて2つのデータプレーンを提供します。自社ブランド用プレーンでは、KPI、プロンプトレベルの可視性、引用、競合、GEO監査、GA4アトリビューション、さらにプロンプトやトピック、競合の作成やモニタリング実行などの書き込みアクションをカバーします。業界公開プレーンでは、カテゴリランキング、ホワイトスペース、ブランドの勢い、Share of Card、AI検索需要、ブランド比較、引用元を設定なしでクエリできます。
注意点: MCPツールのアクセスはGrowプランから開始されます。無料トライアルでは接続して探索できますが、スクリプトで使用するツールがプランに含まれていることを確認してください。
ステップ2: GEOlyの認証情報を取得する
app.geoly.aiにサインインしてください（新規の場合は3日間の無料トライアルを開始してください）。GEOlyのMCPサーバーは2つの認証モードをサポートしており、どちらを選ぶかはクライアントによります。
Claude DesktopやCursorのようなインタラクティブなデスクトップクライアントの場合、OAuthブラウザ認証が最も簡潔です。クライアントがブラウザを開き、アクセスを承認するだけで、秘密情報が設定ファイルに保存されることはありません。ヘッドレスまたはターミナルで使用する場合は、アカウント設定で読み取り専用APIトークンを生成し、ヘッダーまたは環境変数として渡します。
注意点: 読み取り専用トークンはパスワードのように扱ってください。コミットされた設定からは除外し、漏洩した場合はすぐにローテーションしてください。読み取り専用トークンはエージェントが書き込みを行えないことを意味し、CIではこれが理想的です。
ステップ3: ClaudeとCursorでサーバーを接続する
Claude DesktopはローカルMCP使用のリファレンスクライアントです。MCP設定にGEOlyサーバーを`app.geoly.ai/api/mcp`として追加し、アプリを再起動して接続を読み込ませます。最初の呼び出し時にOAuthフローがトリガーされます。ブラウザで承認するとツールが表示されます。
Cursorも同じパターンでMCP設定からサーバーエントリを追加します。同じエンドポイントとOAuthまたはトークンを使用します。一度接続されると、Cursorのエージェントはコードを書きながらGEOlyツールを呼び出すことができ、「トップ3の競合他社のShare of Modelを確認し、このページの比較表を調整して」といったプロンプトをエンドツーエンドで実行できます。
CodexとClaude Codeも、それぞれのMCP設定を通じて同じリモートエンドポイントに接続します。すべてのクライアントが同一のサーバーにアクセスするため、ツール名やメトリックの定義はどこでも同じです。
注意点: ツールが表示されない場合、一般的な原因はエンドポイントのタイプミス、アプリが完全に再起動されていない、またはトークンに末尾のスペースが含まれていることです。クライアントを再起動し、サーバーが接続されていることを確認してから、さらにデバッグを行ってください。
ステップ4: 質問に適したツールを呼び出す
サーバーがライブになったら、リクエストを平易な言葉で表現し、エージェントにツールをマッピングさせます。プロンプトのセットに対するAIGVRやShare of Modelを尋ねると、自社ブランドのKPIを取得します。ChatGPTがカテゴリに対して引用するドメインを尋ねると、業界プレーンの引用元ツールを使用します。新しいモニタリングプロンプトを追加するよう依頼すると、書き込みアクションを使用します。
良い作業パターン: セッションを開始する際、エージェントに組織とブランドIDを発見させ、それ以降の呼び出しをそれにスコープするようにします。これにより、アカウントに複数のブランドが含まれている場合でも曖昧な結果を回避できます。
サーバー、ツールカタログ、エージェントプロンプトの詳細なツアーについては、[GEOly GEO MCPサーバーのClaude Code、Cursor、Codex用ガイド](/blog/geo-mcp-server-ai-visibility-claude-code-cursor-codex)を参照してください。
ステップ5: GEOly CLIを使用してターミナルで同じツールを利用する
GEOly CLIは、リモートMCPサーバーをシェルに投影したものです。1行のcurlまたはPowerShellコマンドでインストールできる依存関係のない単一バイナリで、標準出力にクリーンなJSONを出力し、分岐可能な終了コードを返します。これにより、チャットUIではなくスクリプトを使用したいClaude Code、Codex、n8n、CIパイプラインに最適です。
CLIとMCPはサーバー上で1つのツールソースを共有しているため、サーバー側でツールを追加する際にCLIのリリースは不要で、メトリクス定義が両者間でずれることはありません。ダウンロードしてドキュメントをwww.geoly.ai/open/cliでご覧ください。
注意: CLIの出力を`jq`にパイプし、スクリプト内で終了コードを確認してください。これにより、失敗した呼び出しが空データを静かに返すのではなく、パイプラインを明確に失敗させます。
動作を確認する方法
1回の読み取り呼び出しと1回のスコープ付き呼び出しを実行してください。まず、エージェントにアカウントのブランドを尋ねます。正しく設定されていれば、ブランドリストが返されます。その後、特定の既知のプロンプトに対してAIGVRを要求し、同じ期間のGEOlyダッシュボードに表示される数値と一致することを確認してください。両方が一致すれば、接続、認証、メトリクススコープ設定が正しいことを意味します。
FAQ
GEOly MCPサーバーはいくつのツールを公開していますか？最大62個で、自社ブランドデータと業界公開データレイヤーに分かれています。
MCPを使用するのに料金はかかりますか？MCPツールはGrowプランから利用可能です。無料の3日間トライアルで接続し、試用することができます。
どのクライアントがサポートされていますか？Claude Desktop、Cursor、Codex、Claude Codeを含むすべてのMCP対応クライアント、さらにGEOly CLIを通じたターミナルおよびCIワークフローがサポートされています。
OAuthとトークン、どちらを使用すべきですか？インタラクティブなデスクトップクライアントにはOAuthを使用して秘密情報を保存しないようにし、ヘッドレス、ターミナル、CI用途には読み取り専用トークンを使用してください。
GEOlyとは具体的に何ですか？業界インテリジェンスを中心に構築されたGEOデータプラットフォームです。ChatGPT、Gemini、Google AI全体であらゆるブランドやカテゴリを追跡し、そのデータをエージェントに提供します。[GEOly AIとは](/blog/what-is-geoly-ai)や[GEOly AIのガイド](/blog/author/geoly-ai)をご覧ください。
