すべてのプロダクト
Search

このプロダクト

    OpenAPI Explorer:Dify で OpenAPI MCP Server を統合する

    ドキュメントセンター

    OpenAPI Explorer:Dify で OpenAPI MCP Server を統合する

    最終更新日:Nov 10, 2025

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

    前提条件

    • Dify サーバーには、少なくとも 2 CPU コアと 4 GiB の RAM が必要です。

    • Dify バージョン 1.8.0 以降。

    手順

    1. Dify サーバーをセットアップする

    この例では、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 アプリケーションの Webhook アドレスと同じである必要があります。

      設定項目

      値

      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 サーバーを起動します。

      # Dify を停止
# docker compose down 
# Dify を起動
docker compose up -d

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

      image

    2. OAuth アプリケーションを作成する

    OAuth アプリケーション用の Resource Access Management (RAM) コンソールでアプリケーションを作成します。情報を入力する際は、次の点に注意してください。

    設定項目

    説明

    OAuth プロトコルバージョン

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

    アプリケーションタイプ

    Web アプリケーションまたはネイティブアプリケーションを選択します。

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

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

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

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

    Webhook アドレス

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

    OAuth スコープ

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

    image

    3. OpenAPI MCP Server を作成する

    Alibaba Cloud OpenAPI MCP サービスで MCP Server を作成する際、OAuth 構成をカスタム OAuth に設定し、作成した OAuth アプリケーションを選択します。既存の MCP Server を使用している場合は、その OAuth 構成をカスタム OAuth に変更し、作成した OAuth アプリケーションを選択します。カスタム OAuth を選択すると、OpenAPI MCP Server はこの OAuth アプリケーションを使用して権限付与を完了します。認証コードは、自己デプロイした Dify サービスに送信されます。

    image

    4. Dify で OpenAPI MCP Server を追加する

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

    2. [ツール] > [MCP] ページで、MCP サービスを追加します。Server URL には、Alibaba Cloud OpenAPI MCP Server によって提供される Streamable HTTP Endpoint を入力します。

      image

      サービスを追加した後、自動権限付与が完了するのを待ちます。次のメッセージが表示された場合、Alibaba Cloud OpenAPI MCP Server が Dify に正常に追加されたことを示します。

      image

    5. Dify でモデルを構成する

    Dify は、Qwen、DeepSeek、OpenAI の GPT シリーズなど、主要なモデルプロバイダーをサポートしています。詳細については、「大規模言語モデルに接続する」をご参照ください。

    1. 右上隅のプロファイル画像をクリックし、[設定] を選択します。

      image

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

      image

    3. インストールが完了したら、モデル設定を構成します。これには、API KEY、Dify のデフォルトのシステム推論モデル、および埋め込みモデルの設定が含まれます。

      説明

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

      image

    6. MCP 機能をテストする

    簡単な Agent アプリケーションを構築して、OpenAPI MCP Server の機能をテストします。

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

      image

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

      image

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

      image