# トラブルシューティング

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

## 接続と認証

**接続できない**

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

```
https://kafkai.com/mcp
```

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

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

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

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

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

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

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

## クレジット

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

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

## プロジェクトとデータ

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

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

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

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

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

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

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

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

**`kafkai_publish_article` が「Publishing failed」を返す**

公開先が投稿を受け付けませんでした。エラーにはその理由が含まれます。`kafkai_list_publishing_destinations` で公開先のURLと認証情報を確認し、公開先を修正してから、もう一度公開を依頼します。WordPressの公開先では、多くの場合、ユーザーに書き込み権限がないことが原因です。詳しくは、[WordPressを連携する](https://kafkai.com/ja/docs/wordpress/#接続テストには成功するが公開に失敗する場合)をご覧ください。

## 上記で解決しない場合

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