McpToolServerConfigurationService class

Tjänst som ansvarar för att identifiera och normalisera MCP-verktygsservrar (Model Context Protocol) och producera konfigurationsobjekt som kan användas av Claude SDK.

Konstruktorer

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Skapa en McpToolServerConfigurationService.

Metoder

getMcpClientTools(string, MCPServerConfig)

Anslut till MCP-servern och returnera verktyg med namn som är prefixet av servernamnet. Genererar om server-URL:en saknas eller om klienten inte kan lista verktyg.

listToolServers(string, string)

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen.

listToolServers(string, string, ToolOptions)

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen.

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

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen. Den här överlagringen löser automatiskt agenticAppId från TurnContext och genererar autentiseringstoken om den inte tillhandahålls.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Skickar chatthistorik till MCP-plattformen för skydd mot hot i realtid.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Skickar chatthistorik till MCP-plattformen för skydd mot hot i realtid.

Konstruktorinformation

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Skapa en McpToolServerConfigurationService.

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

Parametrar

configProvider

IConfigurationProvider<ToolingConfiguration>

Valfri konfigurationsprovider. Standardvärdet är defaultToolingConfigurationProvider om det inte anges.

Metodinformation

getMcpClientTools(string, MCPServerConfig)

Anslut till MCP-servern och returnera verktyg med namn som är prefixet av servernamnet. Genererar om server-URL:en saknas eller om klienten inte kan lista verktyg.

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

Parametrar

mcpServerName

string

mcpServerConfig
MCPServerConfig

Returer

Promise<McpClientTool[]>

listToolServers(string, string)

Varning

Det här API:et är nu inaktuellt.

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

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen.

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

Parametrar

agenticAppId

string

Det agentiska app-ID som servrarna ska identifieras för.

authToken

string

Ägartoken som används vid frågor mot fjärrverktygsgatewayen.

Returer

Promise<MCPServerConfig[]>

Ett löfte om att matcha en matris med normaliserade MCP-serverkonfigurationsobjekt.

listToolServers(string, string, ToolOptions)

Varning

Det här API:et är nu inaktuellt.

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

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen.

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

Parametrar

agenticAppId

string

Det agentiska app-ID som servrarna ska identifieras för.

authToken

string

Ägartoken som används vid frågor mot fjärrverktygsgatewayen.

options
ToolOptions

Valfria verktygsalternativ när du anropar gatewayen.

Returer

Promise<MCPServerConfig[]>

Ett löfte om att matcha en matris med normaliserade MCP-serverkonfigurationsobjekt.

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

Returnera MCP-serverdefinitioner för den angivna agenten. I utveckling (NODE_ENV=Utveckling) läser detta den lokala ToolingManifest.json; annars frågar den fjärrverktygsgatewayen. Den här överlagringen löser automatiskt agenticAppId från TurnContext och genererar autentiseringstoken om den inte tillhandahålls.

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

Parametrar

turnContext
TurnContext

TurnContext för den aktuella begäran.

authorization
Authorization

Auktoriseringsobjekt för tokenutbyte.

authHandlerName

string

Namnet på den autentiseringshanterare som ska användas för tokenutbyte.

authToken

string

Valfri ägartoken. Om det inte anges genereras automatiskt via tokenutbyte.

options
ToolOptions

Valfria verktygsalternativ när du anropar gatewayen.

Returer

Promise<MCPServerConfig[]>

Ett löfte om att matcha en matris med normaliserade MCP-serverkonfigurationsobjekt.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Skickar chatthistorik till MCP-plattformen för skydd mot hot i realtid.

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

Parametrar

turnContext
TurnContext

Turkontexten som innehåller konversationsinformation.

chatHistoryMessages

ChatHistoryMessage[]

De chatthistorikmeddelanden som ska skickas.

Returer

Promise<OperationResult>

Ett löfte som matchar en OperationResult som anger lyckad eller misslyckad.

Kommentarer

HTTP-undantag (nätverksfel, tidsgränser) fångas upp och loggas men återaktiveras inte. I stället returnerar metoden en OperationResult som anger om åtgärden lyckades eller misslyckades. Anropare kan välja att granska resultatet för felhantering eller ignorera det om felinformation inte behövs.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Skickar chatthistorik till MCP-plattformen för skydd mot hot i realtid.

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

Parametrar

turnContext
TurnContext

Turkontexten som innehåller konversationsinformation.

chatHistoryMessages

ChatHistoryMessage[]

De chatthistorikmeddelanden som ska skickas.

options
ToolOptions

Valfria verktygsalternativ för att skicka chatthistorik.

Returer

Promise<OperationResult>

Ett löfte som matchar en OperationResult som anger lyckad eller misslyckad.

Kommentarer

HTTP-undantag (nätverksfel, tidsgränser) fångas upp och loggas men återaktiveras inte. I stället returnerar metoden en OperationResult som anger om åtgärden lyckades eller misslyckades. Anropare kan välja att granska resultatet för felhantering eller ignorera det om felinformation inte behövs.