Referensi perintah Agen 365 CLI develop-mcp

Mengelola server MCP di lingkungan Dataverse. Perintah ini develop-mcp menyediakan opsi untuk menerbitkan, membatalkan publikasi, menyetujui, memblokir, mengemas, dan mendaftarkan server MCP untuk digunakan di lingkungan Dataverse.

Peran minimum yang diperlukan: Bervariasi menurut sub-perintah

Syntax

a365 develop-mcp [command] [options]

Opsi

Option	Description
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp list-environments

Mencantumkan semua lingkungan Dataverse yang tersedia untuk manajemen server MCP.

a365 develop-mcp list-environments [options]

Perintah ini menampilkan semua lingkungan Dataverse tempat Anda dapat mengelola server MCP.

list-environments Opsi

Option	Description
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp list-servers

Mencantumkan server MCP di lingkungan Dataverse tertentu.

a365 develop-mcp list-servers [options]

Perintah ini menunjukkan semua server MCP yang saat ini disebarkan di lingkungan Dataverse yang ditentukan.

list-servers Opsi

Option	Description
-e, --environment-id <environment-id>	ID lingkungan Dataverse
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp publish

Menerbitkan server MCP ke lingkungan Dataverse.

a365 develop-mcp publish [options]

Gunakan perintah ini untuk menerbitkan server MCP ke lingkungan Dataverse yang ditentukan.

publish Opsi

Option	Description
-e, --environment-id <environment-id>	ID lingkungan Dataverse
-s, --server-name <server-name>	Nama server MCP untuk diterbitkan
-a, --alias <alias>	Alias untuk server MCP
-d, --display-name <display-name>	Nama tampilan untuk server MCP
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp unpublish

Membatalkan penerbitan server MCP dari lingkungan Dataverse.

a365 develop-mcp unpublish [options]

Gunakan perintah ini untuk menghapus server MCP dari lingkungan Dataverse yang ditentukan.

unpublish Opsi

Option	Description
-e, --environment-id <environment-id>	ID lingkungan Dataverse
-s, --server-name <server-name>	Nama server MCP untuk membatalkan penerbitan
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp approve

Menyetujui server MCP.

a365 develop-mcp approve [options]

Perintah ini menyetujui server MCP untuk digunakan di lingkungan.

approve Opsi

Option	Description
-s, --server-name <server-name>	Nama server MCP untuk disetujui
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp block

Memblokir server MCP.

a365 develop-mcp block [options]

Gunakan perintah ini untuk memblokir server MCP agar tidak digunakan di lingkungan Anda.

block Opsi

Option	Description
-s, --server-name <server-name>	Nama server MCP untuk diblokir
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp package-mcp-server

Buat paket server MCP untuk pengiriman di pusat admin Microsoft.

a365 develop-mcp package-mcp-server [options]

Gunakan perintah ini untuk membuat paket penyebaran untuk server MCP yang dapat Anda kirimkan ke pusat admin Microsoft.

package-mcp-server Opsi

Option	Description
--server-name <server-name>	Nama server MCP (REQUIRED)
--developer-name <developer-name>	Nama tampilan penerbit atau pengembang (WAJIB)
--icon-url <icon-url>	URL Publik ke ikon PNG untuk server MCP (WAJIB)
--output-path <output-path>	Direktori target untuk paket ZIP yang dihasilkan (REQUIRED)
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

develop-mcp register-external-mcp-server

Daftarkan server MCP eksternal dengan Entra, OAuth eksternal, kunci API, atau tanpa autentikasi.

a365 develop-mcp register-external-mcp-server [options]

Gunakan perintah ini untuk mendaftarkan server MCP yang dihosting secara eksternal (pihak ketiga) dengan penyewa Anda. Perintah ini membuat pendaftaran aplikasi Microsoft Entra yang dibutuhkan platform, memanggil platform Agen 365 untuk menambahkan server MCP, dan mengonfigurasi URI pengalihan dan izin API pada pendaftaran aplikasi baru.

Nama server harus dimulai dengan ext_ awalan dan panjangnya paling banyak 20 karakter, misalnya ext_MyServer. Nama alat harus sama persis dengan nama yang diekspos oleh server MCP jarak jauh. Nama yang tidak cocok menyebabkan pemanggilan alat gagal saat runtime.

Anda dapat menyediakan parameter dengan tiga cara:

• Berikan mereka sebagai opsi baris perintah.
• Berikan file JSON dengan --input-file. Opsi baris perintah menggantikan nilai dari file. Lihat register-external-mcp-server-sample.json di templat CLI untuk struktur file.
• Hilangkan nilai yang diperlukan untuk diminta secara interaktif.

Setelah pendaftaran berhasil, minta administrator penyewa Anda untuk menyetujui server MCP baru sebelum agen dapat menggunakannya. Jika Anda mendaftar dengan ExternalOAuth, tambahkan juga URI pengalihan yang ditampilkan ke aplikasi IDP eksternal Anda.

Important

Jika pendaftaran gagal setelah pendaftaran aplikasi Microsoft Entra dibuat, aplikasi tidak akan dikembalikan secara otomatis. Hapus secara manual di portal Azure sebelum mencoba lagi.

register-external-mcp-server Opsi

Beberapa opsi hanya diperlukan untuk jenis autentikasi tertentu, seperti yang dijelaskan dalam kolom deskripsi.

Option	Description
-s, --server-name <server-name>	Nama server MCP. Harus dimulai dengan ext_ dan paling banyak 20 karakter, misalnya ext_MyServer
-u, --server-url <server-url>	URL server MCP jarak jauh. Harus berupa URL HTTP atau HTTPS yang valid
-a, --auth-type <auth-type>	Jenis autentikasi: EntraOAuth, ExternalOAuth, APIKey, atau NoAuth
--publisher <publisher>	Nama Publisher (digunakan dalam metadata paket)
--description <description>	Deskripsi server (digunakan dalam metadata paket)
--tools <tools>	Daftar nama alat yang dipisahkan koma yang diekspos oleh server ini, misalnya tool1,tool2,tool3
-f, --input-file <input-file>	Jalur ke file JSON dengan parameter pendaftaran
--remote-scopes <remote-scopes>	Cakupan untuk server MCP jarak jauh, misalnya api://{appId-guid}/{scopeName}. Digunakan dengan EntraOAuth
-t, --tenant-id <tenant-id>	Entra ID penyewa untuk pendaftaran aplikasi. Default ke penyewa saat ini az login
--service-tree-id <service-tree-id>	ID ServiceTree untuk pendaftaran aplikasi Entra. Wajib di penyewa perusahaan Microsoft
--idp-authorization-url <url>	URL otorisasi OAuth eksternal. Diperlukan saat --auth-typeExternalOAuth
--idp-token-url <url>	URL token OAuth eksternal. Diperlukan saat --auth-typeExternalOAuth
--idp-scopes <scopes>	Cakupan OAuth eksternal. Diperlukan saat --auth-typeExternalOAuth
--idp-client-id <client-id>	ID klien OAuth eksternal. Diperlukan saat --auth-typeExternalOAuth
--idp-client-secret <client-secret>	Rahasia klien OAuth eksternal. Diperlukan saat --auth-typeExternalOAuth
--api-key-location <location>	Lokasi kunci API: Header atau Query. Diperlukan saat --auth-typeAPIKey
--api-key-name <name>	Parameter kunci API atau nama header, misalnya X-API-Key atau token. Diperlukan saat --auth-typeAPIKey
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan