AIエージェントの設定:zaDojo接続とスキル追加
Claude Code、Codex、Claude Cowork、Hermesなどのエージェントを1つのプロンプトでzaDojoに接続し、動作を確認して、SEOスキルを最新に保ちます。
AIエージェントには、zaDojoから2つのものが必要です。MCP接続 は、https://app.zadojo.com/mcpでzaDojoのツールを呼び出し、リアルタイムのSEOデータを得るためのものです。スキル はSKILL.mdファイルで、監査やキーワード調査といった作業を最初から最後までどう進めるかをエージェントに伝えます。両方をいちばん早く用意するには、下のセットアッププロンプトをエージェントに貼り付けて、インストールを任せてください。
ChatGPTをお使いの場合は、代わりにChatGPTガイドをご覧ください。通常のChatGPTチャットは何もインストールできないため、このプロンプトでは手動の手順が表示されるだけです。カスタム接続はChatGPTのFreeプランでも有料プランでも使えます。
必要なもの
- zaDojoアカウント。登録すると、カード不要で0.10ユーロ分の試用クレジットがもらえます。セットアップ中にログインページが開いたときに作成しても構いません。
- リモートMCPサーバーに接続できるエージェント:Claude Code、Claude Cowork、Codex(CLIまたはChatGPTデスクトップアプリ)、Hermes、Grok Bot、Cursorなど。
- zaDojoのログインを承認できるブラウザ。ブラウザのないヘッドレスなエージェントでは、代わりにAPIキーを使います。
エージェントを設定する
- 下のプロンプトをコピーします。zaDojoアプリ内のAgent setupからもコピーできます。また、エージェントに
https://zadojo.com/agent-setup.txtのテキスト版を読ませることもできます。 - エージェントの新しいチャットまたはセッションに貼り付けます。
- エージェントは自分がどのクライアントかを判断し、既存のzaDojo接続を確認して、プラグインがあればそれをインストールします。プラグインがない場合は、MCPサーバーと公開スキルを別々に追加します。
- ブラウザでzaDojoのログインが開いたら、ログインしてアクセスを承認します。
- エージェントが、再読み込み、再起動、自分では操作できない場所のクリックを頼んできたら、その手順を行ってください。何をすればよいかは具体的に伝えてくれます。
Set up zaDojo in this agent. Do what you can; guide me through anything that needs my input.
## 1. Check this agent
- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing zaDojo connection. Preserve other integrations and avoid duplicates.
- Check for zaDojo skills separately. A connection without skills is incomplete.
## 2. If this is ChatGPT
If I pasted this into a regular ChatGPT conversation (web or desktop app, not Codex), you cannot install zaDojo from here. Don't run commands or edit files. Instead, give me these steps and stop:
1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. This works on Free and paid plans; no upgrade is needed.
2. Open **Settings → Plugins → Developer mode** (or **Plugins → + → Create MCP App**). Name it zaDojo, enter the server URL `https://app.zadojo.com/mcp` in full, including `https://` (otherwise ChatGPT reports "Unsafe URL"), and keep **OAuth** selected.
3. Create it, sign in to zaDojo, and approve the connection.
4. Start a new chat, select zaDojo from the **+** menu, and send: "Use zaDojo to check my connection and list my projects."
Link the [ChatGPT setup guide](https://zadojo.com/docs/chatgpt) for screenshots and troubleshooting. If I'm in Codex, continue below.
## 3. Install the plugin first
The official plugin bundles MCP + SEO skills, with zaDojo namespacing and shared updates.
- **Codex:** follow the [plugin guide](https://zadojo.com/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://zadojo.com/docs/claude-code-plugin).
- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/zadojo/seo-geo-mcp`, and install **zaDojo**. Then I start a new task and type `/` to check that zaDojo skills appear. If I already have a custom zaDojo connector, have me remove it once the plugin signs in. Plugins need a paid Claude plan. If I'm on Claude Free, have me add `https://app.zadojo.com/mcp` under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://zadojo.com/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.
## 4. Fall back to MCP + skills
If the plugin is unsupported:
- Add `https://app.zadojo.com/mcp` using the [MCP guide](https://zadojo.com/docs/mcp).
- Install the [public SEO skills](https://zadojo.com/docs/skills/setup) for this agent only.
- Do not copy internal repository skills or duplicate bundled skills.
- If skills are unsupported, use MCP alone and link to the workflow guides.
## 5. Sign in
- Prefer OAuth and let me approve login in my browser. If this client cannot use OAuth, send me to `https://app.zadojo.com/settings` → API keys. Have me enter the key in the client's secret settings or environment, never chat or a repository.
- **Manual setup needed?** Use this agent’s current documentation and give only the steps I need to do myself.
## 6. Reload and verify
- Use the current agent’s native reload flow, checking its installed version, help, or official documentation. Prefer automatic discovery or an in-place reload; restart only if required to load the new tools and skills.
- Once tools load in this session, run whoami and list_projects (free reads). Check skill discovery too. If a reload needs my action, give the instructions rather than repeatedly retrying unavailable tools.
- Track installation, sign-in, and verification separately. A connected server is not proof that this session can use its tools. Never claim verification before the free reads succeed.
- Do not create projects or run paid research during installation.
## 7. Finish with a short handoff
Keep progress updates brief. The final reply must be **140 words or fewer** and follow this template:
**Status**
[Briefly say what succeeded or what blocked setup.]
**Next**
1. `[Give the native reload command or UI action for this agent, only if needed.]` Then say “Check that zaDojo is connected.” Approve sign-in if prompted.
2. Try one of these:
- `[SEO Audit invocation]` **(recommended)**: find your website's biggest SEO issues.
- `[SEO Project Setup invocation]`: interview you about your website and set up its project context.
- `[Keyword Research invocation]`: find keywords worth targeting.
- `[Local SEO invocation]`: review your Google Business Profile and local competitors.
Want to know what was set up? Just ask.
Adapt the template to the actual result:
- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.最後に、エージェントは短い状況報告と、最初に試す作業の提案をいくつか示します。セットアップ中にプロジェクトを作ったり、有料の調査を実行したりはしません。
エージェント別の手動セットアップ
プロンプトでインストールが完了していれば、このセクションは読み飛ばしてください。以下の各項目は、同じ作業を手動で行う方法です。
| エージェント | インストールされるもの | 詳しいガイド |
|---|---|---|
| Claude Code | プラグイン(MCP接続と12のスキル) | Claude Codeプラグイン |
| Claude CoworkまたはClaudeデスクトップ | Customizeメニューから追加するプラグイン | Coworkの手順 |
| Codex CLI | プラグイン(MCP接続と12のスキル) | Codexプラグイン |
| ChatGPTデスクトップアプリのCodex | セットアッププロンプトまたはプラグイン | Codexデスクトップの手順 |
| ChatGPTのWebまたはデスクトップのチャット | カスタムMCP接続(ツールのみ) | ChatGPTガイド |
| Cursorやその他のMCPクライアント | MCP接続のあと、スキルを別途追加 | MCPのセットアップ |
Claude Code
Claude Codeのセッション内で、マーケットプレイスを追加してプラグインをインストールします。
/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojoClaude Codeがプラグインの有効化を求めたら、/reload-pluginsを実行します。zaDojoのログインを承認したら、/zadojo:seo-coachと入力してスキルが読み込まれたか確認します。スコープ、更新、対処法はClaude Codeプラグインガイドで説明しています。
Claude Cowork
Coworkのプラグインはメニューから追加するため、この部分はエージェントには任せられません。Customize > Plugins > Add marketplace > Add from a repository に進み、https://github.com/zadojo/seo-geo-mcp を入力して、zaDojoをインストールします。Claudeの有料プランが必要です。Freeプランでの代替手段はCoworkの手順で説明しています。
ChatGPTデスクトップアプリのCodex
- Codex を開き、新しいチャットを始めます。
- このページのセットアッププロンプトを貼り付けます。
- zaDojoのログインが表示されたら承認します。
- Codexがツールはまだ読み込まれていないと言う場合は、もう一度新しいチャットを始めます。
手動でインストールするには、Codexデスクトップの手順に従ってください。どのChatGPTプランにCodexが含まれるかはOpenAIが決めているため、OpenAIのプランページで確認してください。Codexの接続はchatgpt.comとは別で、通常のChatGPTチャットからは見えません。
Codex CLI
ターミナルから次を実行します。
codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojoプラグインが表示されない場合は、Codexを再読み込みするか再起動します。そのあとログインします。
codex mcp login zadojoSEO Coachを使ってすべて動くか確認するよう、Codexに頼んでください。表示される可能性のあるエラーメッセージはCodexプラグインガイドにまとめています。デスクトップのプラグインディレクトリからインストールした場合は、そのディレクトリでプラグインを管理します。
Hermes
セットアッププロンプトを貼り付けてMCPサーバーを接続します。スキルはHermesのスキルハブから入れます。SEO Coachを追加するには次のとおりです。
hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coach追加したいzaDojoスキルごとに、フォルダ名を変えて同じコマンドを実行します(例:seo-audit、keyword-research)。Hermesは各スキルの入手元を記録し、あとで更新を確認できるようにします。Hermes自身のドキュメントはHermes skill managementにあります。
Grok Bot
セットアッププロンプトをBotに貼り付け、Botから返された手順を行います。パッケージ化されたスキルとコネクタは、サイドバーの Marketplace にあります。非公開のスキルは Your plugins > Manage plugins and skills > Private skills にあり、アカウント内のすべてのBotで使えます。xAIの参考資料はGrok Bot skillsをご覧ください。
Web版Claudeとその他のエージェント
MCPのセットアップガイドでサーバーを接続します。そのあと、エージェントが対応しているスキル管理機能でスキルを追加します。Claudeでは、カスタムスキルは Customize > Skills で管理します。Claudeの有料プランなら、zaDojoプラグインで接続とスキルをまとめて追加できます。
skills CLIに対応したエージェントでは、一覧からzaDojoのスキルを選べます。
npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills現在のエージェントと、好みのインストール範囲を選びます。プラグインにはすでにスキルが含まれているため、プラグインの上からこれを実行しないでください。ほかの方法はスキルの手動セットアップで説明しています。
うまくいったか確認する
新しいチャットを始めて、次のように送ります。
zaDojoを使って接続を確認し、私のプロジェクトを一覧にしてください。正しく設定されていれば、zaDojoのツールが呼ばれ、アカウントとプロジェクトの一覧が返ってきます。空のリストでも合格です。まだプロジェクトを作っていないという意味です。この確認はデータを読むだけで、クレジットは使いません。
続けてスキルを確認します。Claude Codeでは/zadojo:と入力し、12のスキル名を探します。Codexでは$と入力します。ほかのエージェントでは「どのzaDojoスキルが見えますか?」と聞きます。スキルがないまま接続だけ動いている状態は、設定が半分しか終わっていません。
両方の確認に合格したら、エージェントに SEO Coach の実行を頼みましょう。プロジェクトの現状を見て、次の一手を1つ提案します。
スキルを更新する
スキルは随時改善されますが、エージェント内のコピーは自動では更新されません。MCP接続を更新しても、更新されるのはツールの一覧で、スキルファイルではありません。
ChatGPTのユーザーは、代わりにChatGPTの更新手順に従ってください。ChatGPTのカスタム接続には、更新すべきスキルファイルがありません。
いちばん簡単なのは、zaDojoを使っているエージェントにこのプロンプトを貼り付けることです。スキルがどう導入されたかを調べて同じ場所で更新し、ログイン状態とスキルファイルへの自分の編集は残します。
Update my installed zaDojo skills using https://zadojo.com/docs/agent-setup#update-your-skills.
If this is ChatGPT on the web or a regular desktop chat, use https://zadojo.com/docs/chatgpt#update-zadojo. For a public directory plugin, start a new chat to load the available tools and skills; reconnect only if sign-in needs attention. For a custom MCP connection, select Refresh in its details, then start a new chat. Refreshing a custom connection updates tools, not skill files. Do not run local Codex commands to update ChatGPT web.
Identify this agent and how zaDojo was installed. Use the matching plugin or skills installer, checking the installed client's help before running commands. Update only zaDojo in its existing scope. Preserve my MCP endpoint, sign-in, and personal skill edits; ask before replacing conflicting edits. Avoid duplicate skills and do not install internal repository skills.
If the skills were copied manually, compare them with https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills and update the installed public skill folders, including their supporting files. For Grok Bot or another agent without a verified update command, use its supported skill management flow or give me the exact manual steps available in this version.
Reload skills if supported. If I need to reload or start a new session, tell me what to do. Verify the updated skill files and that this agent can discover them; an active MCP connection alone does not prove the skills updated. Briefly tell me what changed and anything left to do. Do not run SEO research during the update.導入方法ごとの手動の更新手順は次のとおりです。
Claude Codeプラグインを更新する
/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-plugins手作業をやめるには、/pluginを開いて Marketplaces に進み、zadojo を選んで Enable auto-update を選びます。Anthropicが運営していないマーケットプレイスでは、自動更新は最初オフになっています。Claude Codeが更新待ちを知らせたら、/reload-pluginsを実行します。この設定はAnthropicのconfigure auto-updatesで説明されています。
Codex CLIプラグインを更新する
codex plugin marketplace upgrade zadojo新しいバージョンのスキルが表示されない場合は、Codexを再起動するか再読み込みします。Codexのプラグインコマンドはリリースごとに変わってきたため、このコマンドが拒否されたらcodex plugin --helpを実行して、お使いのバージョンで使えるものを確認してください。マーケットプレイスについてはOpenAIのプラグインのドキュメントで説明されています。
Hermesハブのスキルを更新する
どのスキルに更新があるかHermesに確認し、zaDojoのスキルを名前で更新します。
hermes skills check
hermes skills update seo-coach導入したzaDojoスキルごとに更新の行を繰り返します。ローカルでスキルを編集していた場合、Hermesは初期設定ではそのスキルに手を付けません。まず自分の編集内容を確認し、失っても構わない場合にだけ--forceを付けてください。詳細はHermes update lifecycleにあります。
skills CLIで入れたスキルを更新する
npx skills list
npx skills update seo-coach seo-audit実際に導入したスキル名に置き換えてください。導入したときと同じ範囲を指定します(グローバルなスキルは-g、プロジェクトのスキルは-p)。更新前に、自分で加えた編集はコピーを保存しておきます。導入後に追加された新しいスキルはupdateでは入らないため、インストールコマンドをもう一度実行して選んでください。すべてのオプションはskills CLIのドキュメントにあります。
Grok Botや手動コピーしたスキルを更新する
Grok Botでは、更新プロンプトを貼り付けるか、Marketplace > Your plugins > Manage plugins and skills を開いてzaDojoの項目を更新します。xAIはスキル用の更新コマンドを別に公開していないため、お使いのバージョンに表示される操作を使ってください。
スキルのフォルダを手動でコピーした場合は、現在のスキルフォルダと比べます。SKILL.mdと並んでいるファイルも含めてフォルダごと置き換え、自分の編集は引き継いでください。Claudeの Customize > Skills でアップロードしたスキルは、同じ場所で置き換えます。
終わったらスキルを再読み込みするか新しいセッションを開き、更新されたzaDojoスキルが見えるかエージェントに確認してもらいます。
トラブルシューティング
| 問題 | 対処法 |
|---|---|
| エージェントがMCPを説明するだけでzaDojoのツールを呼ばない | このセッションでは接続が読み込まれていません。エージェントを再読み込みまたは再起動し、新しいチャットで確認の依頼をもう一度送ります。 |
| ログインページが開かない | エージェントのポップアップを許可し、MCPまたはコネクタの設定からログインをやり直します。ヘッドレスなエージェントはAPIキーを使えます。 |
| ツールは動くがスキルが表示されない | スキルなしでMCP接続だけを追加しています。プラグインを入れるか、エージェントのスキル管理機能でスキルを追加します。 |
| zaDojoの項目が2つ表示される | プラグインを残し、余分なカスタムコネクタかMCPの項目を削除して、接続を1つにします。 |
Codexのpluginコマンドが拒否される | codex plugin --helpを実行します。サブコマンド名はCodexのリリースによって異なります。 |
| 更新できたか分からない | 新しいセッションを始めて、見えるzaDojoスキルの一覧をエージェントに出してもらいます。 |
それ以外の問題は、エージェント名とバージョン、失敗した手順、正確なエラー文を添えてhello@zadojo.comまでメールでご連絡ください。パスワード、APIキー、ログインコードは絶対に送らないでください。
クレジットを使うもの
セットアップ、ログイン、接続確認、スキルの更新は無料です。SEO Coachも、調査の実行を頼まない限り無料です。クレジットが使われるのはエージェントが有料データを取得するときだけで、1,000クレジットは1ユーロです。主な料金は次のとおりです。
- キーワード調査の検索:約0.07ユーロ。
- 1年分の履歴付きのドメインまたは被リンクの概要:約0.10ユーロ。
- 1キーワードのPrompt Research:約0.25ユーロ。
Search ConsoleとGoogle Analyticsの読み取り、プロジェクトコンテキスト、保存済みキーワード、レポート、通常のサイト監査は無料です。プランは月額10ユーロで、毎月10ユーロ分の利用料が含まれます。全一覧と費用の見積もりツールは料金をご覧ください。