トラブルシューティング

エラーはツールの応答にJSONとして含まれるため、多くの場合はエージェントがそのまま読み上げます。ここでは、代表的なエラーの意味と対処法を説明します。

接続と認証

接続できない

URLを1文字ずつ確認します。

https://kafkai.com/mcp

パスの末尾は /server です。クライアントは、MCPのStreamable HTTPトランスポートに対応している必要があります。stdio専用のクライアントからは、リモートサーバーに接続できません。

サインイン画面が表示されない（OAuthクライアント）

原因の多くはポップアップブロックです。ポップアップを許可するか、コネクタを削除して追加し直し、認可を最初からやり直します。

これまで動作していたのに、認可エラーになる

OAuthクライアントの場合は、コネクタを削除して追加し直し、再度サインインします。APIトークンの場合は、トークンが失効している可能性があります。APIトークンのページを確認し、必要であれば新しいトークンを発行してください。トークンの表示は作成時の1回だけです。紛失した場合は、復元ではなく再作成になります。

「No Kafkai user found」と表示される

認証に使用したアカウントが、kafkai.comに存在しません。先に登録を済ませてから、接続し直してください。

クレジット

「No credit wallet found」または「Insufficient credits」と表示される

残高が呼び出しの費用に足りません。残高の確認は無料です。エージェントに残高を確認し、料金ページで追加購入してください。残高不足で拒否された呼び出しに、費用はかかりません。

プロジェクトとデータ

「Project '…' not found」と表示される

プロジェクトIDが誤っているか、別のアカウントのプロジェクトです。エージェントにプロジェクトの一覧を取得させ、その中のIDを指定します。

新しいプロジェクトでキーワードが空のまま

調査はプロジェクトの作成後にバックグラウンドで実行され、数分かかります。プロジェクトの概要を確認し、件数が0であれば、調査はまだ完了していません。数時間経っても空のままであれば、お問い合わせください。

「Competitor '…' not found in this project」と表示される

エージェントに競合サイトの一覧を取得させ、その中のドメインを指定します。登録済みのドメインと一致する必要があり、任意のURLでは指定できません。

更新がキューに登録されない

順位更新は、1つのプロジェクトにつき同時に1件までです。実行中の更新が完了するまでお待ちください。その間も、キーワード系のツールは完了済みの最新データを返します。

kafkai_publish_article が「Publishing failed」を返す

公開先が投稿を受け付けませんでした。エラーにはその理由が含まれます。kafkai_list_publishing_destinations で公開先のURLと認証情報を確認し、公開先を修正してから、もう一度公開を依頼します。

上記で解決しない場合

お問い合わせから、ツール名と応答内のエラー文を添えてご連絡ください。応答の _usage やエラーオブジェクトに機密情報は含まれないため、そのまま貼り付けていただけます。