Panduan Pengguna OpenAPI MCP Server - OpenAPI Explorer

Model Context Protocol (MCP) adalah protokol antarmuka standar yang menghubungkan model besar dengan alat eksternal atau sumber data. Mirip dengan port USB-C, protokol ini memungkinkan berbagai alat—seperti database dan API—terhubung ke model besar secara seragam tanpa memerlukan kode adaptor terpisah. MCP menggunakan arsitektur klien-server untuk memusatkan logika pemanggilan alat di sisi server. Model besar hanya perlu mengirim permintaan melalui protokol terpadu guna memanggil berbagai fungsi secara fleksibel. Alibaba Cloud OpenAPI Explorer telah meluncurkan OpenAPI MCP Server yang mendukung pemanggilan API untuk mengelola sumber daya cloud dalam model besar. Topik ini menjelaskan cara membuat dan menggunakan layanan MCP.

Buat layanan MCP

Catatan

Jika Anda menggunakan pengguna Resource Access Management (RAM) yang tidak memiliki izin administrator, Anda harus memberikan izin yang diperlukan kepada pengguna RAM tersebut. Untuk informasi selengkapnya, lihat Memberikan izin kepada pengguna RAM untuk mengoperasikan MCP Server.

Buka halaman Layanan MCP OpenAPI Alibaba Cloud, klik tab Buat Layanan MCP, lalu masukkan informasi berikut:

Catatan

Karena keterbatasan panjang konteks dan presisi pemilihan alat pada model besar, jumlah API yang dapat Anda pilih untuk MCP Server juga dibatasi. Anda dapat memilih maksimal 30 API untuk satu MCP Server. Untuk menggunakan lebih banyak API, buat beberapa MCP Server.

Item Konfigurasi	Deskripsi
Nama	3–16 karakter, hanya boleh berisi karakter `a-z0-9_-`. Contohnya: mcp-demo.
Bahasa Dokumen	Pilih bahasa untuk deskripsi API dalam Alat.
Konfigurasi OAuth	OAuth Resmi Alibaba Cloud: Cocok untuk klien lokal, seperti Tongyi Lingma, Cherry Studio, dan Cursor. Catatan Menggunakan akun administrator, buka Konsol RAM > Aplikasi OAuth > Aplikasi Pihak Ketiga untuk menginstal dan menetapkan aplikasi resmi OpenAPI MCP Server. Jika tidak, Anda tidak dapat melakukan otorisasi OAuth untuk layanan MCP yang Anda buat. Untuk informasi selengkapnya, lihat Instal dan otorisasi aplikasi pihak ketiga. OAuth Kustom: Cocok untuk platform yang dibangun sendiri dan layanan pihak ketiga, seperti Dify yang dideploy sendiri, AgentScope, dan Claude Web/Mobile.
MCP Multi-akun	Kelola MCP Server secara terpusat dalam skenario multi-akun. Untuk informasi selengkapnya, lihat Cara menggunakan OpenAPI MCP Server dalam skenario multi-akun.
Layanan Alibaba Cloud dan Daftar API	Konfigurasikan Alat API untuk layanan MCP. Anda hanya dapat memilih API untuk satu Layanan Alibaba Cloud sekaligus. Untuk memilih API dari beberapa Layanan Alibaba Cloud, klik Tambahkan Layanan Alibaba Cloud dan API setelah mengonfirmasi pilihan Anda. Untuk menambahkan lebih banyak API untuk Layanan Alibaba Cloud yang dipilih, klik Tambahkan API.
Alat Terraform	Definisikan Alat MCP menggunakan kode HCL Terraform. Untuk informasi selengkapnya, lihat Cara menggunakan Alat Terraform di OpenAPI MCP Server. Catatan Alat Terraform hanya mendukung pembuatan sumber daya, bukan modifikasi sumber daya.
Alat Sistem	Alat Sistem adalah alat resmi yang telah ditentukan sebelumnya. Setelah Anda memilihnya, Alat Sistem akan diintegrasikan ke dalam layanan MCP.
Keterangan	Tambahkan deskripsi untuk layanan MCP.

