MCP 経由で XOVI を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → XOVI をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

XOVI + Gemini

XOVI Suite の SEO データ（読み取り専用）：API クレジット残高、任意のドメインの可視性指数（OVI）の推移、ランキングキーワード、ランキング価値、キーワード履歴、そしてプロジェクトの日次キーワード監視。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

XOVI_API_KEY

ステップ 1 — 認証情報を取得

設定は約 2 分で終わります。XOVI API を使うには、XOVI の Pro、Business、Enterprise のいずれかのアカウントが必要です。

1. XOVI Suite で Account > API Dashboard を開き、個人用の API キーを作成します。
2. キーを XOVI_API_KEY に貼り付けます。コネクターは https://suite.xovi.net/api への呼び出しのたびに、これを key パラメーターとして送信します。
3. コネクターをインストールし、クレジットを消費しない xovi_get_credit_state を実行してキーを確認します。

読み取る内容：アカウントの API クレジット残高と利用上限。任意のドメインの週次ドメイン分析：可視性指数（OVI）の推移、ドメインや URL が順位を持つキーワード（順位、検索ボリューム、CPC、競合度）、ランキング価値、順位の推移、1 つのキーワードの順位履歴、キーワードの検索結果ページ。そしてプロジェクトの日次キーワード監視：競合を含むプロジェクト、ラベル、監視中のドメイン、最新順位付きの監視キーワード、キーワードの日次履歴、ある日の監視キーワードの上位 100 件、プロジェクトドメインの監視 OVI。

クレジット：ほとんどの呼び出しは、アカウントの API クレジット予算から 1 回ごと、または行のブロックごとに支払われます（XOVI リファレンスの各機能を参照）。自分のアカウントデータを読むだけの呼び出しは無料です。大きなエクスポートの前に AI は xovi_get_credit_state と xovi_get_limits で残高を確認し、limit を小さく保ち、あなたの了承なしに多数のドメインを繰り返し処理しません。監視キーワードの枠は別にカウントされます：xovi_get_monitoring_keyword_limits。

週次ドメイン分析：AI は xovi_list_search_engines（週次、例：google.de）で検索エンジンのホストを選び、可視性の推移には xovi_get_ovi_trend、ドメインが順位を持つキーワードには xovi_list_ranking_keywords、さらに xovi_get_ranking_value、xovi_get_ranking_trend、1 つのキーワードには xovi_get_keyword_trend、キーワードの検索結果ページには xovi_get_keyword_serp を使います。urlpattern にはホスト（www.example.com）、すべてのサブドメイン（example.com/*）、ディレクトリ（www.example.com/blog/*）を指定できます。1 週間分のデータは日曜日に公開され、date はその日曜日です。

日次監視：xovi_list_projects でプロジェクトハッシュ、xovi_list_labels でラベル、インターバル daily の xovi_list_search_engines で数値の sengineid を取得します。そのうえで AI は xovi_list_monitoring_domains、xovi_list_monitoring_keywords、xovi_get_monitoring_keyword_trend、xovi_get_monitoring_serp、xovi_get_monitoring_ovi_trend を使います。

読み取り専用：17 個のツールはすべて読み取りのみです。XOVI のプロジェクトでは何も変わらないため、確認することはなく、インストール時にオフになっているツールもありません。

ページ送り：limit は最大 1000 行です。skip は limit 行単位のページ数を数えるため、limit 100 で skip 1 なら 101〜200 行目が返ります。結果には絞り込み前の総数 resultCount が含まれます。

よくあるエラー：XOVI は HTTP 200 で apiErrorCode と apiErrorMessage を返し、コネクターはそれをエラーに変換します。key の param invalid は API キーが間違っているか削除されたこと、no permission はキーまたはプランでその機能を使えないこと、cost error は次の補充までクレジット予算を使い切ったことを示します。ほかの項目の param missing や param invalid は、修正すべき項目を示します。result empty はデータのない成功した呼び出しです（たとえば順位のないドメイン）。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が XOVI のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「google.de における example.de の可視性指数は、過去 12 か月でどう推移しましたか。」
• 「www.example.de/blog/ が 1 ページ目に表示されているキーワードを、検索ボリュームと CPC とともに教えてください。」*
• 「最新の週について、example.de と competitor.de のランキング価値を比較してください。」
• 「プロジェクトの監視キーワードのうち、昨日から 3 位以上順位を落としたものはどれですか。」
• 「API クレジットはあとどれくらい残っていて、最後の補充はいつでしたか。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続