カーソルのMCPが接続できない最も一般的な問題は、ツール自体ではなく、設定や伝達の不一致です。 公式のCursor MCPドキュメントでは、MCPは「stdio」「SSE」「Streamable HTTP」の3種類に分けられており、これらはローカル、リモート、認証、入力形式に関する異なる要件を持っています。 公式ドキュメント:カーソルMCP。
最もエラーが起こりやすい分野を見てみましょう
ローカルMCPを使用している場合、「mcp.json」内のコマンドはカーソルがアクセス可能な環境で実行できなければなりません。 リモートMCPを使用する場合、URL、認証ヘッダー、エンドポイントは一貫していなければなりません。 多くの人は「すでに設定済みだと感じている」と感じ、実際にはサービスを設定したばかりですが、カーソルは正しいトランスポートやトークンを受け取っていません。
公式は他に何を思い出させたのか?
カーソルノートには、MCPが実行可能コマンドで「stdout」に出力するか、HTTPエンドポイントを公開する必要があるとも述べられています。 つまり、サーバー側の書き込み、ログ出力、認証が失敗してはなりません。 小さな点が一つあれば、カーソルはそれを使えるツールとして扱わないでしょう。
トラブルシューティング順
- カーソルが「mcp.json」を読み取っていることを確認してください。
- 正しい送金方法を選ぶことを忘れないでください。
- 認証トークン、環境変数、エンドポイントを確認してください。
- リモートサービスの場合は、まず端末で最小リクエストでパスできるか確認してください。
多くのMCPは接続されておらず、基本的に「サーバーが稼働中」と「カーソルが本当に接続している」といった状態に一歩近い状態です。 このステップを埋めれば、たいてい問題は解消されます。