Klik Create dan konfirmasi Risk Prompt. Setelah pembuatan selesai, Anda akan menerima Titik Akhir HTTP Streamable, Titik Akhir SSE, dan konfigurasi klien MCP yang diperlukan untuk menghubungkan klien ke layanan MCP.

Konfigurasi MCP

Anda dapat menggunakan MCP di klien umum seperti Cherry Studio, Cursor, Tongyi Lingma, dan Cline. Rujuk metode konfigurasi untuk klien spesifik Anda.

Catatan

Jika Anda menggunakan MCP di Dify, lihat Integrasikan OpenAPI MCP Server di Dify.

Konfigurasi satu-klik

Catatan

Anda harus menginstal Cherry Studio atau Cursor terlebih dahulu.

Jika Anda menggunakan MCP di Cherry Studio atau Cursor, Anda dapat memanfaatkan fitur resmi Konfigurasi satu-klik untuk mengonfigurasi MCP.

Konfigurasi manual

Cherry Studio

Catatan

Pastikan Cherry Studio telah diinstal.

Konfigurasikan layanan model di Cherry Studio.
1. Gunakan model `qwen3-235b-a22b` dari Alibaba Cloud Model Studio.
  Kunci API dibuat di Konsol Model Studio. Alamat API adalah https://dashscope.aliyuncs.com/compatible-mode/v1/.
2. Setelah menambahkan model, edit untuk mengonfigurasi kemampuan seperti jaringan, inferensi, dan alat.
Konfigurasikan server MCP.
1. Tambahkan server di Settings > MCP Server.
2. Konfigurasikan server MCP. Masukkan nama, pilih Streamable HTTP sebagai tipe, dan untuk URL, masukkan Titik Akhir HTTP Streamable yang diberikan saat Anda membuat layanan MCP.
3. Mengklik Simpan akan mengarahkan Anda ke halaman otorisasi OAuth Alibaba Cloud. Tinjau informasi otorisasi, lalu klik Authorize. Untuk informasi selengkapnya tentang OAuth, lihat Manajemen OAuth.
  Catatan
  Anda harus memberikan izin operasi API yang diperlukan kepada pengguna RAM yang berpartisipasi dalam otorisasi sebelumnya. Jika tidak, kesalahan izin mungkin terjadi. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
  Setelah otorisasi selesai, Cherry Studio secara otomatis memulai layanan MCP.

Cursor

Catatan

Pastikan Cursor telah diinstal. Contoh ini menggunakan Edisi Gratis Cursor. Anda dapat mengunduh versi yang sesuai dengan kebutuhan Anda.

Di bilah menu Cursor, buka File > Preferences > Cursor Settings > Tools & Integrations, lalu klik Tambahkan MCP Kustom untuk mengonfigurasi Server MCP.
Salin konten dari metode konfigurasi Server MCP, tempelkan ke file `mcp.json`, lalu tekan `Ctrl+S` untuk menyimpan.
Selesaikan otorisasi di halaman OAuth. Untuk informasi selengkapnya tentang OAuth, lihat Manajemen OAuth.
Catatan
Anda harus memberikan izin operasi API yang diperlukan kepada pengguna RAM yang berpartisipasi dalam otorisasi sebelumnya. Jika tidak, kesalahan izin mungkin terjadi. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
Anda dapat melihat informasi Server MCP yang dikonfigurasi di Pengaturan Cursor.

Tongyi Lingma

Catatan

Pastikan Tongyi Lingma telah diinstal.

Buka plugin Tongyi Lingma dan klik Alat MCP di halaman perkenalan.
Di pojok kanan atas jendela pop-up, klik ikon + dan pilih Tambah Manual.

Di jendela Tambah Layanan MCP, masukkan informasi berikut. Setelah memasukkan parameter, klik Tambah Sekarang.

Nama	Nama layanan MCP. Disarankan agar sama dengan nama layanan MCP virtual.
Tipe	Tetap menjadi `STDIO`.
Perintah	Tetap menjadi `npx`.
Parameter	Formatnya adalah `mcp-remote-alibaba-cloud <SSE Endpoint>`. Catatan Hanya Titik Akhir SSE yang didukung. Anda dapat memperoleh Titik Akhir SSE dari hasil yang dikembalikan saat membuat layanan MCP virtual.

