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 evaluate

Evaluasi server MCP Anda terhadap praktik terbaik ilmiah untuk menilai kesiapan produksi. Alat ini menghasilkan laporan evaluasi yang komprehensif dengan skor, penjelasan, dan item tindakan. Perintah ini menemukan alat yang diekspos oleh server MCP, menjalankan serangkaian pemeriksaan semantik deterministik dan skor AI terhadap skema mereka, dan menghasilkan laporan HTML yang menilai kualitas skema dan mencantumkan item tindakan yang diprioritaskan untuk perbaikan.

a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]

evaluate Opsi

Option	Description
-u, --server-url <server-url>	Required. URL endpoint HTTP server MCP yang dapat di-stream (biasanya diakhiri dengan /mcp).
--auth-token <auth-token>	Optional. Hanya diperlukan ketika server MCP memerlukan otentikasi. Token pembawa untuk server. Lebih suka A365_MCP_AUTH_TOKEN variabel lingkungan; token yang diteruskan pada baris perintah terlihat untuk memproses daftar dan riwayat shell.
-o, --output-dir <output-dir>	Direktori untuk daftar periksa dan file laporan. Default ke direktori saat ini (.).
--eval-engine <eval-engine>	Agen pengkodean lokal mana yang menilai pemeriksaan semantik: auto (default; coba GitHub Copilot, lalu Claude Code), github-copilot, claude-code, atau none (lewati penilaian AI dan harapkan daftar periksa yang telah dinilai sebelumnya).
-v, --verbose	Aktifkan pengelogan verbose.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

evaluate contoh

Mengevaluasi server lokal dengan pemilihan mesin otomatis:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

Evaluasi server yang diautentikasi, dengan token yang disediakan melalui variabel lingkungan dan artefak yang ditulis ke subfolder:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Buat daftar periksa saja, lalu nilai dengan LLM Anda sendiri:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Memaksa mesin penilaian tertentu:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Pelajari cara mengevaluasi server MCP

variabel lingkungan evaluate

Gunakan variabel lingkungan berikut untuk memberikan autentikasi dan secara opsional mengontrol model mana yang digunakan setiap mesin penilaian lokal.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Token pembawa untuk server MCP, digunakan saat --auth-token tidak diteruskan. Disukai daripada bendera karena menjauhkan token dari daftar proses dan riwayat shell.
A365_EVAL_COPILOT_MODEL	Ganti model GitHub Copilot. Memerlukan ID model yang tepat, misalnya claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Ganti model Claude Code. Menerima alias model (misalnya haiku) atau ID model lengkap.

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 ketika --auth-type adalah ExternalOAuth
--idp-token-url <url>	URL token OAuth eksternal. Diperlukan ketika --auth-type adalah ExternalOAuth
--idp-scopes <scopes>	Cakupan OAuth eksternal. Diperlukan ketika --auth-type adalah ExternalOAuth
--idp-client-id <client-id>	ID klien OAuth eksternal. Diperlukan ketika --auth-type adalah ExternalOAuth
--idp-client-secret <client-secret>	Rahasia klien OAuth eksternal. Diperlukan ketika --auth-type adalah ExternalOAuth
--api-key-location <location>	Lokasi kunci API: Header atau Query. Diperlukan ketika --auth-type adalah APIKey
--api-key-name <name>	Parameter kunci API atau nama header, misalnya X-API-Key atau token. Diperlukan ketika --auth-type adalah APIKey
--dry-run	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, -h, --help	Perlihatkan bantuan dan informasi penggunaan