> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-release-1-14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCPツールの使用

<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/use-dify/build/mcp) を参照してください。</Note>

[MCPサーバー](https://modelcontextprotocol.io/docs/getting-started/intro)から外部ツールをDifyアプリに接続します。組み込みツールだけでなく、成長する[MCPエコシステム](https://mcpservers.org/)のツールも使用できます。

<Note>
  これはDifyでMCPツールを使用することについて説明しています。DifyアプリをMCPサーバーとして公開する場合は、[こちら](/ja/use-dify/publish/publish-mcp)をご覧ください。
</Note>

<Info>
  現在、[HTTPトランスポート](https://modelcontextprotocol.io/docs/learn/architecture#transport-layer)を使用するMCPサーバーのみをサポートしています。
</Info>

## MCPサーバーの追加

ワークスペースで**ツール** → **MCP**に移動します。

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-release-1-14/A_WYV3glqHYhxXIh/images/use-dify/workspace/mcp-server-list.png?fit=max&auto=format&n=A_WYV3glqHYhxXIh&q=85&s=a1e6600717681f42b2535ee5a8f30967" alt="MCP サーバー一覧" width="3048" height="1988" data-path="images/use-dify/workspace/mcp-server-list.png" />
</Frame>

\*\*MCPサーバーを追加（HTTP）\*\*をクリック：

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-release-1-14/A_WYV3glqHYhxXIh/images/use-dify/workspace/mcp-add-server-dialog.png?fit=max&auto=format&n=A_WYV3glqHYhxXIh&q=85&s=d7f9a32f250fc5db90f1927fdb63f290" alt="MCP サーバー追加ダイアログ" width="1120" height="912" data-path="images/use-dify/workspace/mcp-add-server-dialog.png" />
</Frame>

**サーバーURL**：MCPサーバーの場所（例：`https://api.notion.com/mcp`）

**名前とアイコン**：わかりやすい名前を付けてください。Difyはアイコンを自動的に取得しようとします。

**サーバーID**：一意の識別子（小文字、数字、アンダースコア、ハイフン、最大24文字）

<Warning>
  サーバーIDを使い始めたら、絶対に変更しないでください。このサーバーのツールを使用するアプリが壊れてしまいます。
</Warning>

## 次に起こること

Difyは自動的に：

1. サーバーに接続
2. OAuth処理を実行
3. 使用可能なツールのリストを取得
4. アプリビルダーで使用できるようにします

ツールが見つかると、サーバーカードが表示されます：

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-release-1-14/A_WYV3glqHYhxXIh/images/use-dify/workspace/mcp-server-card.png?fit=max&auto=format&n=A_WYV3glqHYhxXIh&q=85&s=2f37019e2b1bb9e54d441bed166e0427" alt="MCP サーバーカード" width="1564" height="550" data-path="images/use-dify/workspace/mcp-server-card.png" />
</Frame>

## サーバーの管理

任意のサーバーカードをクリックすると：

**ツールの更新**：外部サービスが新しいツールを追加した際に更新

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-release-1-14/A_WYV3glqHYhxXIh/images/use-dify/workspace/mcp-server-tools-list.png?fit=max&auto=format&n=A_WYV3glqHYhxXIh&q=85&s=058af67aea31e200257fcf390db6bec5" alt="MCP サーバーのツール一覧" width="916" height="942" data-path="images/use-dify/workspace/mcp-server-tools-list.png" />
</Frame>

**再認証**：トークンの期限切れ時に認証を修正

**設定の編集**：サーバーの詳細を変更（IDは除く！）

**削除**：サーバーを切断（そのツールを使用するアプリが壊れます）

## MCPツールの使用

接続されると、MCPツールは予想される場所すべてに表示されます：

**エージェント内**：ツールはサーバー別にグループ化されて表示（「Notion MCP » ページ作成」）

**ワークフロー内**：MCPツールはノードとして使用可能

**エージェントノード内**：通常のエージェントと同じ

## ツールのカスタマイズ

MCPツールを追加する際、カスタマイズできます：

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-release-1-14/A_WYV3glqHYhxXIh/images/use-dify/workspace/mcp-tool-settings.png?fit=max&auto=format&n=A_WYV3glqHYhxXIh&q=85&s=eab6ce6089fbb9f6d257dc8c97cacb94" alt="MCP ツール設定" width="798" height="1020" data-path="images/use-dify/workspace/mcp-tool-settings.png" />
</Frame>

**説明**：デフォルトの説明をより具体的にオーバーライド

**パラメータ**：各ツールパラメータについて、選択できます：

* **自動**：AIに値を決定させる
* **固定**：変更されない特定の値を`numResults`を5（固定）に設定し、`query`は自動のままにします。

## アプリの共有

MCPツールを使用するアプリをエクスポートする場合：

* エクスポートにはサーバーIDが含まれます
* アプリを他の場所で使用するには、同じIDで同じサーバーを追加してください
* アプリに必要なMCPサーバーを文書化してください

## トラブルシューティング

**「未設定サーバー」**：URLを確認し、再認証してください

**不足しているツール**：「ツールの更新」を実行してください

**壊れたアプリ**：おそらくサーバーIDを変更したでしょう。元のIDで再度追加してください。

## ヒント

* `github-prod`や`crm-system`のような永続的で説明的なサーバーIDを使用してください
* 開発/ステージング/本番環境で同じMCP設定を維持してください
* 設定項目には固定値を、動的入力には自動を設定してください
* デプロイ前にMCP統合をテストしてください