zaDojo
すべてのドキュメント

zaDojo MCPサーバー：Claude、Cursor、Codexの設定

zaDojoのSEO・AI可視性MCPサーバーを、Claude、ChatGPT、Cursor、Codex、VS Code、Windsurf、Gemini CLIにOAuthかAPIキーで接続します。

zaDojoはリモートMCPサーバーを運営しており、リモートMCPに対応したクライアントなら何でも接続できます。MCP（Model Context Protocol）は、AIアプリが外部ツールを呼び出すための標準的な仕組みです。これを通じて、エージェントはキーワード調査、Googleのリアルタイム検索結果の読み取り、任意のドメインの順位と被リンクの調査、サイト監査、順位とAI回答の追跡、自社のSearch ConsoleとGoogle Analyticsのデータ読み取りができます。

サーバーのアドレスは次のとおりです。

https://app.zadojo.com/mcp

クライアントが初めて接続するとき、ブラウザでzaDojoのログインが開き、アクセスの承認を求められます。その後は、あなたが閲覧できるプロジェクトに対してツールを使えるようになります。CIジョブやブラウザのないサーバーではAPIキーを使ってください。

Claude CodeとCodexのユーザーは プラグイン を使うとより便利です。1回のインストールでこの接続と12のzaDojoスキルが追加されます。MCP接続だけが欲しい場合や、クライアントにプラグインがない場合は、このページの手順を使ってください。エージェントのセットアップガイドには、適切な方法を選んでくれるプロンプトがあります。

必要なもの

  • zaDojoアカウント。登録すると、カード不要で0.10ユーロ分の試用クレジットがもらえます。
  • HTTP経由のリモートMCPサーバーに対応したクライアント：Claude Code、Claude Desktop、Cursor、Codex CLI、ChatGPTデスクトップアプリのCodex、カスタム接続を使ったChatGPT、Copilot付きのVS Code、Windsurf（Devin Desktop）、Gemini CLI、Zedなど。
  • ログイン用のブラウザ、またはヘッドレスで使うためのAPIキー。

アプリ内のAgent setupページにも、コピーボタン付きで同じアドレスが表示されます。登録前にzaDojoのデータを試したい場合は、アカウント不要の無料SEOツールをお使いください。

クライアントを接続する

Claude Code

多くの方にはClaude Codeプラグインのほうがおすすめです。接続だけが必要なら、ターミナルで次を実行します。

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

--scope userを付けると、マシン上のすべてのプロジェクトでzaDojoを使えます。現在のリポジトリだけに限定するには--scope localを使います。その後、Claude CodeがzaDojoへのログインを求めます。確認画面が出ない場合は、/mcpを実行してzaDojoを選び、そこでログインを完了します。

Claude Desktop

Claudeの有料プランなら、zaDojoプラグインで接続とスキルをまとめて追加できます。Freeプランの場合や接続だけが必要な場合は、カスタムコネクタを追加します。

  1. Customize > Connectors を開きます。
  2. Add または + をクリックし、Add custom connector を選びます。
  3. https://app.zadojo.com/mcp を貼り付けます。
  4. zaDojoにログインしてアクセスを承認します。

カスタムコネクタはClaudeのFree、Pro、Max、Team、Enterpriseで使えます。Freeプランではカスタムコネクタは1つまでです。

Cursor

  1. Customize を開いてMCPサーバーに進むか、~/.cursor/mcp.jsonを直接編集します。
  2. zaDojoの項目を追加します。
{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}
  1. ファイルを保存し、Cursorに求められたらzaDojoのログインを承認します。

Cursorガイドには、ワンクリックのインストールリンクとスキルの導入方法があります。

Codex CLI

Codexプラグインなら接続とスキルをまとめて追加できます。接続だけの場合は次のとおりです。

codex mcp add zadojo --url https://app.zadojo.com/mcp

zaDojoのログインが開いたら承認します。開かない場合はcodex mcp login zadojoを実行します。

ChatGPTデスクトップアプリのCodex

Codexプラグインにはスキルも含まれます。接続だけの場合は次のとおりです。

  1. Codex を開き、Settings > MCP servers > Add server に進みます。
  2. 名前にzadojoと入力し、Streamable HTTP を選んで、https://app.zadojo.com/mcp を貼り付けます。
  3. 保存し、Codexに求められたら Restart をクリックします。
  4. zaDojoの横の Authenticate をクリックし、ログインを承認します。
  5. 新しいCodexチャットを開き、接続確認を行います。

この接続はCodexだけが対象です。Web版ChatGPTには別の接続が必要です。OpenAIの参考資料はCodex MCPのドキュメントです。

ChatGPT

zaDojoをOAuth付きのカスタムMCP接続として追加します。ChatGPTのFreeプランでも有料プランでも使えますが、ワークスペースの管理者がカスタム接続をブロックしている場合があります。各画面の手順はChatGPTガイドで説明しています。

VS Code、Windsurf、Gemini CLI

それぞれ専用のページに、正確な設定、APIキーの設定、スキルの導入方法があります。

