Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Aracı 365 CLI
Dataverse ortamlarında MCP sunucularını yönetme. Komut, develop-mcp Dataverse ortamlarında kullanılmak üzere MCP sunucularını yayınlama, yayınlama, onaylama, engelleme, paketleme ve kayıt seçenekleri sunar.
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.
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ı |
--dry-run |
Yürütme olmadan neler yapılacağını göster |
-?, -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 approve
MCP sunucusunu onaylama.
a365 develop-mcp approve [options]
Bu komut, ortamda kullanılmak üzere bir MCP sunucusunu onaylar.
approve Seçenekler
| Option | Description |
|---|---|
-s, --server-name <server-name> |
Onaylayacak 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 block
BIR MCP sunucusunu engelleyin.
a365 develop-mcp block [options]
Bir MCP sunucusunun ortamınızda kullanılmasını engellemek için bu komutu kullanın.
block Seçenekler
| Option | Description |
|---|---|
-s, --server-name <server-name> |
Engellenmesi gereken 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 package-mcp-server
Microsoft yönetim merkezinde gönderim için MCP sunucu paketi oluşturun.
a365 develop-mcp package-mcp-server [options]
Microsoft yönetim merkezine gönderebileceğiniz bir MCP sunucusu için dağıtım paketi oluşturmak için bu komutu kullanın.
package-mcp-server Seçenekler
| Option | Description |
|---|---|
--server-name <server-name> |
MCP sunucu adı (GEREKLI) |
--developer-name <developer-name> |
Yayımcı veya geliştirici görünen adı (GEREKLI) |
--icon-url <icon-url> |
MCP sunucusu için PNG simgesinin genel URL'si (GEREKLI) |
--output-path <output-path> |
Oluşturulan ZIP paketi için hedef dizin (GEREKLI) |
--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ızregister-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 |
--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 |