OpenAPI Explorer：Integrasikan server OpenAPI MCP ke dalam Dify

1. Siapkan server Dify

Contoh ini menunjukkan cara menyiapkan server Dify pada instans Elastic Compute Service (ECS).

1. Instal Docker pada instans ECS.

2. Jalankan perintah berikut untuk mengunduh kode Dify:

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

3. Jalankan perintah berikut untuk membuat file konfigurasi Dify:

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

   Pada file konfigurasi .env, temukan item konfigurasi berikut dan atur nilainya:

   Catatan

   Nilai-nilai tersebut harus sama dengan callback URIs pada Aplikasi OAuth.

   Item konfigurasi	Nilai
   CONSOLE_API_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.
   CONSOLE_WEB_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.
   SERVICE_API_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.
   APP_API_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.
   APP_WEB_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.
   FILES_URL	http://<alamat IP Internet atau nama domain instans ECS>. Untuk penerapan lokal, gunakan http://127.0.0.1.

4. Jalankan perintah berikut untuk memulai server Dify:

   # Menghentikan dan menghapus semua kontainer serta jaringan untuk proyek.
   docker compose down 
   # Membuat dan menjalankan semua layanan di latar belakang (mode detached).
   docker compose up -d

   Jika respons berikut muncul, server Dify telah berhasil dijalankan. Jika terjadi error, jalankan ulang docker compose up -d hingga respons tersebut muncul.

   

2. Buat aplikasi OAuth

Buat aplikasi OAuth di Konsol Resource Access Management (RAM). Perhatikan hal-hal berikut saat mengonfigurasi parameter:

3. Buat server OpenAPI MCP

Saat membuat server MCP di halaman Alibaba Cloud OpenAPI MCP Server, atur OAuth configuration ke Custom OAuth dan pilih aplikasi OAuth yang telah Anda buat. Jika menggunakan server MCP yang sudah ada, ubah konfigurasi OAuth-nya menjadi Custom OAuth dan pilih aplikasi OAuth yang telah Anda buat.

Setelah memilih Custom OAuth, OpenAPI MCP Server akan menggunakan aplikasi OAuth tersebut untuk menyelesaikan otorisasi. Server tersebut mengirimkan kode otorisasi ke server Dify yang Anda terapkan sendiri.

4. Tambahkan server MCP di Dify

1. Buka browser, masukkan alamat beranda Dify: http://<alamat IP Internet instans ECS>. Ikuti petunjuk untuk menyelesaikan konfigurasi, lalu login ke Dify.

2. Pada halaman Tools > MCP, tambahkan server MCP Anda. Untuk Server URL, masukkan Streamable HTTP endpoint yang disediakan oleh Alibaba Cloud OpenAPI MCP Server.

   

   Setelah menambahkan server, tunggu hingga otorisasi otomatis selesai. Jika pesan berikut muncul, artinya server MCP Anda telah berhasil ditambahkan ke Dify.

   

5. Konfigurasikan model di Dify

Dify mendukung berbagai model utama, seperti Qwen, DeepSeek, dan seri GPT dari OpenAI. Untuk informasi selengkapnya, lihat Ikhtisar konfigurasi model.

1. Klik gambar profil Anda, lalu klik Settings.

   

2. Pada bagian Model Provider, instal model. Contoh ini menggunakan Qwen. Untuk informasi selengkapnya tentang Qwen, lihat Ikhtisar model.

   

3. Setelah instalasi selesai, konfigurasikan pengaturan model, termasuk kunci API, model penalaran default untuk Dify, dan model penyematan.

   Catatan

   Model penalaran harus merupakan model yang mendukung pemanggilan alat, seperti qwen3-max-preview atau DeepSeek-R1.

   

6. Uji server MCP

Uji fungsi server MCP Anda dengan membangun aplikasi Agent yang sederhana.

1. Buat aplikasi Agent dan pastikan memilih Agent sebagai tipe aplikasi.

   

2. Pada aplikasi Agent, tambahkan tool dan pilih server MCP yang telah Anda tambahkan ke Dify.

   

3. Pada halaman Debug & Preview, masukkan kueri bahasa alami, misalnya "Query jumlah instans ECS di wilayah Hangzhou."