McpToolServerConfigurationService class
Servicio responsable de detectar y normalizar servidores de herramientas MCP (Protocolo de contexto de modelo) y producir objetos de configuración consumibles por el SDK de Claude.
Constructores
| Mcp |
Construya un mcpToolServerConfigurationService. |
Métodos
| get |
Conéctese al servidor MCP y devuelva herramientas con nombres prefijos por el nombre del servidor. Se produce si falta la dirección URL del servidor o el cliente no puede enumerar las herramientas. |
| list |
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota. |
| list |
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota. |
| list |
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota. Esta sobrecarga resuelve automáticamente el agenticAppId desde TurnContext y genera el token de autenticación si no se proporciona. |
| send |
Envía el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real. |
| send |
Envía el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real. |
Detalles del constructor
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Construya un mcpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parámetros
- configProvider
Proveedor de configuración opcional. El valor predeterminado es defaultToolingConfigurationProvider si no se especifica.
Detalles del método
getMcpClientTools(string, MCPServerConfig)
Conéctese al servidor MCP y devuelva herramientas con nombres prefijos por el nombre del servidor. Se produce si falta la dirección URL del servidor o el cliente no puede enumerar las herramientas.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parámetros
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Devoluciones
Promise<McpClientTool[]>
listToolServers(string, string)
Advertencia
Esta API ya está en desuso.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parámetros
- agenticAppId
-
string
Identificador de aplicación agente para el que se detectarán los servidores.
- authToken
-
string
Token de portador usado al consultar la puerta de enlace de herramientas remota.
Devoluciones
Promise<MCPServerConfig[]>
Promesa que se resuelve en una matriz de objetos de configuración de servidor MCP normalizados.
listToolServers(string, string, ToolOptions)
Advertencia
Esta API ya está en desuso.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parámetros
- agenticAppId
-
string
Identificador de aplicación agente para el que se detectarán los servidores.
- authToken
-
string
Token de portador usado al consultar la puerta de enlace de herramientas remota.
- options
- ToolOptions
Opciones de herramientas opcionales al llamar a la puerta de enlace.
Devoluciones
Promise<MCPServerConfig[]>
Promesa que se resuelve en una matriz de objetos de configuración de servidor MCP normalizados.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Devuelve definiciones de servidor MCP para el agente especificado. En desarrollo (NODE_ENV=Desarrollo), lee el ToolingManifest.jsonlocal ; de lo contrario, consulta la puerta de enlace de herramientas remota. Esta sobrecarga resuelve automáticamente el agenticAppId desde TurnContext y genera el token de autenticación si no se proporciona.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parámetros
- turnContext
- TurnContext
TurnContext de la solicitud actual.
- authorization
- Authorization
Objeto de autorización para el intercambio de tokens.
- authHandlerName
-
string
Nombre del controlador de autenticación que se va a usar para el intercambio de tokens.
- authToken
-
string
Token de portador opcional. Si no se proporciona, se generará automáticamente a través del intercambio de tokens.
- options
- ToolOptions
Opciones de herramientas opcionales al llamar a la puerta de enlace.
Devoluciones
Promise<MCPServerConfig[]>
Promesa que se resuelve en una matriz de objetos de configuración de servidor MCP normalizados.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Envía el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parámetros
- turnContext
- TurnContext
Contexto de turno que contiene información de conversación.
- chatHistoryMessages
Mensajes del historial de chat que se van a enviar.
Devoluciones
Promise<OperationResult>
Promesa que se resuelve en un OperationResult que indica que se ha realizado correctamente o no.
Comentarios
Las excepciones HTTP (errores de red, tiempos de espera) se detectan y registran, pero no se vuelven a iniciar. En su lugar, el método devuelve un OperationResult que indica si la operación se realizó correctamente o no. Los autores de llamadas pueden optar por inspeccionar el resultado para el control de errores o ignorarlo si no se necesitan detalles del error.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Envía el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parámetros
- turnContext
- TurnContext
Contexto de turno que contiene información de conversación.
- chatHistoryMessages
Mensajes del historial de chat que se van a enviar.
- options
- ToolOptions
Opciones de herramientas opcionales para enviar el historial de chat.
Devoluciones
Promise<OperationResult>
Promesa que se resuelve en un OperationResult que indica que se ha realizado correctamente o no.
Comentarios
Las excepciones HTTP (errores de red, tiempos de espera) se detectan y registran, pero no se vuelven a iniciar. En su lugar, el método devuelve un OperationResult que indica si la operación se realizó correctamente o no. Los autores de llamadas pueden optar por inspeccionar el resultado para el control de errores o ignorarlo si no se necesitan detalles del error.