MCPのトラブルシューティング

Aikido MCP server で問題が発生した場合、サポートに連絡する前に以下の手順を確認してください。問題が解決しない場合は、これらの手順の出力を Aikido チームに共有してください。

Node.js のバージョンを確認する

Aikido MCP server には Node.js 18.19.0 以上が必要です。

次をターミナルで実行して確認してください:

node -v

バージョンが 18.19.0 未満の場合は、続行する前に Node.js を更新してください。

MCP サーバーを直接実行する

ほとんどの AI コーディングツールでは、プラグイン統合された MCP サーバーの詳細なログを取得するのは簡単ではありません。上記の手順で解決しない場合は、問題を切り分けるために MCP サーバーを単独で実行してみてください。

次のコマンドをターミナルで実行してください:

LOG_LEVEL=debug npx -y @aikidosec/mcp@latest

これにより、AI ツール外で MCP サーバーが起動し、まだ認証されていない場合はブラウザのログインフローが開始されます。デバッグレベルのログがターミナルに直接出力されます。

を使用している場合は トークン認証、代わりにトークンを直接渡してください:

AIKIDO_API_KEY=your_api_key_here LOG_LEVEL=debug npx -y @aikidosec/mcp@latest

認証、ネットワーク接続、または設定不足に関連するエラーを探してください。

Claude のデバッグログを収集する

Claude を使用している場合は、デバッグモードで起動してください:

claude --debug

これにより、起動ログ（MCP の起動ログを含む）がファイルに書き込まれます。これらのログには接続や設定の問題に役立つ情報が含まれる場合がありますが、根本原因が常に明らかになるとは限りません。