> ## 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 サーバーとして公開する場合は、[こちら](https://enterprise-docs.dify.ai/ja/3.4.x/use/publish/publish-mcp.md) をご覧ください。

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

## MCP サーバーの追加

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

![MCP サーバー一覧](https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workspace/mcp-server-list.png?fit=max\&auto=format\&n=zvhvyUvEpyoIONBf\&q=85\&s=83c69e2db43013cf5cd343b5c2255106)

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

![MCP サーバー追加ダイアログ](https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workspace/mcp-add-server-dialog.png?fit=max\&auto=format\&n=zvhvyUvEpyoIONBf\&q=85\&s=cc3a95e72805d12d5882c5a754c78fd2)

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

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

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

> [!NOTE]
>
> * アプリはサーバーを識別子で参照します。後で識別子を変更すると、古い識別子を使っていたアプリではサーバーのツールが動作しなくなります。影響を受けた各アプリでツールを追加し直すと復旧できます。
> * エクスポートしたアプリもサーバーを識別子で参照するため、別のワークスペースで実行するには、同じ識別子で同じサーバーを再作成してください。

## 次に起こること

Dify は自動的に：

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

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

![MCP サーバーカード](https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workspace/mcp-server-card.png?fit=max\&auto=format\&n=zvhvyUvEpyoIONBf\&q=85\&s=2c2b9546c927470bf0aca37fe2623407)

## サーバーの管理

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

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

![MCP サーバーのツール一覧](https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workspace/mcp-server-tools-list.png?fit=max\&auto=format\&n=zvhvyUvEpyoIONBf\&q=85\&s=95f9c56888866ec511db2084ffc8fdf1)

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

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

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

## MCP ツールの使用

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

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

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

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

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

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

![MCP ツール設定](https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workspace/mcp-tool-settings.png?fit=max\&auto=format\&n=zvhvyUvEpyoIONBf\&q=85\&s=1cbedf8abf1c67db91d008f8dc413147)

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

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

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

## アプリの共有

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

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

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

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

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

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

## ヒント

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.