Aracı 365 CLI develop-mcp komut başvurusu

Dataverse ortamlarında MCP sunucularını yönetme. Komut, develop-mcp Dataverse ortamlarında kullanılmak üzere MCP sunucularını yayınlama, yayınlamaya kaldırma ve kayıt seçenekleri sunar.

Note

develop-mcp approve, develop-mcp block, ve develop-mcp package-mcp-server komutları Agent 365 CLI'dan kaldırılmıştır. Kiracı yöneticileri artık Microsoft yönetim merkezinde sunucu onay ve engelleme işlemlerini gerçekleştiriyor — bekleyen talepler Istenen Ajanlar sayfasında inceleniyor. CLI artık Yönetici Merkezi gönderimi için MCP sunucu paketleri üretmiyor; yöneticiler, sunucuları doğrudan yönetim merkezinde yönetir ve entegre eder.

Gereken en düşük rol: Alt komutla değişir

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

develop-mcp list-environments

MCP sunucu yönetimi için kullanılabilen tüm Dataverse ortamlarını listeleyin.

a365 develop-mcp list-environments [options]

Bu komut, MCP sunucularını yönetebileceğiniz tüm Dataverse ortamlarını görüntüler.

list-environments Seçenekler

Option	Description
--dry-run	Yürütme olmadan neler yapılacağını göster
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

develop-mcp list-servers

McP sunucularını belirli bir Dataverse ortamında listeleyin.

a365 develop-mcp list-servers [options]

Bu komut, şu anda belirtilen Dataverse ortamında dağıtılan tüm MCP sunucularını gösterir.

list-servers Seçenekler

Option	Description
-e, --environment-id <environment-id>	Dataverse ortamı kimliği
--dry-run	Yürütme olmadan neler yapılacağını göster
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

develop-mcp publish

McP sunucusunu Dataverse ortamına yayımlama.

a365 develop-mcp publish [options]

Belirtilen Dataverse ortamına bir MCP sunucusu yayımlamak için bu komutu kullanın.

Yayınladığınızda, CLI kiracınızda <server-name>-PublicClients Microsoft Entra uygulama kaydı oluşturur. Bu uygulama, istemci barındırmalarının (örneğin Visual Studio Code ve Microsoft 365 Copilot CLI) yayımlanan MCP sunucusunu çağırmak için kullandığı OAuth izinlerini taşır. Komut bir uygulama kaydı oluşturduğu için, CLI'yi çalıştıran hesabın Application.ReadWrite.All Microsoft Graph iznine sahip olması gerekir. Onsuz koşmak publish başarısız olur.

Note

Özel (kullanıcı tarafından oluşturulan) MCP sunucuları için bir şeyler oluşturun --publisher-name . Değer, yayımlanan paketin geliştirici meta verilerine yazılır ve bu sunucular için gereklidir. Birinci parti Microsoft sahip olduğu sunucular (örneğin, msdyn_DataverseMCPServer) için bu durum göz ardı edilir; onlar her zaman "Microsoft" olarak yayınlanır. Bunu çıkardığınızda, CLI bunu etkileşimli olarak ister; Gönderi veya betikli bağlamlarda prompt olmadan yayın yapmayı başarır --yes .

publish Seçenekler

Option	Description
-e, --environment-id <environment-id>	Dataverse ortamı kimliği
-s, --server-name <server-name>	Yayımlayacak MCP sunucusu adı
-a, --alias <alias>	MCP sunucusunun diğer adı
-d, --display-name <display-name>	MCP sunucusunun görünen adı
-p, --publisher-name <publisher-name>	Publisher adı, yayımlanan paket meta verilerine yazılmıştır. Özel (kullanıcı tarafından oluşturulan) MCP sunucuları için gereklidir; birinci parti Microsoft sahipli sunucular için göz ardı ediliyor. Atıldığında etkileşimli olarak sorgulandı.
-y, --yes	Etkileşimli "Yayınla devam et? (y/N)" confirmation. CI veya scripted bağlamlarda kullanım.
--dry-run	Yürütme olmadan neler yapılacağını göster
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

develop-mcp unpublish

McP sunucusunu Dataverse ortamından yayımdan kaldırın.

a365 develop-mcp unpublish [options]

Belirtilen Dataverse ortamından bir MCP sunucusunu kaldırmak için bu komutu kullanın.

unpublish Seçenekler

Option	Description
-e, --environment-id <environment-id>	Dataverse ortamı kimliği
-s, --server-name <server-name>	Yayımdan kaldırılacak MCP sunucusu adı
--dry-run	Yürütme olmadan neler yapılacağını göster
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

develop-mcp register-external-mcp-server

Entra, harici OAuth, API anahtarı veya kimlik doğrulama olmadan harici bir MCP sunucusu kaydedin.

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

