すべてのプロダクト
Search

このプロダクト

    OpenAPI Explorer:Dify での OpenAPI MCP サーバーの統合

    ドキュメントセンター

    OpenAPI Explorer:Dify での OpenAPI MCP サーバーの統合

    最終更新日:Jan 20, 2026

    このトピックでは、Dify サーバーをセットアップし、カスタム OAuth アプリケーションの権限付与を使用して OpenAPI MCP サーバーを Dify に統合する方法について説明します。

    前提条件

    • Dify をホストするサーバーは、CPU コア 2 個、RAM 4 GiB という最小要件を満たす必要があります。

    • Dify のバージョンは 1.8.0 以降である必要があります。

    操作手順

    1. Dify サーバーのセットアップ

    この例では、Elastic Compute Service (ECS) インスタンス上に Dify サーバーをセットアップする方法を示します。

    1. ECS インスタンスに Docker をインストールします。

    2. 次のコマンドを実行して Dify コードをダウンロードします。

      git clone https://github.com/langgenius/dify.git

    3. 次のコマンドを実行して Dify 設定ファイルを作成します。

      cd dify/docker
cp .env.example .env
vim .env

      .env 設定ファイルで、次の設定項目を見つけてその値を設定します。

      説明

      ここでの値は、OAuth アプリケーションのコールバック URI と同じである必要があります。

      設定項目

      値

      CONSOLE_API_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

      CONSOLE_WEB_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

      SERVICE_API_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

      APP_API_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

      APP_WEB_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

      FILES_URL

      http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>。ローカルデプロイメントの場合は、http://127.0.0.1 を使用します。

    4. 次のコマンドを実行して Dify サーバーを起動します。

      # プロジェクトのすべてのコンテナーとネットワークを停止して削除します。
docker compose down 
# バックグラウンド (デタッチモード) ですべてのサービスを作成して起動します。
docker compose up -d

      次の応答が表示された場合、Dify サーバーは正常に起動しています。エラーが発生した場合は、次の応答が表示されるまで docker compose up -d を再実行してください。

      image

    2. OAuth アプリケーションの作成

    Resource Access Management (RAM) コンソールで OAuth アプリケーションを作成します。パラメーターを設定する際は、次の点にご注意ください。

    パラメーター

    説明

    OAuth プロトコルバージョン

    2.1 である必要があります。

    アプリケーションタイプ

    Web アプリケーションまたはネイティブアプリケーションを選択します。このタイプは、Dify 統合のようなサーバー間の通信に必要です。

    アクセストークンの有効期間

    必要に応じてこの値を調整します。

    リフレッシュトークンの有効期間

    必要に応じてこの値を調整します。

    コールバックアドレス

    http://<ECS インスタンスのインターネット IP アドレスまたはドメイン名>/console/api/mcp/oauth/callback である必要があります。この値は、Dify の .env 設定ファイルの値と同じである必要があります。

    OAuth スコープ

    /acs/mcp-server である必要があります。

    image

    3. OpenAPI MCP サーバーの作成

    Alibaba Cloud OpenAPI MCP Server ページで MCP サーバーを作成する際に、OAuth 設定を カスタム OAuth に設定し、作成した OAuth アプリケーションを選択します。既存の MCP サーバーを使用している場合は、その OAuth 設定を カスタム OAuth に変更し、作成した OAuth アプリケーションを選択します。

    カスタム OAuth を選択すると、OpenAPI MCP Server はこの OAuth アプリケーションを使用して権限付与を完了します。認証コードは、セルフデプロイした Dify サーバーに送信されます。

    image

    4. Dify での MCP サーバーの追加

    1. ブラウザで、Dify のホームページアドレス http://<ECS インスタンスのインターネット IP アドレス> を入力します。指示に従って設定を完了し、Dify にログインします。

    2. [ツール] > [MCP] ページで、ご利用の MCP サーバーを追加します。[サーバー URL] には、Alibaba Cloud OpenAPI MCP Server が提供するストリーミング可能な HTTP エンドポイントを入力します。

      image

      サーバーを追加した後、自動権限付与が完了するまで待ちます。次のメッセージが表示されたら、ご利用の MCP サーバーが Dify に正常に追加されたことを示します。

      image

    5. Dify でのモデルの設定

    Dify は、Qwen、DeepSeek、OpenAI の GPT シリーズなどの主要なモデルをサポートしています。詳細については、「モデル設定の概要」をご参照ください。

    1. プロフィール写真をクリックし、[設定] をクリックします。

      image

    2. [モデルプロバイダー] セクションで、モデルをインストールします。この例では Qwen を使用します。Qwen の詳細については、「モデルの概要」をご参照ください。

      image

    3. インストールが完了したら、モデルの設定を行います。これには、API キー、Dify のデフォルトの推論モデル、埋め込みモデルの設定が含まれます。

      説明

      推論モデルは、qwen3-max-preview や DeepSeek-R1 など、ツール呼び出しをサポートするモデルである必要があります。

      image

    6. MCP サーバーのテスト

    シンプルな Agent アプリケーションを構築して、ご利用の MCP サーバーの機能をテストします。

    1. Agent アプリケーションを作成します。アプリケーションタイプとして必ず [Agent] を選択してください。

      image

    2. Agent アプリケーションで、ツールを追加します。Dify に追加した MCP サーバーを選択します。

      image

    3. [デバッグ & プレビュー] ページで、「杭州リージョンにある ECS インスタンスの数を照会」などの自然言語クエリを入力します。

      image