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 Claude SDK.
Construtores
| Mcp |
Construa um McpToolServerConfigurationService. |
Métodos
| get |
Liga-te ao servidor MCP e devolve ferramentas com nomes prefixados pelo nome do servidor. Lança se o URL do servidor estiver em falta ou se o cliente falhar em listar ferramentas. |
| list |
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto. |
| list |
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto. |
| list |
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto. Esta sobrecarga resolve automaticamente o agenticAppId do TurnContext e gera o token de autenticação caso não seja 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
Fornecedor de configuração opcional. Por defeito é defaultToolingConfigurationProvider se não especificado.
Detalhes de Método
getMcpClientTools(string, MCPServerConfig)
Liga-te ao servidor MCP e devolve ferramentas com nomes prefixados pelo nome do servidor. Lança se o URL do servidor estiver em falta ou se o cliente falhar em listar ferramentas.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parâmetros
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Devoluções
Promise<McpClientTool[]>
listToolServers(string, string)
Aviso
Esta API foi preterida.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parâmetros
- agenticAppId
-
string
O id da aplicação agente para descobrir servidores.
- authToken
-
string
Token portador usado ao consultar o gateway de ferramentas remoto.
Devoluções
Promise<MCPServerConfig[]>
Uma promessa que resolve para um array de objetos de configuração normalizados do servidor MCP.
listToolServers(string, string, ToolOptions)
Aviso
Esta API foi preterida.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parâmetros
- agenticAppId
-
string
O id da aplicação agente para descobrir servidores.
- authToken
-
string
Token portador usado ao consultar o gateway de ferramentas remoto.
- options
- ToolOptions
Opções opcionais de ferramentas ao chamar o gateway.
Devoluções
Promise<MCPServerConfig[]>
Uma promessa que resolve para um array de objetos de configuração normalizados do servidor MCP.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Devolve definições de servidores MCP para o agente em questão. Em desenvolvimento (NODE_ENV=Desenvolvimento) isto é o ToolingManifest.jsonlocal ; caso contrário, consulta o gateway de ferramentas remoto. Esta sobrecarga resolve automaticamente o agenticAppId do TurnContext e gera o token de autenticação caso não seja fornecido.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parâmetros
- turnContext
- TurnContext
O TurnContext do pedido atual.
- authorization
- Authorization
Objeto de autorização para troca de tokens.
- authHandlerName
-
string
O nome do handler de autenticação a usar para a troca de tokens.
- authToken
-
string
Token de portador opcional. Se não for fornecido, será gerado automaticamente via troca de tokens.
- options
- ToolOptions
Opções opcionais de ferramentas ao chamar o gateway.
Devoluções
Promise<MCPServerConfig[]>
Uma promessa que resolve para um array de objetos de configuração normalizados do servidor MCP.
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 do turno contém informação de conversa.
- chatHistoryMessages
As mensagens do histórico de chat para enviar.
Devoluções
Promise<OperationResult>
Uma Promessa que se resolve para um ResultadoOperacional indicando sucesso ou fracasso.
Observações
Exceções HTTP (erros de rede, timeouts) são apanhadas e registadas, mas não relançadas. Em vez disso, o método devolve um OperationResult indicando se a operação teve sucesso ou falhou. Os chamadores podem optar por inspecionar o resultado para o tratamento de erros ou ignorá-lo se não forem necessários detalhes de erro.
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 do turno contém informação de conversa.
- chatHistoryMessages
As mensagens do histórico de chat para enviar.
- options
- ToolOptions
Opções opcionais de ferramentas para enviar o histórico de chat.
Devoluções
Promise<OperationResult>
Uma Promessa que se resolve para um ResultadoOperacional indicando sucesso ou fracasso.
Observações
Exceções HTTP (erros de rede, timeouts) são apanhadas e registadas, mas não relançadas. Em vez disso, o método devolve um OperationResult indicando se a operação teve sucesso ou falhou. Os chamadores podem optar por inspecionar o resultado para o tratamento de erros ou ignorá-lo se não forem necessários detalhes de erro.