> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP ツールの使用

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

<Note>
  これは Dify で MCP ツールを使用することについて説明しています。Dify アプリを MCP サーバーとして公開する場合は、[こちら](/ja/3.10.x/use/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-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-list.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=4acdc2dacd230c4b9b427bb289762064" 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-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-add-server-dialog.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=6c860f6050922b6bfb5d7b92b3fbd75f" 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-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-card.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=f87d09ca887687a9a8e1397c215b2daf" alt="MCP サーバーカード" width="1564" height="550" data-path="images/use-dify/workspace/mcp-server-card.png" />
</Frame>

## サーバーの管理

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

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

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-tools-list.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=8b3ec3a060e5d0891a9ce584fbbcb82f" 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-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-tool-settings.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=7df42055157abdffbd44c385ab622336" 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 統合をテストしてください