MCP
概要
Cursor CLI は Model Context Protocol (MCP) サーバーに対応しており、外部ツールやデータソースを agent に接続できます。CLI の MCP はエディターと同じ設定を使用します。設定した MCP サーバーはどちらでも使用できます。
MCP について学ぶ
MCP を初めて使用する場合は、設定、認証、利用可能なサーバーに関する完全ガイドをご覧ください
CLIコマンド
agent mcp コマンドでMCPサーバーを管理します
設定済みのサーバーを一覧表示
設定済みのすべての MCP サーバーと現在のステータスを表示します。
agent mcp list対話型メニューが開き、MCP サーバーを一覧でブラウズし、有効化・設定できます。リストには次の項目が表示されます。
- サーバー名と識別子
- 接続状態 (接続済み/未接続)
- 設定の適用元 (プロジェクトまたはグローバル)
- トランスポート方式 (stdio、HTTP、SSE)
同じインターフェースは、対話型モードで /mcp list スラッシュコマンドを使用しても利用できます。
利用可能なツールを一覧表示
特定のMCPサーバーが提供するツールを確認します。
agent mcp list-tools <identifier>表示内容:
- ツール名と説明
- 必須および任意のパラメータ
- パラメータの型と制約
MCP サーバーにログイン
mcp.json で設定した MCP サーバーにログインします。
agent mcp login <identifier>CLI は、自動コールバック処理を備えた簡素なログインフローを使用します。ログインが完了すると、エージェントは認証済みの MCP にすぐにアクセスできます。
MCPサーバーを有効にする
MCPサーバーを有効にします。
agent mcp enable <identifier>これにより、サーバーがローカルの承認済みリストに追加されます。
MCP サーバーを無効化する
MCP サーバーを無効化します。
agent mcp disable <identifier>無効化されたサーバーは読み込まれず、承認も求められません。
スペースを含むMCP サーバー名は、CLIコマンドおよび/mcp list-toolsで使用できます。
Agent で MCP を使用する
MCP サーバーを設定すると (セットアップについてはメインの MCP ガイドを参照してください) 、agent はリクエストに応じて利用可能なツールを自動的に検出して使用します。
# 利用可能なMCPサーバーを確認agent mcp list# 特定のサーバーで利用できるツールを確認agent mcp list-tools playwright# agentを使用 - 必��に応じてMCPツールを自動的に使用agent -p "Navigate to google.com and take a screenshot of the search page"# すべてのMCPサーバーを自動承認(承認プロンプトを省略)agent --approve-mcps "query my database for recent errors"CLI はエディターと同じ設定の優先順位 (プロジェクト → グローバル → ネスト) に従い、親ディレクトリにある設定を自動的に検出します。
MCP と ACP
Cursor から外部ツールやサービスを呼び出すには、MCP を使用します。プロトコルメッセージを介して Cursor CLI 自体と通信するカスタムクライアントを作るには、ACP を使用します。