> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/extensions/mcp.md).
# MCP と外部ツール
MCP は、エージェントが外部ツールやリソースを利用するための接続方式です。Cherry Studio では MCP サーバー、内蔵サーバー、サービスマーケット、そして一部のサービス提供元の入口を管理し、接続済みのサーバーを指定したエージェントに紐づけられます。
## サーバーを追加
手順：［設定］→［MCP］→［MCP サーバー］→［追加］。
{% stepper %}
{% step %}
### 1. 接続方式を確認する
ローカルコマンドは通常、標準入出力方式を使用します。リモートサービスは通常、SSE またはストリーミング可能な HTTP アドレスを提供します。サービス提供元が案内する設定に従って入力し、名前だけで推測しないでください。
{% endstep %}
{% step %}
### 2. 設定を入力し、権限を確認する
ローカルサーバーにはコマンド、引数、環境変数が必要です。リモートサーバーには URL が必要で、一部のサービスでは認可も必要です。保存前に、コマンドの出所とデータ範囲を確認してください。
{% endstep %}
{% step %}
### 3. 起動してツールを確認する
サーバーを有効化し、状態が正常になるのを待ってから詳細を開き、提供されるツール、リソース、プロンプトを確認します。接続に失敗したら、まずサーバーログを見てください。
ツール一覧で任意のツールを展開すると、完全な Markdown 説明に加え、階層ごとに表示されるパラメータ、型、必須マーク、列挙値を確認できます。呼び出す前に必須パラメータを確認してください。オブジェクトや配列のパラメータは階層ごとに展開して確認し、ツール名だけで入力形式を推測しないようにします。
{% endstep %}
{% step %}
### 4. エージェントに紐づける
［ワーク］→ エージェントメニュー →［編集］→［MCP］を開き、そのサーバーを有効化します。起動していないサーバーは正常に紐づけて使用できません。
{% endstep %}
{% endstepper %}
## 内蔵サーバーとサービスマーケット
［内蔵 MCP］は、すぐにインストールまたは有効化できる一般的な機能を提供します。［サービスマーケット］はサードパーティのマーケットソースを管理するためのものです。インストール前には、説明、コマンド、環境変数、権限を必ず確認してください。内蔵の入口だからといって、外部サービスのすべての操作にリスクがないわけではありません。
## 設定の推奨
| 設定項目 | 製品のデフォルト値 | 推奨の開始値 | 役割 | 適用場面 | 注意事項 |
| ----------- | ------------------- | ------------------------ | ------------------- | ------------------ | ------------------------- |
| サーバー状態 | 追加後は設定に応じて決まる | 一度に1つだけ有効化して検証する | サーバーを利用可能にするかを制御する | 初回接続、トラブルシューティング | 複数サービスが同時に失敗すると原因の特定が難しい |
| エージェントへの紐づけ | すべてのサーバーを自動で紐づけない | 現在のエージェントに必要なサーバーだけを紐づける | 機能範囲を制御する | 複数エージェントの役割分担 | 不要なツールがコンテキストを占有するのを避ける |
| 環境変数 | キーを事前入力しない | サービスが要求する最小権限の認証情報を使う | 認証情報または実行パラメータを提供する | プライベートサービス | スクリーンショットやエクスポート前に機密内容を隠す |
| ツール承認 | エージェントの権限モードによって決まる | 書き込み系や課金系ツールは確認を維持する | 意図しない操作を防ぐ | データベース、ファイル、外部 API | チャネルの入口ではより厳格なモードを使用できる |
## ユーザー事例：プロジェクトデータベースを分析エージェントに接続する
管理者は読み取り専用の MCP 接続を提供し、ユーザーは［設定］→［MCP］でサーバーが正常であることを確認してから、「データ分析」エージェントにのみ紐づけます。エージェントは読み取り専用ツールでデータを取得し、レポートを作業ディレクトリに書き込みます。データ更新に関わるツールは有効化しません。こうしておけば、プロンプトの解釈に誤りがあっても、業務データベースを直接変更することはありません。
MCP と API ゲートウェイの違いは何ですか？
MCP は外部ツールを Cherry Studio に接続するものです。API ゲートウェイは、Cherry Studio のモデル機能を互換 API として他のプログラムに提供するものです。データの流れは逆です。
サーバーは接続済みと表示されるのに、エージェントがツールを見つけられないときは？
エージェントがそのサーバーに紐づけられているか、ツールが無効化されていないか、権限リクエストが保留中でないかを確認してください。エージェント設定を変更したら、新しいメッセージを送ってランタイムに新しいツールを読み込ませます。
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/extensions/mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.