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

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

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

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

ターミナルで以下を実行して確認します。

node -v

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

ほとんどの 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 --debug

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