ドキュメント » AIエージェントでセットアップする

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

このページはAIエージェント向けに書かれています。Claude、ChatGPTなど、ご利用のMCPクライアントに次の1行を貼り付けます。 https://kafkai.com/ja/docs/onboarding.md を読んで、Kafkaiのセットアップを進めてください。

Kafkaiのお客様が、このリンクをエージェントに貼り付けました。エージェントの役割は、未接続の状態から、データの入った最初のプロジェクトができるまでを案内することです。質問は1回に1つだけにします。お客様が書いた言語で返答します。

ステージ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 を提案します。呼び出す前に、消費するクレジット数を伝えます。
    • 対象サイトがお客様のサイトかどうかを尋ねます。お客様のサイトの場合は、ドメイン認証を提案します。ドメイン認証は無料で、完了するとSearch Consoleとアクセス解析のデータを利用できます。kafkai_verify_domain を呼び出し、返されたDNSのTXTレコードをそのまま表示します。お客様がレコードを追加したら、kafkai_check_domain_verification を呼び出します。https://kafkai.com/ja/accounts/domains/ でも確認できます。
  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/

ルール

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