その他のMCPクライアント

Streamable HTTPでリモートMCPサーバーに接続でき、OAuthログインに対応したクライアントなら、上記のアドレスを使えます。OAuthに対応していないクライアントでは、次に説明するようにヘッダーでAPIキーを送ります。

クライアント追加する場所設定
ZedSettings > AI > MCP Servers > Add Remote Server"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }
ClineMCP Servers > Remote Servers、または cline mcp add zadojo https://app.zadojo.com/mcp --transport http"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"
opencodeopencode.json"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }
Goosegoose configure > Add Extension > Remote Extension (Streamable HTTP)type: streamable_http, uri: https://app.zadojo.com/mcp
Kiro~/.kiro/settings/mcp.json"mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }
WarpSettings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL){ "zadojo": { "url": "https://app.zadojo.com/mcp" } }
JetBrains Junie~/.junie/mcp/mcp.json のあと /mcp > Authorize"zadojo": { "url": "https://app.zadojo.com/mcp" }

いずれのクライアントも、初回接続時にブラウザでzaDojoのログインを開きます。

APIキーで接続する

APIキーはブラウザでのログインの代わりになります。CIパイプライン、リモートサーバー、Hermesのようにログインの流れが使えないエージェント、OAuthに対応していないクライアントで使ってください。

キーはあなた個人に紐づきます。エージェントがキーを使って行う操作は、すべてあなたのアカウントとしてワークスペース内で実行されます。シークレットとして保管し、絶対にリポジトリにコミットしないでください。

作成するには、zaDojoアプリのSettingsを開き、API keys で Create API key をクリックします。キーは一度しか表示されないので、すぐにコピーしてください。キーはzadojo_で始まります。

Claude Code：

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor： mcp.jsonのzaDojoの項目にheadersブロックを追加します。

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI： キーを環境変数に入れ、Codexにそれを参照させます。

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

その他のクライアント： 各リクエストでAuthorization: Bearer zadojo_YOUR_KEYまたはx-api-key: zadojo_YOUR_KEYを送ります。

キーを無効にするには、同じ API keys セクションを開いて削除します。

接続を確認する

新しいチャットまたはセッションを開いて、次のように送ります。

zaDojoを使って接続を確認し、私のプロジェクトを一覧にしてください。

エージェントがwhoamiとlist_projectsを呼び出せば成功です。アカウント、残りのクレジット残高、プロジェクト（まだなければ空のリスト）が返ってきます。どちらのツールも無料です。エージェントがツールを呼ばずにMCPの説明を始めた場合、このセッションではサーバーが読み込まれていません。クライアントを再読み込みするか、新しいチャットを始めてください。

利用できるツール

サーバーには80以上のツールがあります。下の表では作業ごとにまとめています。ツール名はエージェントに見えるとおりです。

分野主なツールクレジット
アカウントとプロジェクトwhoami, list_projects, create_project, get_project_context, update_project_context無料
キーワード調査research_keywords（1から5個のシードからアイデアを出す）, get_keyword_metrics（最大700キーワードの検索ボリューム、難易度、検索意図、CPC、推移）, search_serp_locations有料（地域の検索を除く）
Googleの検索結果get_serp_results（1から10キーワードのリアルタイム自然検索結果）, find_serp_competitors有料
ドメイン調査get_domain_overview, get_ranked_keywords, get_domain_keyword_suggestions有料
被リンクget_backlinks_overview, get_backlinks_profile有料
保存済みキーワードlist_saved_keywords, save_keywords, remove_saved_keywords無料
順位計測create_rank_tracker, add_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker, get_rank_tracker, pin_rank_tracking_keywords, remove_rank_tracking_keywords確認は有料、設定と読み取りは無料
サイト監査run_site_audit, get_audit_status, get_audit_issues, get_audit_pages, list_site_audits, delete_site_auditLighthouseやJavaScriptレンダリングなしなら無料
ローカルSEOsearch_local_businesses, get_local_serp_results（マップまたはLocal Finder）, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories有料（カテゴリの検索を除く）
Google Search Consoleget_search_console_performance, get_search_console_insights（CTRの低いページ、カニバリゼーションしているクエリ、クリックの増減）, get_search_console_hourly（直近48時間）, get_search_console_sitemaps, inspect_urls（1回で最大10 URL）無料
Google Analyticsget_google_analytics_organic_overview, get_google_analytics_organic_landing_pages, get_google_analytics_page_performance, get_google_analytics_traffic_acquisition, get_google_analytics_key_events, get_google_analytics_ecommerce_performance, get_google_analytics_site_search, get_google_analytics_audience_breakdown, get_google_analytics_measurement_health, get_google_analytics_traffic_overview, get_google_analytics_breakdown, get_google_analytics_realtime_users, get_search_opportunities無料
AI可視性research_ai_visibility_prompts, explore_prompt, generate_ai_visibility_prompts, save_ai_visibility_tracker, estimate_ai_visibility_cost, set_ai_visibility_schedule, run_ai_visibility_check有料
AI可視性の結果get_ai_visibility_tracker, get_ai_visibility_run, get_ai_visibility_results, get_ai_visibility_answer, get_ai_visibility_sources, get_ai_visibility_trend, export_ai_visibility_data無料
レポートsave_report, list_reports, get_report, delete_report, set_report_sharing, list_report_templates, save_report_template, delete_report_template無料

