Referensi perintah Agen 365 CLI develop-mcp

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

Note

develop-mcp approvePerintah , develop-mcp block, dan develop-mcp package-mcp-server dihapus dari CLI Agen 365. Administrator penyewa sekarang melakukan persetujuan dan pemblokiran server di pusat admin Microsoft — permintaan yang tertunda ditinjau di halaman Requested Agents. CLI tidak lagi menghasilkan paket server MCP untuk pengiriman Pusat Admin; Admin bergabung dan mengelola server langsung di pusat admin.

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.

Saat Anda menerbitkan, CLI membuat pendaftaran aplikasi <server-name>-PublicClients Microsoft Entra di penyewa Anda. Aplikasi ini memegang izin OAuth yang digunakan host klien (seperti Visual Studio Code dan Microsoft 365 Copilot CLI) untuk memanggil server MCP yang diterbitkan. Karena perintah membuat pendaftaran aplikasi, akun yang menjalankan CLI harus memiliki izin Application.ReadWrite.All Microsoft Graph. Berlari publish tanpa itu gagal.

Note

Menyediakan --publisher-name server MCP kustom (buatan pengguna). Nilai ditulis ke metadata pengembang paket yang diterbitkan dan diperlukan untuk server ini. Ini diabaikan untuk server milik Microsoft pihak pertama (misalnya, msdyn_DataverseMCPServer), yang selalu diterbitkan sebagai "Microsoft". Saat Anda menghilangkannya, CLI memintanya secara interaktif; pass --yes untuk menerbitkan tanpa perintah dalam konteks CI atau skrip.

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
-p, --publisher-name <publisher-name>	Nama Publisher yang ditulis ke metadata paket yang diterbitkan. Diperlukan untuk server MCP kustom (buatan pengguna); diabaikan untuk server milik Microsoft pihak pertama. Diminta secara interaktif saat dihilangkan.
-y, --yes	Lewati interaktif "Lanjutkan dengan publikasi? (y/N)" confirmation. Gunakan dalam konteks CI atau skrip.
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -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 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
-l, --secret-lifetime-months <months>	Seumur hidup dalam bulan (1-24) untuk rahasia klien yang dihasilkan pada aplikasi Entra yang dibuat. Default ke 24 bulan (2 tahun). Tetapkan nilai yang lebih kecil dari appManagementPolicies batas di penyewa Anda jika kebijakan penyewa Anda memberlakukan maksimum yang lebih pendek
--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