McpToolServerConfigurationService class
Serviço responsável por descobrir e normalizar servidores de ferramentas MCP (Model Context Protocol) e produzir objetos de configuração consumíveis pelo SDK de Claude.
Construtores
| Mcp |
Construa um McpToolServerConfigurationService. |
Métodos
| get |
Conecte-se ao servidor MCP e retorne ferramentas com nomes prefixados pelo nome do servidor. Gerará se a URL do servidor estiver ausente ou se o cliente falhar ao listar as ferramentas. |
| list |
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas. |
| list |
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas. |
| list |
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas. Essa sobrecarga resolve automaticamente o agenticAppId do TurnContext e gera o token de autenticação se não for fornecido. |
| send |
Envia o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real. |
| send |
Envia o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real. |
Detalhes do construtor
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Construa um McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parâmetros
- configProvider
Provedor de configuração opcional. O padrão é defaultToolingConfigurationProvider se não for especificado.
Detalhes do método
getMcpClientTools(string, MCPServerConfig)
Conecte-se ao servidor MCP e retorne ferramentas com nomes prefixados pelo nome do servidor. Gerará se a URL do servidor estiver ausente ou se o cliente falhar ao listar as ferramentas.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parâmetros
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Retornos
Promise<McpClientTool[]>
listToolServers(string, string)
Aviso
Essa API foi preterida.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parâmetros
- agenticAppId
-
string
A ID do aplicativo agentic para a qual descobrir servidores.
- authToken
-
string
Token de portador usado ao consultar o gateway de ferramentas remotas.
Retornos
Promise<MCPServerConfig[]>
Uma promessa de resolução para uma matriz de objetos de configuração de servidor MCP normalizados.
listToolServers(string, string, ToolOptions)
Aviso
Essa API foi preterida.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parâmetros
- agenticAppId
-
string
A ID do aplicativo agentic para a qual descobrir servidores.
- authToken
-
string
Token de portador usado ao consultar o gateway de ferramentas remotas.
- options
- ToolOptions
Opções de ferramenta opcionais ao chamar o gateway.
Retornos
Promise<MCPServerConfig[]>
Uma promessa de resolução para uma matriz de objetos de configuração de servidor MCP normalizados.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Retornar definições de servidor MCP para o agente especificado. Em desenvolvimento (NODE_ENV=Desenvolvimento) lê o ToolingManifest.jsonlocal; caso contrário, ele consulta o gateway de ferramentas remotas. Essa sobrecarga resolve automaticamente o agenticAppId do TurnContext e gera o token de autenticação se não for fornecido.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parâmetros
- turnContext
- TurnContext
O TurnContext da solicitação atual.
- authorization
- Authorization
Objeto de autorização para troca de token.
- authHandlerName
-
string
O nome do manipulador de autenticação a ser usado para troca de tokens.
- authToken
-
string
Token de portador opcional. Se não for fornecido, será gerado automaticamente por meio da troca de tokens.
- options
- ToolOptions
Opções de ferramenta opcionais ao chamar o gateway.
Retornos
Promise<MCPServerConfig[]>
Uma promessa de resolução para uma matriz de objetos de configuração de servidor MCP normalizados.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Envia o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parâmetros
- turnContext
- TurnContext
O contexto de turno que contém informações de conversa.
- chatHistoryMessages
As mensagens de histórico de chat a serem enviadas.
Retornos
Promise<OperationResult>
Uma promessa que é resolvida para um OperationResult que indica êxito ou falha.
Comentários
Exceções HTTP (erros de rede, tempos limite) são capturadas e registradas, mas não relançadas. Em vez disso, o método retorna um OperationResult que indica se a operação foi bem-sucedida ou falhou. Os chamadores podem optar por inspecionar o resultado para tratamento de erros ou ignorá-lo se os detalhes do erro não forem necessários.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Envia o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parâmetros
- turnContext
- TurnContext
O contexto de turno que contém informações de conversa.
- chatHistoryMessages
As mensagens de histórico de chat a serem enviadas.
- options
- ToolOptions
Opções opcionais de ferramenta para enviar o histórico de chat.
Retornos
Promise<OperationResult>
Uma promessa que é resolvida para um OperationResult que indica êxito ou falha.
Comentários
Exceções HTTP (erros de rede, tempos limite) são capturadas e registradas, mas não relançadas. Em vez disso, o método retorna um OperationResult que indica se a operação foi bem-sucedida ou falhou. Os chamadores podem optar por inspecionar o resultado para tratamento de erros ou ignorá-lo se os detalhes do erro não forem necessários.