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 Bağımsız değişken

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 Bağımsız değişken

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

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 -