McpToolServerConfigurationService class
MCP (Model Bağlam Protokolü) araç sunucularını bulup normalleştirmekten ve Claude SDK tarafından kullanılabilir yapılandırma nesneleri üretmekten sorumlu hizmet.
Oluşturucular
| Mcp |
Bir McpToolServerConfigurationService oluşturun. |
Yöntemler
| get |
MCP sunucusuna bağlanın ve sunucu adının ön ekine sahip adlara sahip araçları döndürebilirsiniz. Sunucu URL'si eksikse veya istemci araçları listeleyemezse atar. |
| list |
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular. |
| list |
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular. |
| list |
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular. Bu aşırı yükleme, TurnContext'ten agenticAppId'yi otomatik olarak çözümler ve sağlanmazsa kimlik doğrulama belirtecini oluşturur. |
| send |
Gerçek zamanlı tehdit koruması için sohbet geçmişini MCP platformuna gönderir. |
| send |
Gerçek zamanlı tehdit koruması için sohbet geçmişini MCP platformuna gönderir. |
Oluşturucu Ayrıntıları
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Bir McpToolServerConfigurationService oluşturun.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parametreler
- configProvider
İsteğe bağlı yapılandırma sağlayıcısı. Belirtilmezse varsayılan olarak defaultToolingConfigurationProvider değerini kullanır.
Yöntem Ayrıntıları
getMcpClientTools(string, MCPServerConfig)
MCP sunucusuna bağlanın ve sunucu adının ön ekine sahip adlara sahip araçları döndürebilirsiniz. Sunucu URL'si eksikse veya istemci araçları listeleyemezse atar.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parametreler
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Döndürülenler
Promise<McpClientTool[]>
listToolServers(string, string)
Uyarı
Bu API artık kullanım dışıdır.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parametreler
- agenticAppId
-
string
Sunucuların keşfedildiği aracı uygulama kimliği.
- authToken
-
string
Uzak araç ağ geçidi sorgulandığında kullanılan taşıyıcı belirteci.
Döndürülenler
Promise<MCPServerConfig[]>
Normalleştirilmiş BIR MCP sunucusu yapılandırma nesneleri dizisine çözüm getirilmeye yönelik bir söz.
listToolServers(string, string, ToolOptions)
Uyarı
Bu API artık kullanım dışıdır.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametreler
- agenticAppId
-
string
Sunucuların keşfedildiği aracı uygulama kimliği.
- authToken
-
string
Uzak araç ağ geçidi sorgulandığında kullanılan taşıyıcı belirteci.
- options
- ToolOptions
Ağ geçidini çağırırken isteğe bağlı araç seçenekleri.
Döndürülenler
Promise<MCPServerConfig[]>
Normalleştirilmiş BIR MCP sunucusu yapılandırma nesneleri dizisine çözüm getirilmeye yönelik bir söz.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Verilen aracı için MCP sunucu tanımlarını döndürür. Geliştirme aşamasında (NODE_ENV=Geliştirme) bu, yerel ToolingManifest.jsonokur; aksi takdirde uzak araç ağ geçidini sorgular. Bu aşırı yükleme, TurnContext'ten agenticAppId'yi otomatik olarak çözümler ve sağlanmazsa kimlik doğrulama belirtecini oluşturur.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametreler
- turnContext
- TurnContext
Geçerli isteğin TurnContext'i.
- authorization
- Authorization
Belirteç değişimi için yetkilendirme nesnesi.
- authHandlerName
-
string
Belirteç değişimi için kullanılacak kimlik doğrulama işleyicisinin adı.
- authToken
-
string
İsteğe bağlı taşıyıcı belirteci. Sağlanmazsa, belirteç değişimi yoluyla otomatik olarak oluşturulur.
- options
- ToolOptions
Ağ geçidini çağırırken isteğe bağlı araç seçenekleri.
Döndürülenler
Promise<MCPServerConfig[]>
Normalleştirilmiş BIR MCP sunucusu yapılandırma nesneleri dizisine çözüm getirilmeye yönelik bir söz.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Gerçek zamanlı tehdit koruması için sohbet geçmişini MCP platformuna gönderir.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parametreler
- turnContext
- TurnContext
Konuşma bilgilerini içeren dönüş bağlamı.
- chatHistoryMessages
Gönderilecek sohbet geçmişi iletileri.
Döndürülenler
Promise<OperationResult>
Başarılı veya başarısız olduğunu belirten bir OperationResult'a çözümleyen bir Promise.
Açıklamalar
HTTP özel durumları (ağ hataları, zaman aşımları) yakalanıp günlüğe kaydedilir ancak yeniden dağıtılmaz. Bunun yerine yöntemi, işlemin başarılı mı yoksa başarısız mı olduğunu belirten bir OperationResult döndürür. Arayanlar, hata işleme için sonucu incelemeyi veya hata ayrıntıları gerekli değilse yoksaymayı seçebilir.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Gerçek zamanlı tehdit koruması için sohbet geçmişini MCP platformuna gönderir.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parametreler
- turnContext
- TurnContext
Konuşma bilgilerini içeren dönüş bağlamı.
- chatHistoryMessages
Gönderilecek sohbet geçmişi iletileri.
- options
- ToolOptions
Sohbet geçmişi göndermek için isteğe bağlı araç seçenekleri.
Döndürülenler
Promise<OperationResult>
Başarılı veya başarısız olduğunu belirten bir OperationResult'a çözümleyen bir Promise.
Açıklamalar
HTTP özel durumları (ağ hataları, zaman aşımları) yakalanıp günlüğe kaydedilir ancak yeniden dağıtılmaz. Bunun yerine yöntemi, işlemin başarılı mı yoksa başarısız mı olduğunu belirten bir OperationResult döndürür. Arayanlar, hata işleme için sonucu incelemeyi veya hata ayrıntıları gerekli değilse yoksaymayı seçebilir.