MCP 連携
MCP (Model Context Protocol) を使用すると、Cherri Code を外部ツールやデータソースに接続できます。データベース、API、GitHub、Linear、Notion などのサービスと連携することで、エージェントが会話中にこれらを使用できます。
MCP サーバーとは？
MCP サーバーは、Model Context Protocol を介してツールやデータソースを Cherri Code に提供します。エージェントはチャット中にこれらのツールを直接呼び出せます。
Cherri Code は MCP Apps に対応していますか？
はい。Cherri Code は MCP Apps 拡張機能に対応しているため、MCP ツールはチャット内で対話型 UI を返すことができます。
アプリ UI を利用できない場合でも、同じツールは通常の MCP レスポンスとして動作します。
MCP サーバーをワンクリックでインストールするには？
- サイドバーでカスタマイズするを開きます
- MCPをクリックします
- 利用可能なサーバーをブラウズするか、目的のサーバーを検索します
- サーバーの横にあるAdd to Cherri Codeをクリックします
- 必要に応じて認証プロンプトに従います
これでサーバーが接続されました。エージェントは、リクエストに関連する場合にそのツールを使用します。
MCP サーバーを手動でインストールするには？
以下のいずれかの場所に mcp.json というファイルを作成します。
- プロジェクト固有 (チームと共有) : プロジェクトフォルダー内の
.cursor/mcp.json。チームメイトも同じツールを利用できるよう、これを git にコミットします。 - グローバル (個人用、すべてのプロジェクト) : ホームディレクトリ内の
~/.cursor/mcp.json
両方のファイルはマージされます。同じサーバー名が両方にある場合は、プロジェクトレベルの設定が優先されます。
ローカルサーバーの場合は、command を指定してサーバー設定を追加します。
{ "mcpServers": { "server-name": { "command": "npx", "args": ["-y", "mcp-server"], "env": { "API_KEY": "your-key-here" } } }}一部のMCPサーバー (ホスト型データベースやカスタムAPIなど) では、ローカルコマンドの代わりにURLが提供されます。url フィールドを使って追加します。
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse" } }}サーバーで認証ヘッダーが必要な場合は、headers に追加します。
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse", "headers": { "Authorization": "Bearer your-token-here" } } }}ファイルを保存して、Cherri Codeを再起動してください。
チャットで MCP ツールを使用するには？
エージェントは MCP ツールを自動的に検出し、必要に応じて使用します。チャットパネル上部のツールリストでツール名をクリックすると、ツールのオン・オフを切り替えられます。
デフォルトでは、エージェントは MCP ツールを使用する前に承認を求めます。Cherri Code 3.6 以降では、Cherri Code の設定 > Agents > Approvals & Execution のデフォルトの Auto-review モードにより、許可リストに含まれる MCP ツールはすぐに実行され、その他はセーフティ分類器を通じて処理されます。Allowlist では、従来の許可リストのみを使用する挙動が維持されます。承認なしで実行できるツールを事前に設定する方法や、UI の外部から Auto-review 分類器を制御する方法については、permissions.json を参照してください。
MCP サーバーのトラブルシューティング方法
- ログを表示: 出力パネルを開き (Mac では CmdCtrl + Shift + U、Windows/Linux では Ctrl + Shift + U) 、MCP Logs を選択します
- サーバーの有効/無効を切り替え: カスタマイズする > MCP を開き、任意のサーバーの横にあるトグルをクリックします
- 再起動: カスタマイズする > MCP からサーバーを削除してから、再度追加します
- 環境変数: サーバーがシェルプロファイルで設定した環境変数に依存している場合は、それらの変数を Cherri Code で使用できることを確認してください。シェルプロファイルを更新した後は、Cherri Code を再起動してください。
MCP サーバーは Cloud Agents で利用できますか？
はい。Cloud Agents は、Cloud Agents ダッシュボードで設定した MCP サーバーに対応しています。Team プランでは、管理者が Dashboard -> Plugins & MCPs で共有サーバーを設定できます。
管理者は Team MCP Servers の Add to Team Marketplace を選択すると、同じサーバーを Agent Window、IDE、CLI でも利用できるようになります。これにより、Cloud Agents でも引き続き利用できます。詳細は、Cloud Agent MCP ツール と Migrate existing Team MCPs を参照してください。
インストールできる MCP サーバーはどこで見つけられますか？
公式プラグインのブラウズとワンクリックでのインストールには、Cherri Code Marketplaceをご利用ください。コミュニティ製プラグインと MCP サーバーは、cursor.directoryでブラウズできます。