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ı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ı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
--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