3行でいうと
- 「Difyのアプリを、ClaudeなどのAIのツールから使う」には、アプリの「Access Point」にある「MCP Server」を使います。初期状態では「disabled by default」で、オンにするとアプリごとのURLが作られます。公式は、このURLを「APIキーのように扱う」ように注意しています。
- 「Difyの中から外のMCPサーバーを使う」には、「Integrations」の「Tools」からMCPを追加します。公式は「Only MCP servers with HTTP transport are supported」と書いています。
- モデルは、Dify Cloudが用意するクレジットか、自分のAPIキーのどちらでも動かせます。キーを使うと、リクエストは、あなたが接続したモデル提供会社へ送られます。
- プラグインの入手元は、Marketplace、GitHub、ローカルのファイル（
.difypkg）の3つです。公式は、Marketplaceのものは公開前に審査される、と書いています。GitHubとローカルのものについて、公式のページに安全性の説明は、読んだ範囲では見つかりませんでした。 - APIは、アプリごとのキーで呼びます。公式は「Call the API from your backend only」と書いています。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。画面名やメニュー名、コマンドは公式の表記を写しています。公式ページは要約の形で取得したため、読めていない部分は「公式の資料では確認できていない」「読んだ範囲では見つからなかった」と書き、引用は短くとどめています。
先に結論
- つなぎ方は2方向ある。 Difyが外を使う向き（モデル、ツール、MCPの取り込み、データ元）と、外がDifyを使う向き（MCPサーバー、API、CLI、埋め込み）です。
- 「公式が運営するもの」と「第三者のもの」は、ページの上で分けて読む。 Difyのモデルクレジット、ドキュメントの機能、公式のAPIとCLIは、LangGenius が運営します。Marketplaceのプラグインの多くは、パートナーやコミュニティの開発者が出しています。
- URLやキーは、鍵として扱う。 MCPサーバーのURL、APIキー、MCPやツールに入れる認証情報が、公式のドキュメントで、それぞれ注意されています。
- データの行き先は、つないだ先で決まる。 Difyの上のデータは、LangGenius のポリシーで扱われ、モデル提供会社や外のツールに渡した分は、その相手の規約で扱われます（このあと表にします）。
- MCPは、ベータの表記が公式のページに見つからなかった。 ただし、公式の資料でベータでないと確認できたわけでもありません。
前提：用語をそろえる
- MCP：公式のツールのページは、外の資源を標準の取り決め（standard interface）で公開する仕組み、と説明しています。MCPサーバーは「呼ばれる側」です。
- モデルプロバイダー（Model Provider）：Difyがつなぐ、AIモデルの接続先です。公式は、LLM、埋め込み、リランクのモデルを含む、と書いています。
- ツール（Tool）：ワークフローやエージェントが呼べる機能です。公式は、ツールのプラグイン、MCPサーバー、公開したワークフロー、OpenAPIのサービスを挙げています。
- プラグイン／Integrations：公式のドキュメントでは、モデル、ツール、データソース、トリガー、エージェント戦略、拡張などの部品を、まとめて「Integrations」と呼んでいます。
- Access Point：アプリの公開の入口が並ぶタブです。Webアプリ、MCP Server、Triggerなどのカードがあります。
- サービスAPI（Service API）：アプリを外から呼ぶためのAPIです。
たとえ話：鍵を預けて呼ぶ、出前の注文
MCPサーバーのURLは、「このお店に注文できる、鍵つきの電話番号」のようなものです。番号を知っている人は、誰でも注文できます。だから、番号が外に漏れたら、公式の手順のように、番号を作り直して、古い番号を使えなくします。逆にDifyが外のMCPサーバーを使うときは、Difyが「外の店に注文する側」になります（たとえは僕らの整理で、公式の説明ではありません）。
向き1：Difyのアプリが、外のAIやツールを使う
モデルプロバイダー（公式が運営する部分と、自分のキー）
- Dify Cloudが用意するクレジット：公式のモデルプロバイダーのページは、これを「AI credits」と呼びます。「Integrations」の「Model Provider」でプロバイダーを入れれば、自分のAPIキーなしで使えます。1回のモデル呼び出しで、モデルごとに違う量のクレジットを使います。どのプロバイダーがクレジットの対象かは、そのページには書かれておらず、料金ページを見るよう案内されています。
- 自分のキー：プロバイダーを入れて「Setup」から、APIキーなどを入れます。Difyが、キーを確かめてから有効にします。クレジットとキーを両方持つときは、「Usage Priority」で、どちらを先に使うかを決めます。クレジットの対象でないプロバイダーは、自分のアカウントで動かします。
- 既定のモデル：「Default Models」で、System Reasoning Model、Embedding Model、Rerank Model、Speech-to-Text Model、Text-to-Speech Model を決めます。
- ロードバランシング：1つのキーが上限に当たるとき、複数のキーを順に使う機能です。公式のページに「Professional team plan」の見出しがあります。プランの条件の細かい書き方は、そのページだけでは確認できていません。
- ローカルのモデル：モデルプロバイダーのページには、ローカルのモデル（Ollamaなど）の記載が、読んだ範囲では見つかりませんでした。
ツール（公式のツール、第三者のもの、自分のAPI）
公式の「Dify Tools」のページは、4つの種類を挙げています。
| 種類 | 公式の説明 | 運営 |
|---|---|---|
| Tool Plugin | 「Ready-to-use tools from Dify and the community」。Current Timeのような内蔵のものと、Marketplaceから入れるもの。GoogleやGitHubなどは認証が要る | Dify、またはコミュニティ（個々のプラグインで違う） |
| Swagger API | OpenAPI（Swagger）の仕様を貼る、URLで読む、で、ツールのないサービスをつなぐ | 自分で指定した外のサービス |
| Workflow | 「User Input」で始まるワークフローを、ツールにする。Chatflowはツールにできない | 自分のワークスペース |
| MCP | MCPサーバーのツールを取り込む | 外のMCPサーバーの運営者 |
外のMCPサーバーを取り込む
- 条件：公式のページは、「Only MCP servers with HTTP transport are supported」と書いています。標準入出力（stdio）で動くサーバーの扱いは、そのページでは読んだ範囲では見つかりませんでした。
- 設定：サーバーのURL、名前、「server identifier」（固有の識別子）を入れます。認証が要るときは、Difyが認証の画面に進みます。
- 認証：「Dynamic Client Registration」が既定でオンで、OAuthの資格を自動で取ります。サーバーが対応していなければ、オフにして、Client IDとClient Secretを入れ、Difyが示すリダイレクトURLを登録します。
- カスタムヘッダー：
Authorization: Bearer <token>のように、固定の鍵を毎回のリクエストに付けられます。値には{{request.headers.X-Custom-Auth}}のように、動的な値も使えます。 - タイムアウト：リクエストと、SSEの読み取りのタイムアウトを調整できます。
- 注意：MCPサーバーのツール一覧を更新すると、使っているツールが消えたり変わったりして、アプリが壊れることがある、と公式は書いています。識別子を変えると、そのサーバーのツールは、使っていたアプリで動かなくなります。書き出したアプリも識別子で参照するので、別のワークスペースでは、同じ識別子を作り直す必要があります。
向き2：外のAIや自分のプログラムが、Difyのアプリを使う
MCPサーバー（公式が運営する機能）
- 手順：アプリを開いて「Access Point」のタブへ。「MCP Server」のカードを、オンにします。アプリごとに固有のアドレスが作られるので、それを、外のツールに入れます。
- クライアントの例（公式のページの例）：「Claude Desktop」は、公式ページによると、Claudeのプロフィールの設定から「Integrations」を開いて連携を追加し、サーバーのURLを入れます。「Cursor」は、プロジェクトの
.cursor/mcp.jsonのmcpServersに、urlを書きます。ほかの「AI development tools」でも使える、と書かれていますが、名前は挙がっていません。 - 認証：公式のページは、別の認証の方法を書いていません。URLそのものが、認証の情報を持つ、と書かれています。漏れたら、再生成のボタンで新しいURLにすると、古いURLはすぐ使えなくなります。
- よい説明を書く：ツールの説明と、入力パラメーターの説明が、AIの呼び出しの精度に影響する、と書かれています。
- 読めていない所：どのアプリの種類がMCPサーバーにできるかは、そのページには書かれていませんでした。
API（公式が運営する機能）
- ベースのURL：Dify Cloudは
https://api.dify.ai/v1。セルフホストは、自分のインスタンスのURLです。 - 認証：すべてのリクエストで、APIキーを
Authorization: Bearer $DIFY_API_KEYの形で送ります。 - キーの種類：アプリごとのキー（そのアプリだけが対象。利用者ごとに分けたいときは
userの値を渡す）と、ナレッジのキー（「Knowledge」の右上の「Service API」で作る。特定のナレッジに絞れる）。 - 警告：公式は「Call the API from your backend only」と書き、画面側のコードに入れたキーは抜き出されて悪用されうる、と注意しています。
- 読めていない所：レート制限とSDKは、そのページには書かれていませんでした。料金ページは、Professional以上で「no Dify API rate limit」、Sandboxは5,000回/月と表示しています。
CLI「difyctl」
- 公式のCLIのページは、difyctl を「the official command-line interface」と書き、アプリをターミナルから動かす、アプリの一覧と必要な入力を見る、結果をストリームやJSONで受ける、AIエージェントにアプリをツールとして見つけさせる、ことができると説明しています。
- クラウド版のページは、OAuthで一度サインインすれば、スクリプトにパスワードやAPIキーを保存しなくてよい、と書いています。セルフホスト向けのページは、サインインの期限が切れ、更新には、ブラウザでの人の操作が要る、と書いています。
- 公式のインストールのページには、macOSとLinux（x64、arm64）、Windows（x64のみ）向けの手順があります。difyctl は単独で動く実行ファイルで、実行時に追加のソフトは要らない、と書かれています。ただし、Difyのサーバーの版と、difyctl のビルドが対応している必要があり、インストール時に
DIFY_VERSIONでサーバーの版を指定します（ページの例は 1.17.1）。difyctl は Dify 1.15.0 で加わった、とあります。macOS・Linuxの例は、公式のリポジトリのスクリプトをダウンロードして実行する形なので、実行の前に中身を確かめたほうが安心です（見立て）。ベータとは、読んだページには書かれていませんでした。
Webアプリの埋め込み
「Embed Into Site」で、iframeか、チャットのバブルを、サイトに載せられます。どちらも、トークンがページのHTMLに入ります。公式のページに、サイトのCSP（Content Security Policy）がiframeを許す必要があり、HTTPSで使うことが勧められています。
プラグインとMarketplace
- 入手元：公式のIntegrationsのページは、3つを挙げています。「Marketplace」（Dify、パートナー、コミュニティの開発者のもの）、「GitHub」（公開リポジトリのURLとバージョンを指定）、「Local Package File」（私的や社内用の
.difypkg）。 - 審査：同じページに、Marketplaceのものは「公開前に審査とテストを受け、公開者が保守する」と書かれています。GitHubとローカルのものについて、安全性の説明は、そのページには書かれていませんでした。
- ラベル：公式、パートナー、コミュニティを区別する表示や署名については、読んだ範囲では見つかりませんでした。Marketplaceのサイトは、取得が許可されておらず（robots.txtで拒否）、読めていません。
- 権限：Integrationsのページの下に、「誰がインストールと更新をできるか」「誰がデバッグできるか」を、全員、管理者のみ、誰もなし、から選べます。削除は、ワークスペースのオーナーと管理者だけです。
- 自動更新：種類ごとに、オフ、パッチのみ、常に最新、から選べます。
- 開発：公式の「Develop Plugins」は、自作のツール、モデル、連携を作るための入口です。今回、中身は読めていません。
データの取り込み元（ナレッジ側）
- Notion：ナレッジを作るとき、事前に用意された連携で、Notionのページを取り込めます。「Settings」の「Data Sources」から結び付ける、と公式のページにあります。画像とファイルは取り込めません。
- 外部のナレッジ：「External Knowledge API」と「Connect to External Knowledge Base」のページが、公式の目次にあります。中身は読めていません。
- Webサイト：「Import Data from Website」が目次にあります。中身は読めていません。
公式が運営するものと、第三者のもの
| 区分 | 例 | 運営・責任 |
|---|---|---|
| 公式（LangGenius） | Dify Cloud、モデルのAIクレジット、MCP Serverの機能、Service API、difyctl | LangGenius, Inc. |
| 公式が土台を作り、第三者が中身を出す | Marketplaceのプラグイン（モデル、ツール、データソース、トリガー） | 公開者（Dify、パートナー、コミュニティ）。Marketplaceのものは審査・テストされると書くが（審査する主体は読んだページに書かれていない）、保守は公開者 |
| 第三者・自分で指定するもの | 自分のAPIキーでつなぐモデル提供会社、取り込む外のMCPサーバー、OpenAPIで指定する外のサービス、GitHubやローカルから入れるプラグイン | それぞれの運営者。Difyの審査の対象かどうかは確認できていない |
| コミュニティ製 | READMEが挙げる、Helm、Terraform（Azure、Google Cloud）、AWS CDK、Azure DevOpsの案内（Alibaba Cloudの2件は担当者の記載がなく、コミュニティ製かは読んだ範囲では不明） | コミュニティ（READMEの記述）。公式のEnterpriseは、Helmチャートなどを別に提供と書く |
「Marketplaceのプラグインのうち、どれがDify自身のものか」を示す印は、今回読めていません。
データはどこへ流れるか
| つなぎ方 | データの流れ（公式の説明から） |
|---|---|
| Dify Cloudのクレジットでモデルを使う | 入力は、LangGenius が選んだモデル提供会社へ送られる。プライバシーポリシーは、その提供会社に、あなたのデータでの学習を契約で禁じている、と書く |
| 自分のAPIキーでモデルを使う | 入力は、あなたが選んだモデル提供会社へ。学習に使われるかは、その会社との契約で決まる、とポリシーに書かれている |
| MCPサーバーを取り込む | ツールを呼ぶときの入力は、そのMCPサーバーへ。カスタムヘッダーに入れた鍵も、そこへ送られる |
| MCPサーバーとして公開する | 外のAIのツールから、URLを使って、あなたのアプリが呼ばれる。URLを知る人は誰でも呼べる、と読める（ページは、URLが認証情報を持つ、と書いている） |
| APIで公開する | アプリのキーを持つ呼び出しだけ。キーは、サーバー側で持つ |
| Notionを取り込む | Notionの内容が、ナレッジとしてDifyの上に複製される |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式のドキュメントを読んだ範囲です。
- MCPサーバーのURL、APIキー、MCPのヘッダーの鍵は、鍵として扱ってください。公開のリポジトリやチャットに貼らないでください。
- 外のMCPサーバーを取り込むときは、そのサーバーの運営者が誰か、どのデータが送られるかを、先に確かめてください（見立て）。
- プラグインは、Marketplaceのものは審査されると公式が書いていますが、GitHubやローカルから入れるものの審査は、公式の資料では確認できていません。
- 公式の資料同士で、細部が違う所があります。たとえば、CLIのクラウド版のページとセルフホスト向けのページで、サインインの説明が異なります。
- 規約や契約の解釈は、必要なら専門家や公式に確認してください。この記事は法律の助言ではありません。
出典
- MCP Server（公開、Dify Docs、確認日 2026-10-23）
- Dify Tools（Dify Docs、確認日 2026-10-23）
- Integrations (Plugins)（Dify Docs、確認日 2026-10-23）
- Model Providers（Dify Docs、確認日 2026-10-23）
- API Get Started（Dify Docs、確認日 2026-10-23）
- Dify CLI Overview（クラウド、Dify Docs、確認日 2026-10-23）
- Embed Your Web App（Dify Docs、確認日 2026-10-23）
- Sync Data from Notion（Dify Docs、確認日 2026-10-23）
- Publish Overview（Dify Docs、確認日 2026-10-23）
- Dify Docs 索引（クラウド、Dify Docs、確認日 2026-10-23）
- Dify Docs 入口（Dify Docs、確認日 2026-10-23）
- langgenius/dify README（GitHub、確認日 2026-10-23）
- Dify Enterprise（LangGenius、確認日 2026-10-23）
- Privacy Policy（LangGenius、確認日 2026-10-23）
- Dify Pricing（LangGenius、確認日 2026-10-23）