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

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

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

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

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

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

claude --debug

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