Skip to content

Commit 85f7a55

Browse files
guchenheguchenhe
authored
Merge pull request #312 from langgenius/mcp-integration
Add translation for MCP
2 parents 6bbeb9e + 0efab32 commit 85f7a55

6 files changed

Lines changed: 541 additions & 0 deletions

File tree

‎docs.json‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -793,6 +793,7 @@
793793
"group": "工具",
794794
"pages": [
795795
"zh-hans/guides/tools/readme",
796+
"zh-hans/guides/tools/mcp",
796797
"zh-hans/guides/tools/quick-tool-integration",
797798
"zh-hans/guides/tools/advanced-tool-integration",
798799
{
@@ -825,6 +826,7 @@
825826
"zh-hans/guides/application-publishing/launch-your-webapp-quickly/conversation-application"
826827
]
827828
},
829+
"zh-hans/guides/application-publishing/publish-mcp",
828830
"zh-hans/guides/application-publishing/embedding-in-websites",
829831
"zh-hans/guides/application-publishing/developing-with-apis",
830832
"zh-hans/guides/application-publishing/based-on-frontend-templates"
@@ -1461,6 +1463,7 @@
14611463
"ja-jp/guides/application-publishing/launch-your-webapp-quickly/conversation-application"
14621464
]
14631465
},
1466+
"ja-jp/guides/application-publishing/publish-mcp",
14641467
"ja-jp/guides/application-publishing/embedding-in-websites",
14651468
"ja-jp/guides/application-publishing/developing-with-apis",
14661469
"ja-jp/guides/application-publishing/based-on-frontend-templates"
@@ -1511,6 +1514,13 @@
15111514
}
15121515
]
15131516
},
1517+
{
1518+
"group": "ツール",
1519+
"pages": [
1520+
"ja-jp/guides/tools/types-of-tools",
1521+
"ja-jp/guides/tools/mcp"
1522+
]
1523+
},
15141524
{
15151525
"group": "コラボレーション",
15161526
"pages": [

‎ja-jp/guides/application-publishing/publish-mcp.mdx‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: "DifyのアプリをMCPサーバーとして公開"
3+
---
4+
5+
Difyがアプリケーションを[MCP](https://modelcontextprotocol.io/introduction)（モデルコンテキストプロトコル）サーバーとして公開できるようになりました。これにより、Claude Desktop のような AI アシスタントや Cursor のような開発環境とのシームレスな統合が可能になります。これらのツールは、まるでネイティブな拡張機能のように、Difyアプリと直接やり取りすることができます。
6+
7+
<Note>
8+
Difyのワークフローやエージェント内でMCPツールを使用する方法については、[こちら](/ja-jp/guides/tools/mcp)を参照してください。
9+
</Note>
10+
11+
## DifyアプリをMCPサーバーとして設定
12+
13+
Difyのアプリケーション設定ページに移動すると、MCPサーバー設定モジュールが表示されます。デフォルトで無効化されていますが、有効化するとDifyがアプリケーション用のユニークなMCPサーバーアドレスを生成します。このアドレスは、外部ツールが接続するための接続点として機能します。
14+
15+
<Danger>
16+
生成されたMCPサーバーURLには認証情報が含まれているため、APIキーのように扱ってください。もし漏洩の恐れがある場合は、「regenerate」ボタンを使用して新しいURLを作成してください。古いURLはすぐに無効になります。
17+
</Danger>
18+
19+
<img
20+
src="/images/CleanShot2025-07-07at08.18.02.png"
21+
alt="CleanShot 2025-07-07 at 08.18.02.png"
22+
title="CleanShot 2025-07-07 at 08.18.02.png"
23+
className="mx-auto"
24+
style={{ width:"46%" }}
25+
/>
26+
27+
## Claude Desktop との統合
28+
29+
DifyアプリをClaude Desktopに接続するには、Claudeとの統合を追加する必要があります。Claude Profile > Settings > Integrations > Add integration に移動してください。統合URLをDifyアプリのサーバーURLに置き換えてください。
30+
31+
## Cursor との統合
32+
33+
Cursorに対しては、プロジェクトのルートにある `.cursor/mcp.json` ファイルを作成または編集します：
34+
35+
```json
36+
{
37+
"mcpServers": {
38+
"your-server-name": {
39+
"url": "your-server-url"
40+
}
41+
}
42+
}
43+
```
44+
45+
指定された URL を Dify アプリの MCP サーバーアドレスに置き換えてください。Cursor はこの設定を自動的に検出し、あなたの Dify アプリをツールとして利用可能にします。`mcpServers` オブジェクトに追加のエントリーを含めることで、複数の Dify アプリを追加することもできます。
46+
47+
## 実用的な考慮事項
48+
49+
- 説明
50+
51+
ツールとその入力パラメータの説明を編成する際、AIがそれをどのように解釈するかを考慮することをお勧めします。明確で具体的な記述を心がけることで、より良い呼び出しを引き出します。「入力データ」とするのではなく、「必須フィールド（名前、メールアドレス、好み）を含むユーザープロファイルのJSONオブジェクト」と具体的に記述してください。
52+
53+
- レイテンシ
54+
55+
MCPプロトコルは通信層を扱いますが、Difyアプリのパフォーマンスも重要です。アプリの処理に通常30秒かかる場合、その遅延がクライアントアプリケーションにも影響します。進捗状況を表示したり、複雑なワークフローをより小さく迅速な操作に分割したりすることを検討してください。
56+
57+
{/*
58+
Contributing Section
59+
DO NOT edit this section!
60+
It will be automatically generated by the script.
61+
*/}
62+
63+
---
64+
65+
[このページを編集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/application-publishing/publish-mcp.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20sh-&body=%23%23%20問題の説明%0A%3C%21--%20発見した問題について簡単に説明してください%20--%3E%0A%0A%23%23%20ページリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/application-publishing%2Fpublish-mcp.mdx%0A%0A%23%23%20提案される変更%0A%3C%21--%20特定の変更案がある場合は、ここで説明してください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向上にご協力いただきありがとうございます！%20--%3E)
66+

‎ja-jp/guides/tools/mcp.mdx‎

Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
---
2+
title: "MCPツールの活用"
3+
---
4+
5+
外部の[MCP](https://modelcontextprotocol.io/introduction)サーバーが提供する[ツール](https://modelcontextprotocol.io/docs/concepts/tools)を直接 Dify Agent やワークフローで利用できます。既存のDifyプラグインに制限される代わりに、特定の機能を提供する成長している MCP サーバーの[エコシステム](https://mcpservers.org/)を活用できます。
6+
7+
<Note>
8+
この記事では、Dify内でMCPツールを使用する方法を解説します。Difyアプリケーションを MCP サーバーとして公開する方法については、[こちら](https://mcpservers.org/en/guides/application-publishing/publish-mcp)をご覧ください。
9+
</Note>
10+
11+
<Info>
12+
現在、[HTTPトランスポート](https://modelcontextprotocol.io/docs/concepts/architecture#transport-layer)をサポートしている MCP サーバーのみが利用可能です。
13+
</Info>
14+
15+
## MCPサーバー管理へのアクセス
16+
17+
Difyワークスペースの**ツール** → **MCP**に移動します。ここでは、アプリケーション用にツールを提供する全ての外部MCPサーバーを管理します。
18+
19+
![6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png](/images/6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png)
20+
21+
## MCPサーバーの追加
22+
23+
<img
24+
src="/images/b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png"
25+
alt="b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png"
26+
title="b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png"
27+
className="mr-auto"
28+
style={{ width:"70%" }}
29+
/>
30+
31+
**MCP Server (HTTP)を追加** をクリックして、新しい外部ツールプロバイダーに接続します：
32+
33+
* **サーバーURL**: MCPサーバーのHTTPエンドポイント（例: `https://api.notion.com/mcp` はNotionとの統合に用いるためのHTTPエンドポイントです）。
34+
35+
* **名前とアイコン**: 提供されるツールを説明する名前を付けます。Difyは可能な限りサーバーのドメインからアイコンを自動で取得し、自分で選ぶこともできます。
36+
37+
* **サーバーの識別**: Difyがこのサーバーを管理するために使用するユニークなID（小文字、数字、アンダースコア、ハイフン、最大24文字）。
38+
39+
<Warning>
40+
サーバーIDは設計上永久的です。これを変更すると、このサーバーのツールを使用している既存の Agent やワークフローが機能しなくなります。これは[アプリケーションのポータビリティ](##application-portability)にとって重要です。
41+
</Warning>
42+
43+
## 認証とツールの発見
44+
45+
サーバーを追加した後、Difyは自動的に以下を行います：
46+
47+
1. **利用可能なツールの検出**: サーバーが提供する機能をチェックします。
48+
2. **認証処理**: サーバーが認証を必要とする場合、OAuthフローを開始します。
49+
3. **ツール定義の取得**: アプリケーションで使用できるようツールのスキーマをダウンロードします。
50+
4. **ツールのインベントリを更新**: Agent やワークフロービルダーでツールを使用できるようにします。
51+
52+
Difyが少なくとも1つの使用可能なツールを正常に取得するとサーバーカードが追加されます：
53+
54+
![fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png](/images/fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png)
55+
56+
## 接続されたサーバーの管理
57+
58+
サーバーカードをクリックすると、以下ができます：
59+
60+
* **ツールの更新**: サーバーから入手可能なツールを更新します。外部サービスが新しい機能を追加した場合に使用します。
61+
62+
<img
63+
src="/images/7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png"
64+
alt="7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png"
65+
title="7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png"
66+
className="mx-auto"
67+
style={{ width:"59%" }}
68+
/>
69+
70+
* **再認証**: 認証ステータスをクリックして権限を更新します。
71+
72+
* **設定の変更**: サーバーの詳細を変更します。
73+
74+
<Warning>
75+
注意: URLの変更は再認証を引き起こし、サーバーIDの変更は既存のアプリケーションを破損させます。
76+
</Warning>
77+
78+
<img
79+
src="/images/CleanShot2025-07-07at07.28.04@2x.png"
80+
alt="CleanShot 2025-07-07 at 07.28.04@2x.png"
81+
title="CleanShot 2025-07-07 at 07.28.04@2x.png"
82+
className="mx-auto"
83+
style={{ width:"60%" }}
84+
/>
85+
86+
* **サーバーの削除**: サーバーを切断します。そのツールを使用しているアプリケーションは、再接続またはツールを削除するまでエラーが表示されます。
87+
88+
## アプリケーションでのMCPツールの使用
89+
90+
サーバーが設定されると、そのツールは作成時のツール選択インターフェースに表示されます：
91+
92+
### Agent アプリケーション
93+
94+
- MCP ツールは Agent 設定の組み込みツールと一緒に表示されます。
95+
- ツールはサーバー別に整理されます: "Notion MCP » ページ作成", "Linear MCP » 課題作成"。
96+
- "すべて追加"オプションを使用すると、サーバーの全ツールを迅速に有効にできます。
97+
98+
### Workflow アプリケーション
99+
- MCP ツールは Workflow ビルダーの利用可能なノードタイプとして表示されます。
100+
- 各ツールノードはどのサーバーから来ているかを示します（トラブルシューティングに役立ちます）。
101+
- 複雑なツールパラメーターは構造化データ用のJSON入力インターフェースを持ちます。
102+
103+
### Workflow 内の Agent ノード
104+
105+
- MCPツールはスタンドアロン Agent と同様に Agent ノード内でも選択できます。
106+
107+
### MCP ツールをユースケースにカスタマイズする
108+
109+
Agent ノードや Agent に MCP ツールを追加すると、その動作をカスタマイズできます：
110+
111+
<img
112+
src="/images/CleanShot2025-07-07at07.41.33@2x.png"
113+
alt="CleanShot 2025-07-07 at 07.41.33@2x.png"
114+
title="CleanShot 2025-07-07 at 07.41.33@2x.png"
115+
className="mx-auto"
116+
style={{ width:"57%" }}
117+
/>
118+
119+
### ツールの説明
120+
121+
MCPサーバーからのデフォルトの説明をオーバーライドできます。これにより、ユースケースに特化した説明が可能です。
122+
123+
### パラメーター設定（推論設定）
124+
125+
各ツールパラメーターについて、次の選択ができます：
126+
127+
**自動**: コンテキストに基づいてAIモデルがパラメーター値を決定します（デフォルトの動作）。
128+
129+
**固定値**: 常に使用される特定の値（静的な値または変数）を設定し、AIの推論からパラメーターを取り除きます。
130+
131+
これは次のような状況で便利です：
132+
133+
- 一貫した設定値を設定するため（検索ツールに対して `numResults: 10` のように）。
134+
- 変更すべきでないパラメーターを事前に設定するため（特定のAPIエンドポイントやフォーマット設定）。
135+
- AIが処理する必要のあるパラメーターを減らしてツールの使用を簡素化します。
136+
137+
例えば、Web 検索ツールを使う場合、以下のように設定できます：
138+
139+
* `query`を「自動」に保ち、AIが何を検索するかを決定します。
140+
* `numResults`を「5」として固定値に設定し、応答サイズを制限します。
141+
* 検索フィルターなど他のパラメーターを固定値として設定し、一貫した動作を実現します。
142+
143+
## アプリケーションのポータビリティ
144+
145+
MCPツールを使用するDifyアプリケーションをエクスポートすると：
146+
147+
* **DSLエクスポート**: エクスポートされたDSLは、MCPサーバーをそのIDで参照します。
148+
149+
* **環境移行**: 他の場所でアプリケーションを使用するには、ターゲット環境に同じMCPサーバーを同一のIDで追加します。
150+
151+
* **アプリの共有**: アプリケーションに依存するMCPサーバーを、URLや必要なサーバーIDを含めて文書化します。
152+
153+
## 統合問題のトラブルシューティング
154+
155+
* **"未設定サーバー"**: 認証に失敗したか、ツールが見つかりません。サーバーURLを確認し、再認証してください。
156+
* **アプリ内のツールが欠如**: "ツールを更新"をクリックして — 外部サービスが提供を変更したかもしれません。
157+
* **サーバー変更後のアプリの破損**: サーバーIDを変更したりサーバーを削除した場合、アプリケーションはツールエラーを表示します。元のIDでサーバーを再追加して機能を回復させてください。
158+
159+
## ベストプラクティス
160+
161+
**一貫したサーバーID**: github-mcpやsalesforce-apiのような説明的で永久的なIDを使用します。一度、アプリケーションが依存し始めたら変更しないでください。
162+
163+
**環境の一貫性**: 開発、ステージング、プロダクション環境間で同じMCPサーバー構成を維持します。
164+
165+
**ツールのカスタマイズ**: パラメーター設定を活用し、アプリケーションでツールが一貫して機能するようにします。固定値を設定し、動的な入力をAIに処理させます。
166+
167+
**ツールの文書化**: アプリケーションで使用している外部ツール、行ったカスタマイズ、及びその機能を文書化します。これにより、チームメンバーがアプリケーションの依存関係を理解しやすくなります。
168+
169+
**段階的な更新**: 外部サービスがMCPサーバーを更新する際、プロダクション環境での統合を更新する前に開発環境でツールの変更をテストします。
170+
171+
**バックアッププラン**: 外部MCPサーバーが利用できなくなった場合、アプリケーションがどのように動作するかを考慮します。
172+
173+
{/*
174+
Contributing Section
175+
DO NOT edit this section!
176+
It will be automatically generated by the script.
177+
*/}
178+
179+
---
180+
181+
[このページを編集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/tools/mcp.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発見した問題について簡単に説明してください%20--%3E%0A%0A%23%23%20ページリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fja-jp/guides/tools%2Fmcp.mdx%0A%0A%23%23%20提案される変更%0A%3C%21--%20特定の変更案がある場合は、ここで説明してください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向上にご協力いただきありがとうございます！%20--%3E)
182+

0 commit comments

Comments
 (0)