# Kafkaiオンボーディング：AIエージェント向けの手順書

このページはAIエージェント向けに書かれています。Claude、ChatGPTなど、ご利用のMCPクライアントに次の1行を貼り付けます。

> Kafkaiのお客様が、このリンクをエージェントに貼り付けました。エージェントの役割は、未接続の状態から、データの入った最初のプロジェクトができるまでを案内することです。質問は1回に1つだけにします。お客様が書いた言語で返答します。
> `https://kafkai.com/ja/docs/onboarding.md を読んで、Kafkaiのセットアップを進めてください。`


## ステージ1：このクライアントにKafkaiを接続する

最初に、名前が `kafkai_` で始まるツールを利用できるかを確認します。利用できる場合は、ステージ2に進みます。

利用できない場合は、お客様がクライアントの設定画面で接続を追加します。Claude Codeを除き、エージェントが代わりに追加することはできません。利用中のクライアントを尋ね、そのクライアントの手順だけを伝えます。サーバーURLは、どのクライアントでも `https://kafkai.com/mcp` です。

- **claude.ai・Claude Desktop**：**設定**→**カスタマイズ**→**コネクタ**→**追加**。名前とサーバーURLを入力し、検出された認証の設定は変更せずに**追加**を選択します。続けて**連携**を選択し、Kafkaiの画面で**許可**を選択します。詳しい手順：https://kafkai.com/ja/docs/connect-claude/
- **Claude Code**：`claude mcp add --transport http kafkai https://kafkai.com/mcp` を実行します（お客様の同意があれば、エージェントが実行してもかまいません）。その後、お客様が `claude` を再起動し、`/mcp` を実行してサインインします。claude.aiのアカウントでClaude Codeにサインインしている場合は、claude.aiに追加したコネクタが自動で読み込まれます。
- **ChatGPT**：カスタムプラグインを利用できるプランが必要です。**設定**→**セキュリティ**で**開発者モード**を有効にします。次に**プラグイン**→**＋**を選択し、名前「Kafkai」とサーバーURLを入力して、認証に**OAuth**を選択し、**作成する**を選択します。Kafkaiにサインインして**許可**を選択します。チャットでは、ツールメニューからプラグインを有効にします。詳しい手順：https://kafkai.com/ja/docs/connect-chatgpt/
- **Hermes・その他のクライアント**：お客様が https://kafkai.com/ja/accounts/api-tokens/ でAPIトークンを作成し、サーバーURLとトークンをクライアントの設定ファイルに記述します。設定例：https://kafkai.com/ja/docs/connect-hermes/

画面の表示が手順と異なる場合は、スクリーンショット付きの詳しい手順を案内します。

接続を追加できたら、新しい会話を開始して同じ1行をもう一度貼り付けるよう、お客様に伝えます。ここで終了します。

## ステージ2：最初のプロジェクトを作成する

ここからは、エージェントがKafkaiのツールを使って進めます。各ツールの応答には `next_step_suggestion` フィールドが含まれます。その内容に従います。

1. `kafkai_get_credit_balance` を呼び出します（無料）。続けて `kafkai_list_projects` を呼び出します（無料）。プロジェクトがすでにある場合は、そのプロジェクトを使うかを尋ね、手順6に進みます。
2. 対象サイトのURL、サイトが対象とする国、競合サイトを、この順に尋ねます。競合サイトは省略でき、あとから追加できます。国は推測しないでください。プロジェクトは1つの国の検索結果に固定されます。
3. 料金は `kafkai_create_project` の説明に記載されています。対象サイトの分と、競合サイト1件ごとの分の合計です。合計のクレジット数をお客様に伝え、残高と比較します。残高が不足する場合は https://kafkai.com/ja/pricing/ を案内して終了します。
4. お客様の同意を得てから、`kafkai_create_project` を呼び出します。調査はバックグラウンドで実行され、数分かかります。
5. 調査の実行中に、次の2点を進めます。
   - 競合サイトの指定がなかった場合は、`kafkai_find_competitors` を提案します。呼び出す前に、消費するクレジット数を伝えます。
   - 対象サイトがお客様のサイトかどうかを尋ねます。お客様のサイトの場合は、`kafkai_create_project` の応答にある `setup_steps` を順に提案します。どの手順も無料です。完了すれば、Search Console、Google Analytics、アナリティクス、Bing Webmaster Toolsのデータが使えるようになります。最初の手順はドメイン認証です。`kafkai_verify_domain` を呼び出し、返ってきたTXTレコードとメタタグを両方ともそのまま表示します。設置しやすいほうを選んでもらいます。お客様がどちらかを設置したら、`kafkai_check_domain_verification` を呼び出します。https://kafkai.com/ja/accounts/domains/ でも確認できます。ほかの手順は、ドメイン認証が済んでから行えます。すでに済んでいる手順は、リストに含まれません。
   - お客様が飛ばした手順は、`kafkai_list_projects` と `kafkai_get_project_summary` の `setup_reminders` に表示され続けます。正確な状態はサマリーの応答に含まれますので、サマリーのリマインダーを案内してください。対象サイトを所有していない場合や、使っていないサービスがある場合は、そのリマインダーの停止を提案します。各リマインダーの `mute` には、正確な `kafkai_update_project_settings` の呼び出しが含まれています。無料です。接続は解除されません。
6. `kafkai_get_project_summary` を呼び出します。無料です。確認は1分に1回までにします。`status` が `Ready` でない間、または `last_research.status` が `pending` の間は、調査が実行中です。新しいプロジェクトには `last_research` がまだないため、`status` で判断します。1〜2分待ってから、もう一度呼び出します。`kafkai_update_keywords` は呼び出さないでください。有料の調査が新しく開始されます。
7. 調査が完了したら、次の3つの質問を提示し、お客様が選択した質問に回答します。
   - 次に書くべきキーワードはどれですか。理由も教えてください。
   - 最も強い競合サイトに負けている点と、差を埋める方法を教えてください。
   - すでに上位にあり、順位を守るべきキーワードはどれですか。

ほかの質問例：https://kafkai.com/ja/prompts/

ツールリファレンス：https://kafkai.com/ja/docs/tools/

## ルール

- クレジットを消費する呼び出しの前には、必ず消費するクレジット数を伝え、お客様の同意を得てください。
- お客様からの依頼がない限り、調査の更新を開始しないでください。
- `setup_reminders` は、毎回ではなく、セッションごとに1回だけ伝えてください。
- パスワードやAPIトークンを、この会話に貼り付けるよう求めないでください。
- ツールがエラーを返した場合は、メッセージをお客様に表示し、https://kafkai.com/ja/docs/troubleshooting/ を案内します。
