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
| Mcp |
Opret en McpToolServerConfigurationService. |
Metoder
| get |
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. |
| list |
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. |
| list |
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. |
| list |
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. |
| send |
Sender chathistorik til MCP-platformen for at beskytte trusler i realtid. |
| send |
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
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
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
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.