Aracı 365 CLI develop komut başvurusu

Aracı geliştirme için MCP araç sunucularını yönetin. komutu, develop aracı geliştirme için MCP (Model Bağlam Protokolü) araç sunucularını yönetme seçenekleri sağlar. Kullanılabilir sunucuları listeleyebilir, yapılandırılmış sunucuları görüntüleyebilir ve aracı yapılandırmanızdan MCP sunucuları ekleyebilir veya kaldırabilirsiniz.

Gereken en düşük rol: Yok (yerel bildirim yönetimi)

Syntax

a365 develop [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österin.

develop list-available

Katalogda kullanılabilen tüm MCP sunucularını listeleyin (yükleyebilecekleriniz).

a365 develop list-available [options]

Bu komut, katalogda kullanılabilen tüm MCP sunucularını görüntüler ve aracı geliştirmeniz için bunları yükleyebilirsiniz.

list-available Seçenekler

Option	Description
--dry-run	Komutu yürütmeden ne yapacağını gösterin.
--skip-auth	Skip authentication. Yalnızca test için. Komut büyük olasılıkla geçerli kimlik doğrulaması olmadan başarısız olur.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Note

develop list-available gerektirmez a365.config.json. Ortamı ortam A365_ENVIRONMENT değişkeninden okur (varsayılan olarak ).prod

develop list-configured

Şu anda yapılandırılmış OLAN MCP sunucularını yerel ToolingManifest.json'inizden listeleyin.

a365 develop list-configured [options]

Bu komut, yerel ToolingManifest.json dosyanızda yapılandırdığınız tüm MCP sunucularını gösterir.

list-configured Seçenekler

Option	Description
--project-path <path>	Aracı proje dizinine ToolingManifest.jsongiden yol. Geçersiz DeploymentProjectPath kalanlar .a365.config.json
--dry-run	Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

develop add-mcp-servers

Geçerli aracı yapılandırmasına MCP Sunucuları ekleyin.

a365 develop add-mcp-servers [<servers>...] [options]

Bu komut, belirtilen MCP sunucularını proje klasörünüzde öğesine ToolingManifest.json ekler. Aracı şemasına izin vermez.

Important

Bu komut sadece güncellenir ToolingManifest.json - ajanın blueprint'ine izin vermez. İzinleri nasıl uygulayacağınız kurulum sürecinin nerede olduğuna bağlıdır:

• İlk kurulumdan önce: ile a365 setup alldevam edin. MCP izinleri, ilk şema oluşturma işleminin bir parçası olarak uygulanır.
• Şema zaten var olduktan sonra: Genel Yönetici ayrı olarak çalıştırılmalıdır a365 setup permissions mcp . Yönetici, güncellenmiş deploymentProjectPathdosyayı içeren proje klasörüne işaret ettiğini doğrulamalıdırToolingManifest.json.

add-mcp-servers argümanlar

Aracı yapılandırmanıza eklemek için bir veya daha fazla MCP sunucu adı belirtin. Boşluklarla ayrılmış birden çok sunucu adı sağlayabilirsiniz.

Argument	Description
<servers>	Eklenecek MCP sunucularının adları

add-mcp-servers Seçenekler

Komutun davranışını add-mcp-servers özelleştirmek için bu seçenekleri kullanın.

Option	Description
--project-path <path>	Aracı proje dizinine ToolingManifest.jsongiden yol. Geçersiz DeploymentProjectPath kalanlar .a365.config.json
--dry-run	Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

develop remove-mcp-servers

MCP Sunucularını geçerli aracı yapılandırmasından kaldırın.

a365 develop remove-mcp-servers [<servers>...] [options]

Bu komut, belirtilen MCP sunucularını geçerli aracı yapılandırmanızdan kaldırır.

remove-mcp-servers argümanlar

Argument	Description
<servers>	Kaldırılacak MCP sunucularının adları

remove-mcp-servers Seçenekler

Option	Description
--project-path <path>	Aracı proje dizinine ToolingManifest.jsongiden yol. Geçersiz DeploymentProjectPath kalanlar .a365.config.json
--dry-run	Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

develop add-permissions

MCP sunucularına erişmek için özel uygulamalar yapılandırmanız gereken geliştirme senaryoları için Microsoft Entra uygulamalara MCP sunucusu API izinleri ekleyin.

a365 develop add-permissions [options]

add-permissions Seçenekler

Araç bildirimindeki değerlerden yararlanarak uygulama kaydınıza gerekli API izinlerini ve kapsamlarını eklemek için bu seçenekleri kullanın.

Option	Description
-m, --manifest <manifest>	ToolingManifest.json Yolu (varsayılan: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	İzin eklemek için uygulama (istemci) kimliği (varsayılan: clientAppId yapılandırmadan)
--scopes <scopes>	Eklenecek belirli kapsamlar (boşlukla ayrılmış) (varsayılan: Tüm kapsamlar )ToolingManifest.json
--dry-run	Değişiklik yapmadan komutun ne yapacağını göster
-v, --verbose	Ayrıntılı çıkışı göster
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Important

--app-id veya clientAppId tarafından belirtilen uygulamanın Microsoft Entra'de Application.ReadWrite.All izni olmalıdır. Bu komut özel istemci uygulamaları içindir. Aracı şemalarının izinlerini yapılandırmak için bunun yerine kullanın a365 setup permissions mcp .

develop get-token

Etkileşimli tarayıcı kimlik doğrulamasını kullanarak geliştirme sırasında MCP sunucularını test etme için taşıyıcı belirteçleri alın.

a365 develop get-token [options]

get-token Seçenekler

Erişim belirteci istemek, kapsamları denetlemek, davranışı yenilemek ve çıkış biçimini seçmek için bu seçenekleri kullanın.

Option	Description
--app-id <app-id>	Kimlik doğrulaması için uygulama (istemci) kimliği (varsayılan: clientAppId yapılandırmadan)
-m, --manifest <manifest>	ToolingManifest.json Yolu (varsayılan: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	İstekte bulunacak belirli kapsamlar (boşlukla ayrılmış) (varsayılan: Okuma yeri ToolingManifest.json)
-o, --output <output>	Çıkış biçimi: table, jsonveya raw (varsayılan: table)
--force-refresh	Önbelleği atlayarak belirteci yenilemeye zorlama
--device-code	Etkileşimli tarayıcı akışı yerine cihaz kod akışıyla doğrultu (Windows'ta Windows Hesap Yöneticisi (WAM) aracı). Cihaz kodu doğrulaması hakkında get-token bilgi edinin
--resource <resource>	Belirteci almak için kaynak anahtar sözcüğü: mcp (varsayılan) veya powerplatform
--resource-id <resource-id>	Anahtar sözcükler kapsamında --resource olmayan kaynaklar için özel kaynak uygulama kimliği (GUID)
-v, --verbose	Tam belirteç de dahil olmak üzere ayrıntılı çıkışı göster
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

get-token kaynak seçenekleri

Farklı Azure kaynaklarının belirteçlerini almak için --resource ve --resource-id seçeneklerini kullanın:

• --resource: Önceden tanımlanmış bir kaynağı seçmek için anahtar sözcük kullanın:
  • mcp (varsayılan): MCP sunucuları için Aracı 365 Araçları
  • powerplatform: Power Platform API'si
• --resource-id: Anahtar sözcükler kapsamında olmayan kaynaklar için özel bir kaynak uygulama kimliği (GUID) girin

Important

Birlikte kullanamazsınız --resource--resource-id . Herhangi bir seçeneği kullandığınızda, öğesini ekleyin --scopes. Yalnızca varsayılan MCP akışı bildirim tabanlı kapsam çözümlemesini destekler.

get-token Cihaz kodu doğrulaması

Windows'ta, varsayılan etkileşimli tarayıcı akışı Windows Hesap Yöneticisi (WAM) aracısını kullanır; bu aracı bazı Exchange'e özgü Microsoft Graph kapsamlarını reddeder (örneğinMailboxSettings.ReadWrite, ve ExchangeMessageTrace.Read.All).

Bunu kendiniz fark etmenize gerek yok. WAM istenen kapsamları reddederse, CLI reddetmeyi bildirir ve cihaz kodu akışıyla otomatik olarak tekrar dener, böylece komut hâlâ başarılı olur.--device-code

WAM, CLI denemeleri denemeden önce başarısız olması gerektiği için, geri dönüş daha yavaş ve deneyim optimal değil. Önden o akışı seçmek istediğinizde pas --device-code yapın ve başarısız denemeden kaçının:

• Hiçbir etkileşimli tarayıcının açılamadığı yerlerde, örneğin uzaktan terminal veya SSH oturumu gibi.
• Exchange dürbünleri talep ettiğinizi zaten biliyorsunuz ve başarısız WAM denemesini ve uyarısını atlamak istiyorsunuz.
• get-token Aynı dürbünlerle tekrar tekrar çalışıyorsunuz, örneğin birden fazla blueprint boyunca, burada her çalışma gecikmesi toplanır.

$params = @{
  ResourceId = "00000003-0000-0000-c000-000000000000"
  Scopes     = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
  DeviceCode = $true
}

a365 develop get-token @params

Komut, tarayıcınızda oturum açmayı tamamlamak için bir URL (https://microsoft.com/devicelogin) ve bir kod gösterir.

develop start-mock-tooling-server

Test ve geliştirme amacıyla sahte bir araç sunucusu başlatın.

a365 develop start-mock-tooling-server [options]

Bu komut, test ve geliştirme amacıyla sahte bir araç sunucusu başlatır. Bu sunucuyu kullanarak, gerçek sunucu uygulamalarına gerek kalmadan MCP sunucu etkileşimlerinin benzetimini yapabilirsiniz.

start-mock-tooling-server Seçenekler

Komutun davranışını start-mock-tooling-server özelleştirmek için bu seçenekleri kullanın.

Option	Description	Default
-p, --port <port>	Sahte sunucu için bağlantı noktası numarası	5309
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir	false
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme	-
-bg	Sunucuyu yeni bir terminalde çalıştırma	-