知っておくと役立つ動作がいくつかあります。

  • プロジェクトコンテキスト は、プロジェクトの共有メモリです。事業の概要、現在の目標、ポジショニング、文章の好み、競合、主要ページ、調査ログが入ります。エージェントは作業前にこれを読み、アプリやほかのエージェントも同じ内容を参照します。
  • エージェントが保存した レポート はプロジェクトに表示され、チーム全員が閲覧、印刷、エクスポートできます。新しいレポートは非公開です。公開リンクは、エージェントにpublic: trueでset_report_sharingを呼ぶよう頼んだときだけ作成され、public: falseで無効になります。get_reportは、公開リンクがあればreport.shareUrlを、なければnullを返します。
  • Search ConsoleとGoogle Analytics のツールは、プロジェクトに接続済みのプロパティを読み取ります。アクセスは読み取り専用です。
  • 定期的な処理は まず見積もり です。順位計測とAI追跡にはどちらも見積もりツールがあるため、エージェントは確認をスケジュールする前に費用を示せます。

クレジットを使うもの

クレジットはzaDojo残高から使われます。1,000クレジットは1ユーロで、月額10ユーロのプランには10ユーロ分の利用料が含まれます。主な料金は次のとおりです。

操作目安の費用
キーワード調査の検索約0.07ユーロ
12か月分の履歴付きのドメインまたは被リンクの概要約0.10ユーロ
ローカルのマップまたはLocal Finderの確認約0.006ユーロ
1エンジンでのAIプロンプト確認1回約0.002ユーロ
1キーワードのPrompt Research約0.25ユーロ
100キーワードを1デバイスで毎週追跡月に約1から2ユーロ

無料のもの：アカウントの確認、プロジェクトコンテキスト、保存済みキーワード、レポート、Search Console、Google Analytics、通常のサイト監査、すでに集めた順位計測、監査、AI可視性の結果の読み取り。zaDojoに接続したエージェントは、2,000クレジット（約2ユーロ）を超える一括処理を予定するときは事前にあなたに確認するよう指示されています。残高が0になると、チャージするまで有料ツールは止まります。見積もりツールは料金にあります。

接続したら

接続はエージェントにデータを与えます。スキルは、そのデータで何をするかを手順ごとにエージェントに伝えます。プラグインなしでMCPを使った場合は、次にスキルを導入してください。

「SEOをやって」と頼むより、具体的な作業を1つ任せましょう。

  • SEO Project Setup：目標、ポジショニング、競合、主要ページを保存し、以降のすべての作業の出発点にします。
  • SEO Coach：SEOが初めてなら、おすすめの次の一手を1つ聞けます。
  • SEO Audit：流入を最も伸ばしそうな、少数の変更を見つけます。
  • Keyword ResearchとKeyword Clustering：狙う価値のある検索語を見つけ、ページ単位にまとめます。
  • Competitive LandscapeとCompetitor Analysis：市場を俯瞰するか、1社の競合を深く調べます。
  • Link Prospecting：ページにリンクしてくれそうなサイトを見つけ、アウトリーチ文案を作ります。
  • AI Prompt ResearchとAI Visibility Audit：AIツールがあなたの市場について何と言い、なぜ競合が言及されるのかを確認します。

AI回答の追跡に使うエンジン、対象範囲、費用はAI可視性ガイドで説明しています。

トラブルシューティング

クライアントが接続できない。 アドレスがhttps://付きで末尾に空白のないhttps://app.zadojo.com/mcpになっているか確認してください。

CodexがAuthorization server response missing required issuer: expected https://app.zadojo.comと表示する。 Codex 0.143から0.146は、OAuthの途中でissuerを落としてしまいます。Codex CLIまたはCodexデスクトップアプリを0.147.0以降に更新するか、APIキーを使ってください。

ログインに失敗する、またはすぐ期限切れになる。 クライアントからzaDojoサーバーを削除し、もう一度追加してログインをやり直します。

エージェントがプロジェクトを見つけられない。 まずlist_projectsを呼ぶよう頼み、返ってきたプロジェクトIDを以降の呼び出しで使わせます。プロジェクトがなければ、create_projectでドメインのプロジェクトを作るよう頼みます。これは無料です。

有料ツールがクレジット不足と表示する。 有料プランなら、アプリの請求画面からチャージを購入するか、毎月のクレジットがリセットされるのを待ちます。試用中なら、有料ツールを使い続けるために登録してください。

それでも解決しない場合は、クライアント名とバージョン、正確なエラーを添えてhello@zadojo.comまでメールでご連絡ください。APIキーは絶対に含めないでください。