Bu komutu kullanarak harici olarak barındırılan (üçüncü taraf) MCP sunucusunu kiracınıza kaydedebilirsiniz. Komut, platformun ihtiyaç duyduğu Microsoft Entra uygulama kayıtlarını oluşturur, MCP sunucusunu eklemek için Agent 365 platformunu çağırır ve yeni uygulama kayıtlarında yönlendirme URI'leri ile API izinlerini yapılandırır.

Sunucu adı ön ext_ ekle başlamalı ve en fazla 20 karakter uzunluğunda olmalıdır, örneğin ext_MyServer. Araç isimleri, uzak MCP sunucusunun açığa çıkardığı isimlerle tam olarak eşleşmelidir. Eşleşmeyen isimler, araç çağrılarının çalışma zamanında başarısız olmasına neden olur.

Parametreleri üç şekilde sağlayabilirsiniz:

• Bunları komut satırı seçenekleri olarak geçir.
• Bir JSON dosyası ile --input-filebirlikte bulun. Komut satırı seçenekleri dosyadan değerleri geçersiz kılar. Dosya yapısı için CLI şablonlarına bakınız register-external-mcp-server-sample.json .
• Etkileşimli olarak sorulması gereken herhangi bir değeri çıkarın.

Kayıt başarılı olduktan sonra, temsilciler bunu kullanmadan önce kiracı yöneticinizden yeni MCP sunucusunu onaylamasını iste. Eğer , adresine ExternalOAuthkayıt yaptıysanız, gösterilen yönlendirme URI'sini harici IDP uygulamanıza da ekleyin.

Important

Microsoft Entra uygulaması kayıtları oluşturulduktan sonra kayıt başarısız olursa, uygulamalar otomatik olarak geri alınmaz. Tekrar denemeden önce Azure portalında manuel olarak silin.

register-external-mcp-server Seçenekler

Bazı seçenekler, açıklama sütununda açıklandığı gibi, yalnızca belirli kimlik doğrulama türleri için gereklidir.

Option	Description
-s, --server-name <server-name>	MCP sunucu adı. Örneğin, en fazla ext_ 20 karakterle başlamalı ve en fazla olmalı ext_MyServer
-u, --server-url <server-url>	Uzaktan MCP sunucu URL'si. Geçerli bir HTTP veya HTTPS URL olmalı
-a, --auth-type <auth-type>	Kimlik doğrulama türü: EntraOAuth, ExternalOAuth, APIKey, veya NoAuth
--publisher <publisher>	Publisher adı (paket meta verilerinde kullanılır)
--description <description>	Sunucu tanımı (paket meta verilerinde kullanılır)
--tools <tools>	Örneğin, bu sunucu tarafından sunulan araç adlarının virgüllü ayrılmış listesi tool1,tool2,tool3
-f, --input-file <input-file>	Kayıt parametreleriyle JSON dosyasına giden yol
--remote-scopes <remote-scopes>	Örneğin uzak MCP sunucusu api://{appId-guid}/{scopeName}için kapsamlar. EntraOAuth ile kullanılır
-t, --tenant-id <tenant-id>	Uygulama kaydı için Entra kiracı kimliği. Varsayılan olarak mevcut az login kiracıya geçiyor
--service-tree-id <service-tree-id>	Entra uygulaması kaydı için ServiceTree ID. Microsoft kurumsal kiracılarında zorunlu
-l, --secret-lifetime-months <months>	Oluşturulan Entra uygulamalarında oluşturulan istemci sırları için ömür boyu aylar cinsinden (1-24). Varsayılan olarak 24 ay (2 yıl) olarak kalıyor. Kiracı poliçeniz daha kısa bir maksimum gerektiriyorsa, kiracınızda sınırdan appManagementPolicies daha küçük bir değer belirleyin
--idp-authorization-url <url>	Harici OAuth yetkilendirme URL'si. --auth-type ExternalOAuth gerektiğinde gereklidir
--idp-token-url <url>	Harici OAuth token URL. --auth-type ExternalOAuth gerektiğinde gereklidir
--idp-scopes <scopes>	Dış OAuth dürbünleri. --auth-type ExternalOAuth gerektiğinde gereklidir
--idp-client-id <client-id>	Harici OAuth istemci kimliği. --auth-type ExternalOAuth gerektiğinde gereklidir
--idp-client-secret <client-secret>	Dış OAuth istemcisi gizli. --auth-type ExternalOAuth gerektiğinde gereklidir
--api-key-location <location>	API anahtar konumu: Header veya Query. --auth-type APIKey gerektiğinde gereklidir
--api-key-name <name>	API anahtar parametresi veya başlık adı, örneğin X-API-Key veya token. --auth-type APIKey gerektiğinde gereklidir
--dry-run	Yürütme olmadan neler yapılacağını göster
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme