Ir para o conteúdo

Conector MCP Client

Resumo

O conector MCP Client estabelece acesso a um servidor Model Context Protocol (MCP).

O conector MCP Client fornece uma interface para criar uma conexão MCP Client, a base usada para gerar instâncias de atividades MCP Client. Essas atividades, uma vez configuradas, interagem com um servidor MCP através da conexão.

Acessa-se o conector MCP Client pela aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Nota

Este conector é um cliente MCP, usado para conectar a um servidor MCP externo e usar suas ferramentas e capacidades. O conector não fornece ferramentas por si só.

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão MCP Client. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão MCP Client específica e suas atividades são chamadas de endpoint MCP Client:

Tipos de atividade MCP Client

  • List Tools: Recupera ferramentas disponíveis de um servidor MCP e é destinada a ser usada como fonte em uma operação. Use os dados retornados para configurar a atividade Invoke Tools.

  • Invoke Tools: Executa uma ferramenta específica em um servidor MCP e é destinada a ser usada como destino em uma operação. Use a atividade List Tools primeiro para ver as ferramentas disponíveis e seus campos obrigatórios.

  • List Resources: Recupera recursos disponíveis de um servidor MCP e é destinada a ser usada como fonte em uma operação.

  • List Prompts: Recupera prompts disponíveis de um servidor MCP e é destinada a ser usada como fonte em uma operação.

  • Get Prompt: Recupera prompts específicos de um servidor MCP e é destinada a ser usada como fonte em uma operação.

  • Read Resource: Recupera recursos específicos de um servidor MCP e é destinada a ser usada como fonte em uma operação.

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos

Este conector pode ser usado com agentes em nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Disable Auto Connector Update (Desabilitar atualização automática de conector).

Para usar autenticação OAuth 2.0 de 3 pernas (3LO) com o conector MCP Client, pré-requisitos adicionais são necessários. A versão do agente 10.83 / 11.21 ou posterior é necessária para usar 3LO.

Solução de problemas

Se você enfrentar problemas com o conector MCP Client, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política organizacional Disable Auto Connector Update).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o log de depuração de operação (para agentes na nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.mcp" level="DEBUG"/>
    

    Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.