Selesaikan otorisasi di halaman OAuth. Untuk informasi selengkapnya tentang OAuth, lihat Manajemen OAuth.
Catatan
Anda harus memberikan izin operasi API yang diperlukan kepada pengguna RAM yang berpartisipasi dalam otorisasi sebelumnya. Jika tidak, kesalahan izin mungkin terjadi. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
Gambar berikut menunjukkan hasil mengaktifkan MCP di Tongyi Lingma:

Cline

Catatan

Pastikan plugin Cline telah diinstal. Topik ini menggunakan VS Code sebagai contoh. Untuk informasi selengkapnya, lihat Cline.

Buka plugin Cline di VS Code dan masukkan kunci API Anda.
Di bilah menu atas Cline, klik Server MCP untuk mengonfigurasi Server MCP.
Selesaikan otorisasi di halaman OAuth. Untuk informasi selengkapnya tentang OAuth, lihat Manajemen OAuth.
Catatan
Anda harus memberikan izin operasi API yang diperlukan kepada pengguna RAM yang berpartisipasi dalam otorisasi sebelumnya. Jika tidak, kesalahan izin mungkin terjadi. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
Setelah otorisasi selesai, konfigurasi berhasil jika Server MCP yang baru dikonfigurasi muncul di bagian Server MCP di bagian bawah Cline.

Inspector

Catatan

Bagian ini memberikan pengantar singkat. Untuk informasi selengkapnya tentang Inspector, lihat Inspector.
Versi Node.js Anda harus 22.7.5 atau lebih baru.

Di terminal, jalankan perintah berikut untuk memulai Inspector. Setelah layanan dimulai, Anda dapat mengaksesnya di http://localhost:6274 secara default.
```
npx @modelcontextprotocol/inspector
```
Di sisi kiri antarmuka pengguna Inspector, pilih Jenis Transportasi. Contoh ini menggunakan Streamable HTTP. Di kolom URL, masukkan Titik Akhir HTTP Streamable yang diberikan saat Anda membuat layanan MCP, lalu klik Connect.
Selesaikan otorisasi di halaman OAuth. Untuk informasi selengkapnya tentang OAuth, lihat Manajemen OAuth.
Catatan
Anda harus memberikan izin operasi API yang diperlukan kepada pengguna RAM yang berpartisipasi dalam otorisasi sebelumnya. Jika tidak, kesalahan izin mungkin terjadi. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
Setelah otorisasi selesai, Anda dapat melihat informasi alat untuk Server MCP di antarmuka pengguna Inspector.
Anda dapat mengklik alat apa pun untuk melihat detailnya di sebelah kanan. Anda juga dapat mengatur parameter untuk memanggil alat tersebut.

Gunakan MCP

Setelah dikonfigurasi, Anda dapat menggunakan MCP untuk mengelola sumber daya cloud Anda. Untuk informasi selengkapnya, lihat Lebih banyak cara mengintegrasikan MCP.

Cherry Studio

Dari menu kotak input teks, pilih server MCP.
Uji fitur MCP. Misalnya, Anda dapat mengkueri jumlah instance ECS di suatu wilayah:
```
Harap kueri daftar instance ECS di wilayah cn-chengdu dan atur x_mcp_region_id.
```
Catatan
Hasilnya akurat jika MCP memilih API yang benar dan parameter permintaan dikonfigurasi dengan benar. Jika terjadi kesalahan, Anda dapat mencoba menyetel ulang MCP untuk mengatasi masalah tersebut.

Cursor

