Skip to main content

Command Palette

Search for a command to run...

はじめに

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>

無効化されたサーバーは読み込まれず、承認も求められません。

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 を使用します。

関連