> 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.