> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/ai-totsru/aikido-mcp/mcp-troubleshooting.md).

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

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

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

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

以下をターミナルで実行して確認してください：

```bash
node -v
```

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

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

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

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

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

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

を使用している場合 [トークン認証](/docs/docs-ja/ai-totsru/aikido-mcp/token-authentication.md)、代わりにトークンを直接渡してください：

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

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

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

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

```bash
claude --debug
```

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/ai-totsru/aikido-mcp/mcp-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.