McpToolServerConfigurationService class
Service responsable de la découverte et de la normalisation des serveurs d’outils MCP (Model Context Protocol) et de la production d’objets de configuration consommables par le SDK Claude.
Constructeurs
| Mcp |
Construisez un McpToolServerConfigurationService. |
Méthodes
| get |
Connectez-vous au serveur MCP et retournez des outils avec des noms préfixés par le nom du serveur. Lève si l’URL du serveur est manquante ou si le client ne parvient pas à répertorier les outils. |
| list |
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance. |
| list |
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance. |
| list |
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance. Cette surcharge résout automatiquement l’agenticAppId à partir de TurnContext et génère le jeton d’authentification s’il n’est pas fourni. |
| send |
Envoie l’historique des conversations à la plateforme MCP pour la protection contre les menaces en temps réel. |
| send |
Envoie l’historique des conversations à la plateforme MCP pour la protection contre les menaces en temps réel. |
Détails du constructeur
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Construisez un McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Paramètres
- configProvider
Fournisseur de configuration facultatif. Par défaut, defaultToolingConfigurationProvider s’il n’est pas spécifié.
Détails de la méthode
getMcpClientTools(string, MCPServerConfig)
Connectez-vous au serveur MCP et retournez des outils avec des noms préfixés par le nom du serveur. Lève si l’URL du serveur est manquante ou si le client ne parvient pas à répertorier les outils.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Paramètres
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Retours
Promise<McpClientTool[]>
listToolServers(string, string)
Avertissement
Cette API est à présent déconseillée.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Paramètres
- agenticAppId
-
string
ID d’application agentique pour lequel découvrir les serveurs.
- authToken
-
string
Jeton du porteur utilisé lors de l’interrogation de la passerelle d’outils à distance.
Retours
Promise<MCPServerConfig[]>
Promesse de résolution d’un tableau d’objets de configuration de serveur MCP normalisés.
listToolServers(string, string, ToolOptions)
Avertissement
Cette API est à présent déconseillée.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Paramètres
- agenticAppId
-
string
ID d’application agentique pour lequel découvrir les serveurs.
- authToken
-
string
Jeton du porteur utilisé lors de l’interrogation de la passerelle d’outils à distance.
- options
- ToolOptions
Options d’outil facultatives lors de l’appel de la passerelle.
Retours
Promise<MCPServerConfig[]>
Promesse de résolution d’un tableau d’objets de configuration de serveur MCP normalisés.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Retournez les définitions de serveur MCP pour l’agent donné. Dans le développement (NODE_ENV=Développement), cela lit le ToolingManifest.jsonlocal ; sinon, il interroge la passerelle d’outils à distance. Cette surcharge résout automatiquement l’agenticAppId à partir de TurnContext et génère le jeton d’authentification s’il n’est pas fourni.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Paramètres
- turnContext
- TurnContext
TurnContext de la requête actuelle.
- authorization
- Authorization
Objet d’autorisation pour l’échange de jetons.
- authHandlerName
-
string
Nom du gestionnaire d’authentification à utiliser pour l’échange de jetons.
- authToken
-
string
Jeton du porteur facultatif. S’il n’est pas fourni, il est généré automatiquement via l’échange de jetons.
- options
- ToolOptions
Options d’outil facultatives lors de l’appel de la passerelle.
Retours
Promise<MCPServerConfig[]>
Promesse de résolution d’un tableau d’objets de configuration de serveur MCP normalisés.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Envoie l’historique des conversations à la plateforme MCP pour la protection contre les menaces en temps réel.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Paramètres
- turnContext
- TurnContext
Contexte de tour contenant des informations de conversation.
- chatHistoryMessages
Messages d’historique des conversations à envoyer.
Retours
Promise<OperationResult>
Promesse qui se résout à une opérationResult indiquant la réussite ou l’échec.
Remarques
Les exceptions HTTP (erreurs réseau, délais d’attente) sont interceptées et journalisées, mais pas de nouveau. Au lieu de cela, la méthode retourne une opérationResult indiquant si l’opération a réussi ou échoué. Les appelants peuvent choisir d’inspecter le résultat pour la gestion des erreurs ou de l’ignorer si les détails de l’erreur ne sont pas nécessaires.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Envoie l’historique des conversations à la plateforme MCP pour la protection contre les menaces en temps réel.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Paramètres
- turnContext
- TurnContext
Contexte de tour contenant des informations de conversation.
- chatHistoryMessages
Messages d’historique des conversations à envoyer.
- options
- ToolOptions
Options d’outil facultatives pour l’envoi de l’historique des conversations.
Retours
Promise<OperationResult>
Promesse qui se résout à une opérationResult indiquant la réussite ou l’échec.
Remarques
Les exceptions HTTP (erreurs réseau, délais d’attente) sont interceptées et journalisées, mais pas de nouveau. Au lieu de cela, la méthode retourne une opérationResult indiquant si l’opération a réussi ou échoué. Les appelants peuvent choisir d’inspecter le résultat pour la gestion des erreurs ou de l’ignorer si les détails de l’erreur ne sont pas nécessaires.