Pilih model dan kunci API. Karena Cursor memiliki persyaratan khusus untuk penyedia Large Language Model (LLM), lihat Penyedia yang didukung untuk informasi selengkapnya. Contoh ini menggunakan nilai default.
Di kotak dialog Cursor, klik Tambah Konteks dan pilih Server MCP.
Di kotak dialog, masukkan kueri bahasa alami untuk menguji fitur MCP. Misalnya, masukkan "Harap kueri jumlah instance ECS di wilayah Chengdu dan tampilkan hanya jumlah instance." lalu tekan Enter. Saat diminta, klik Jalankan alat untuk melanjutkan.
Lihat hasil eksekusi MCP. Hasilnya akurat jika MCP memilih API yang benar dan parameter permintaan dikonfigurasi dengan benar. Jika terjadi kesalahan, Anda dapat mencoba menyetel ulang MCP untuk mengatasi masalah tersebut.

Tongyi Lingma

Di Tongyi Lingma, pilih Agen dan masukkan prompt. Misalnya, untuk mengkueri daftar instance ECS di wilayah Chengdu, Anda harus mengatur `x_mcp_region_id`.
Ikuti petunjuk di Tongyi Lingma untuk menjalankan alat MCP.
Lihat hasilnya. Hasilnya akurat jika alat MCP yang benar dipilih dan parameter permintaan API dikonfigurasi dengan benar. Jika terjadi kesalahan, Anda dapat mencoba menyetel ulang MCP untuk mengatasi kesalahan tersebut.

Cline

Di jendela dialog Cline, masukkan kueri bahasa alami untuk menguji fitur MCP. Misalnya, masukkan "Harap kueri jumlah instance ECS di wilayah Chengdu."
Gambar menunjukkan bahwa Cline menggunakan Server MCP yang dikonfigurasi dan memilih alat `DescribeInstances`. Nilai untuk parameter `RegionId` juga diambil dari input.
Tinjau hasil eksekusi MCP. Hasilnya akurat jika MCP memilih API yang benar dan parameter permintaan dikonfigurasi dengan benar. Jika terjadi kesalahan, Anda dapat mencoba menyetel ulang MCP untuk mengatasi masalah tersebut.

Penyetelan MCP

Jika model besar memberikan tanggapan yang tidak akurat berdasarkan MCP, Anda dapat meningkatkan pemahamannya tentang fitur API. Anda dapat memodifikasi ikhtisar API, deskripsi, atau deskripsi parameter permintaan di sisi server. Contoh berikut menunjukkan cara menyetel MCP.

Contoh 1: Kesalahan atau data tidak akurat saat mengoperasikan sumber daya di luar wilayah cn-hangzhou

MCP menggunakan `x_mcp_region_id` untuk mengganti titik akhir. Jika model besar gagal memahami dari input Anda bahwa ia harus melewatkan `x_mcp_region_id`, maka secara default ia akan mengoperasikan sumber daya di wilayah `cn-hangzhou`.

Anda dapat mengatasi masalah ini dengan salah satu dari dua cara berikut:

Beri tahu secara eksplisit model besar untuk mengatur `x_mcp_region_id` dalam prompt Anda.
```
Kueri daftar instance ECS untuk regionId cn-qingdao, dan atur x_mcp_region_id.
```
Sesuaikan ikhtisar API atau deskripsi parameter `RegionId` di server MCP.
Misalnya, tambahkan "Teruskan wilayah yang ditentukan pengguna ke `x_mcp_region_id`" ke ikhtisar API. Atau, tambahkan "Jika parameter `RegionId` ada, parameter tersebut harus dilewatkan bersama dengan `x_mcp_region_id`" ke deskripsi `RegionId`.
Prosedur:
1. Buka Layanan MCP Saya. Di kolom Tindakan, klik tombol Edit.
2. Pilih API yang akan disetel dan klik tombol Edit di kolom Tindakan.
3. Modifikasi ikhtisar, deskripsi permintaan API, atau deskripsi parameter API.
4. Setelah menyimpan perubahan, putuskan koneksi dari layanan MCP di klien, lalu sambungkan kembali agar perubahan berlaku.

Contoh 2: Menghapus parameter opsional dari API

Dokumen API mencakup parameter untuk semua skenario yang mungkin, tetapi beberapa parameter opsional mungkin tidak diperlukan dalam sebagian besar kasus penggunaan. Anda dapat menghapus parameter opsional ini di server MCP. Saat melewatkan parameter, model besar tidak akan "melihat" parameter yang dihapus. Hal ini mengurangi tingkat kesalahan model dan mengurangi penggunaan token.

