McpToolServerConfigurationService class

Tjeneste, der er ansvarlig for at finde og normalisere MCP-værktøjsservere (Model Context Protocol) og producere konfigurationsobjekter, der kan forbruges af Claude SDK.

Konstruktører

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Opret en McpToolServerConfigurationService.

Metoder

getMcpClientTools(string, MCPServerConfig)

Opret forbindelse til MCP-serveren, og returner værktøjer med navne foran servernavnet. Udløser, hvis serverens URL-adresse mangler, eller klienten ikke kan vise værktøjer.

listToolServers(string, string)

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen.

listToolServers(string, string, ToolOptions)

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen. Denne overbelastning fortolker automatisk agenticAppId fra TurnContext og genererer godkendelsestokenet, hvis det ikke er angivet.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

Oplysninger om konstruktør

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Opret en McpToolServerConfigurationService.

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

Parametre

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurationsprovider. StandardindstillingenToolingConfigurationProvider er som standard, hvis den ikke er angivet.

Oplysninger om metode

getMcpClientTools(string, MCPServerConfig)

Opret forbindelse til MCP-serveren, og returner værktøjer med navne foran servernavnet. Udløser, hvis serverens URL-adresse mangler, eller klienten ikke kan vise værktøjer.

function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>

Parametre

mcpServerName

string

mcpServerConfig
MCPServerConfig

Returnerer

Promise<McpClientTool[]>

listToolServers(string, string)

Advarsel!

Denne API udfases nu.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen.

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

Parametre

agenticAppId

string

Det agentiske app-id, som serverne skal registreres for.

authToken

string

Ihændehavertoken, der bruges til at forespørge om fjernværktøjsgatewayen.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om at løse en række normaliserede MCP-serverkonfigurationsobjekter.

listToolServers(string, string, ToolOptions)

Advarsel!

Denne API udfases nu.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen.

function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametre

agenticAppId

string

Det agentiske app-id, som serverne skal registreres for.

authToken

string

Ihændehavertoken, der bruges til at forespørge om fjernværktøjsgatewayen.

options
ToolOptions

Valgfrie værktøjsindstillinger, når gatewayen kaldes.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om at løse en række normaliserede MCP-serverkonfigurationsobjekter.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Returner MCP-serverdefinitioner for den angivne agent. Under udvikling (NODE_ENV=Udvikling) læses den lokale ToolingManifest.json; Ellers forespørger den fjernværktøjsgatewayen. Denne overbelastning fortolker automatisk agenticAppId fra TurnContext og genererer godkendelsestokenet, hvis det ikke er angivet.

function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametre

turnContext
TurnContext

TurnContext for den aktuelle anmodning.

authorization
Authorization

Autorisationsobjekt for tokenudveksling.

authHandlerName

string

Navnet på den godkendelseshandler, der skal bruges til tokenudveksling.

authToken

string

Valgfrit ihændehavertoken. Hvis ikke angivet, genereres automatisk via tokenudveksling.

options
ToolOptions

Valgfrie værktøjsindstillinger, når gatewayen kaldes.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om at løse en række normaliserede MCP-serverkonfigurationsobjekter.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>

Parametre

turnContext
TurnContext

Den turn-kontekst, der indeholder samtaleoplysninger.

chatHistoryMessages

ChatHistoryMessage[]

De chatoversigtsmeddelelser, der skal sendes.

Returnerer

Promise<OperationResult>

A Promise, der løses til en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes.

Bemærkninger

HTTP-undtagelser (netværksfejl, timeout) registreres og logføres, men de genbesejes ikke. Metoden returnerer i stedet en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes. Opkaldere kan vælge at undersøge resultatet for fejlhåndtering eller ignorere det, hvis der ikke er behov for oplysninger om fejlen.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>

Parametre

turnContext
TurnContext

Den turn-kontekst, der indeholder samtaleoplysninger.

chatHistoryMessages

ChatHistoryMessage[]

De chatoversigtsmeddelelser, der skal sendes.

options
ToolOptions

Valgfrie værktøjsindstillinger til afsendelse af chathistorik.

Returnerer

Promise<OperationResult>

A Promise, der løses til en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes.

Bemærkninger

HTTP-undtagelser (netværksfejl, timeout) registreres og logføres, men de genbesejes ikke. Metoden returnerer i stedet en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes. Opkaldere kan vælge at undersøge resultatet for fejlhåndtering eller ignorere det, hvis der ikke er behov for oplysninger om fejlen.