McpToolServerConfigurationService class
Dienst, der für das Auffinden und Normalisieren von MCP -Toolservern (Model Context Protocol) verantwortlich ist und Konfigurationsobjekte produziert, die vom Claude SDK verwendet werden.
Konstruktoren
| Mcp |
Erstellen Sie einen McpToolServerConfigurationService. |
Methoden
| get |
Stellen Sie eine Verbindung mit dem MCP-Server her, und geben Sie Tools zurück, deren Namen dem Servernamen vorangestellt sind. Löst aus, wenn die Server-URL fehlt oder der Client Tools nicht auflisten kann. |
| list |
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab. |
| list |
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab. |
| list |
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab. Diese Überladung löst die agenticAppId automatisch aus dem TurnContext auf und generiert das Authentifizierungstoken, falls nicht angegeben. |
| send |
Sendet den Chatverlauf für den Echtzeit-Bedrohungsschutz an die MCP-Plattform. |
| send |
Sendet den Chatverlauf für den Echtzeit-Bedrohungsschutz an die MCP-Plattform. |
Details zum Konstruktor
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Erstellen Sie einen McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parameter
- configProvider
Optionaler Konfigurationsanbieter. Standardwert ist defaultToolingConfigurationProvider, falls nicht angegeben.
Details zur Methode
getMcpClientTools(string, MCPServerConfig)
Stellen Sie eine Verbindung mit dem MCP-Server her, und geben Sie Tools zurück, deren Namen dem Servernamen vorangestellt sind. Löst aus, wenn die Server-URL fehlt oder der Client Tools nicht auflisten kann.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parameter
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Gibt zurück
Promise<McpClientTool[]>
listToolServers(string, string)
Warnung
Diese API ist nun veraltet.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parameter
- agenticAppId
-
string
Die agentische App-ID, für die Server ermittelt werden sollen.
- authToken
-
string
Bearertoken, das beim Abfragen des Remotetoolgateways verwendet wird.
Gibt zurück
Promise<MCPServerConfig[]>
Eine Zusage, die in ein Array normalisierter MCP-Serverkonfigurationsobjekte aufgelöst wird.
listToolServers(string, string, ToolOptions)
Warnung
Diese API ist nun veraltet.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parameter
- agenticAppId
-
string
Die agentische App-ID, für die Server ermittelt werden sollen.
- authToken
-
string
Bearertoken, das beim Abfragen des Remotetoolgateways verwendet wird.
- options
- ToolOptions
Optionale Tooloptionen beim Aufrufen des Gateways.
Gibt zurück
Promise<MCPServerConfig[]>
Eine Zusage, die in ein Array normalisierter MCP-Serverkonfigurationsobjekte aufgelöst wird.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Gibt MCP-Serverdefinitionen für den angegebenen Agent zurück. In der Entwicklung (NODE_ENV=Entwicklung) liest dies die lokale ToolingManifest.json; andernfalls fragt es das Remotetoolgateway ab. Diese Überladung löst die agenticAppId automatisch aus dem TurnContext auf und generiert das Authentifizierungstoken, falls nicht angegeben.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parameter
- turnContext
- TurnContext
Der TurnContext der aktuellen Anforderung.
- authorization
- Authorization
Autorisierungsobjekt für den Tokenaustausch.
- authHandlerName
-
string
Der Name des Authentifizierungshandlers, der für den Tokenaustausch verwendet werden soll.
- authToken
-
string
Optionales Bearertoken. Wenn diese Option nicht angegeben wird, wird automatisch über den Tokenaustausch generiert.
- options
- ToolOptions
Optionale Tooloptionen beim Aufrufen des Gateways.
Gibt zurück
Promise<MCPServerConfig[]>
Eine Zusage, die in ein Array normalisierter MCP-Serverkonfigurationsobjekte aufgelöst wird.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Sendet den Chatverlauf für den Echtzeit-Bedrohungsschutz an die MCP-Plattform.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parameter
- turnContext
- TurnContext
Der Turnkontext, der Unterhaltungsinformationen enthält.
- chatHistoryMessages
Die zu sendenden Chatverlaufsnachrichten.
Gibt zurück
Promise<OperationResult>
Eine Zusage, die in ein OperationResult aufgelöst wird, das den Erfolg oder Fehler angibt.
Hinweise
HTTP-Ausnahmen (Netzwerkfehler, Timeouts) werden abgefangen und protokolliert, aber nicht erneut. Stattdessen gibt die Methode ein OperationResult zurück, das angibt, ob der Vorgang erfolgreich war oder fehlgeschlagen ist. Aufrufer können das Ergebnis auf fehlerbehandlung prüfen oder ignorieren, wenn Fehlerdetails nicht benötigt werden.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Sendet den Chatverlauf für den Echtzeit-Bedrohungsschutz an die MCP-Plattform.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parameter
- turnContext
- TurnContext
Der Turnkontext, der Unterhaltungsinformationen enthält.
- chatHistoryMessages
Die zu sendenden Chatverlaufsnachrichten.
- options
- ToolOptions
Optionale Tooloptionen für das Senden des Chatverlaufs.
Gibt zurück
Promise<OperationResult>
Eine Zusage, die in ein OperationResult aufgelöst wird, das den Erfolg oder Fehler angibt.
Hinweise
HTTP-Ausnahmen (Netzwerkfehler, Timeouts) werden abgefangen und protokolliert, aber nicht erneut. Stattdessen gibt die Methode ein OperationResult zurück, das angibt, ob der Vorgang erfolgreich war oder fehlgeschlagen ist. Aufrufer können das Ergebnis auf fehlerbehandlung prüfen oder ignorieren, wenn Fehlerdetails nicht benötigt werden.