Dify ツール

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

• Workflow／Chatflow アプリ（独立した ツールノード として、または Agent ノード 内で使用）
• Agent アプリ
• レガシー Agent アプリ

​

ツールの種類

• ツールプラグイン
• Swagger API
• Workflow
• MCP

一般的なユーティリティや人気のサービス向けに、Dify とコミュニティが提供するすぐに使えるツールです。組み込みツール（Current Time など）はそのまま使え、Marketplace からさらにインストールできます。一部のツールプラグイン（Google や GitHub など）は、使用前に認証が必要です。ワークスペースレベルの認証情報は 統合 > ツール > ツールプラグイン で設定するか、アプリやノード内のツール設定で設定します。

ツールプラグインとして提供されていないサービスを、標準の OpenAPI（Swagger）仕様をインポートして統合します。スキーマを貼り付けるか、URL からインポートするか、提供されたサンプルから始めると、Dify がツールインターフェースを自動生成します。

ユーザー入力ノードで始まるワークフローをツールに変換し、マルチステップのロジックを複数のアプリで共有できます。Chatflow はツールとして使用できません。ツールを作成すると、まずワークフローが公開されます。そのため、ツールはその時点のワークフローに対応します。

MCP サーバー に接続して、そのツールを Dify にインポートします。MCP サーバーはデータベース、ファイルシステム、API などの外部リソースをラップし、標準化されたインターフェースを通じて公開するため、アプリは他のツールと同じように呼び出せます。

自分の Dify アプリを MCP サーバーとして公開する場合は、MCP サーバーとして公開 を参照してください。

​

MCP サーバーへの接続

HTTP トランスポート を使用する MCP サーバーのみサポートされています。

URL、名前、一意のサーバー識別子を指定してサーバーを追加します。Dify が接続し、必要に応じて認証を行い、サーバーのツールをインポートするので、アプリから呼び出せます。後でツールリストを更新してサーバーの最新ツールを取得できますが、使用中のツールが削除または変更されると、そのツールを使うアプリが動作しなくなることがあります。

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

​

認証

動的クライアント登録（デフォルトでオン）を使うと、Dify がサーバーから OAuth 認証情報を自動的に取得するため、自分でアプリケーションを登録する必要はありません。サーバーが対応している限り、オンのままにします。サーバーが自動登録に対応していない場合や、チームの既存の OAuth アプリケーションを使う必要がある場合はオフにします。そのアプリケーションの Client ID と Client Secret を入力し、Dify が表示するリダイレクト URL を登録します。

​

詳細オプション

​

カスタムヘッダー

サーバーへのリクエストごとに追加の HTTP ヘッダーを送信します。静的トークンや API キーで認証するサーバー（例：Authorization: Bearer <token>）でよく使われますが、サーバーがカスタムヘッダーを必要とするあらゆる場面で利用できます。ヘッダーの値は動的にもできます。{{request.headers.X-Custom-Auth}} は、実行を開始した HTTP リクエスト（例：Service API 呼び出し）の X-Custom-Auth ヘッダーに、呼び出し時点で置き換えられます。これにより、各呼び出し元の認証情報をサーバーへ引き渡せます。リクエストに該当するヘッダーがない場合は空の値になり、元となる HTTP リクエストがない実行では、プレースホルダーのテキストがそのまま送信されます。

​

タイムアウト

Dify がサーバーを待つ時間を制御します。サーバーの応答が遅い場合はリクエストのタイムアウトを、長時間のストリーミング結果には SSE 読み取りタイムアウトを延ばします。タイムアウトエラーが出る場合のみ変更してください。