Kontrol akses MCP

Agen AI yang diintegrasikan dengan OpenAPI MCP Server tidak memiliki identitas atau izin sendiri untuk mengakses Alibaba Cloud. Agen harus dipicu oleh pengguna dan bertindak sebagai proksi untuk melakukan operasi cloud atas nama pengguna. Misalnya, klien memulai alur OAuth. Setelah pengguna memberikan otorisasi, agen memperoleh izin akses sementara. Karena semua operasi memerlukan otorisasi pengguna, tindakan agen dibatasi oleh izin pengguna. Metode ini mencapai prinsip hak istimewa minimal. Selain itu, ActionTrail mencatat pengguna mana yang melakukan setiap operasi karena operasi tersebut dieksekusi di bawah identitas pengguna.

Agen yang berlaku: CherryStudio, Tongyi Lingma, Qwen Code, Cursor, Claude Code, Dify, AgentScope, LangGraph, dan lainnya.

FAQ

1. Dapatkah klien MCP memanggil semua API di Alat?

Pemanggilan tidak selalu berhasil. Keberhasilan bergantung pada izin pengguna Resource Access Management (RAM). Jika pengguna RAM tidak memiliki izin untuk memanggil API, model besar juga tidak dapat memanggil API tersebut.

Untuk mengatasi hal ini, berikan izin API yang diperlukan kepada pengguna RAM. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.

Penting

Jangan berikan izin kepada pengguna RAM untuk menghapus sumber daya. Hal ini mencegah model besar salah memahami permintaan dan memanggil API penghapusan, yang dapat melepaskan sumber daya dan berdampak buruk pada bisnis Anda.

2. Pengguna RAM menerima kesalahan 'izin ditolak untuk operasi MCP' saat membuat MCP Server.

Solusi:

Berikan kebijakan sistem `AliyunOpenAPIMCPServerFullAccess` kepada pengguna RAM. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.
Berikan kebijakan kustom kepada pengguna RAM:
1. Hubungi administrator untuk membuat kebijakan kustom di Konsol RAM. Untuk informasi selengkapnya, lihat Buat kebijakan kustom.
  Isi kebijakan adalah sebagai berikut:
  Kebijakan akses untuk operasi MCP Server
  Kebijakan ini memberikan izin untuk membuat, memperbarui, mengkueri, dan menghapus MCP Server. Kebijakan ini juga memberikan izin untuk mengkueri alat sistem MCP.
```
{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "openapiexplorer:*Mcp*",
        "ram:*Application*"
      ],
      "Resource": "*",
      "Effect": "Allow"
    }
  ]
}
```
2. Hubungi administrator untuk memberikan kebijakan kustom kepada pengguna RAM. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.

3. Jika titik akhir MCP Server terpapar, apakah siapa pun dapat menggunakannya?

Tidak, orang lain tidak dapat menggunakan titik akhir MCP Server yang terpapar. Saat titik akhir dimasukkan dan disimpan di klien, klien melakukan penemuan OAuth. Halaman login otorisasi untuk Konsol Manajemen Alibaba Cloud ditampilkan. Setelah otorisasi selesai, sistem memverifikasi bahwa Akun Alibaba Cloud yang memiliki MCP Server sama dengan Akun Alibaba Cloud yang dimiliki oleh pengguna RAM yang diotorisasi. MCP Server hanya dapat diakses jika akun tersebut cocok.

Lebih banyak cara mengintegrasikan MCP

OpenAPI MCP Server menggunakan konfigurasi aplikasi OAuth kustom untuk memberikan otorisasi. Fitur ini didukung di Dify 1.8.0 dan versi yang lebih baru. Untuk informasi selengkapnya, lihat Integrasikan OpenAPI MCP Server di Dify.
Anda dapat menyelesaikan alur otorisasi OAuth kustom menggunakan kit pengembangan perangkat lunak (SDK) MCP resmi dan membangun asisten percakapan menggunakan kerangka kerja agen utama. Untuk informasi selengkapnya, lihat Integrasikan OpenAPI MCP Server di agen.