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

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

もし使用しているのが [トークン認証](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.