Ir para o conteúdo

Conexão do Cliente MCP

Introdução

Uma conexão do Cliente MCP, criada usando o conector do Cliente MCP, estabelece acesso a um servidor do Protocolo de Contexto de Modelo (MCP). Este conector é um cliente MCP que se conecta a um servidor MCP externo para utilizar suas ferramentas e capacidades. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Cliente MCP associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Para usar a autenticação OAuth 2.0 de 3 etapas (3LO) com o conector do Cliente MCP, pré-requisitos adicionais são necessários. É necessário ter a versão 10.83 / 11.21 ou posterior do agente para usar 3LO.

Criar ou editar uma conexão do Cliente MCP

Uma nova conexão do Cliente MCP é criada usando o conector do Cliente MCP a partir de uma destas localizações:

Uma conexão existente do Cliente MCP pode ser editada a partir destas localizações:

Configurar uma conexão de Cliente MCP

Cada elemento da interface do usuário da tela de configuração da conexão do Cliente MCP é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão de Cliente MCP e não deve conter barras (/) ou dois-pontos (:). Este nome também é usado para identificar o ponto de extremidade do Cliente MCP, que se refere tanto a uma conexão específica quanto às suas atividades.

  • URL do servidor MCP: Insira o endpoint HTTP completo do servidor MCP. A URL deve incluir o protocolo (http:// ou https://) e o caminho do endpoint específico (como /mcp). Por exemplo, https://api.example.com/mcp.

  • Mecanismo de autenticação: Selecione o mecanismo de autenticação, seja Token de Acesso ou Sem Autenticação.

    • Sem Autenticação: Selecione esta opção se a autenticação no servidor MCP não for necessária.

    • Código de Autorização: Selecione esta opção para autenticar no servidor MCP usando autenticação 3LO.

      • Aplicativo OAuth: Selecione um aplicativo conector do Cliente MCP configurado na página de Registro de Aplicativos do Console de Gerenciamento. Para mais informações sobre como configurar um aplicativo conector do Cliente MCP na página de Registro de Aplicativos, consulte os pré-requisitos de OAuth 2.0 (3LO).

      • Entrar com OAuth: Clique para autenticar usando OAuth em uma aba do navegador separada e forneça consentimento para que o Jitterbit acesse o aplicativo suportado pelo MCP.

  • Token de Acesso: Selecione esta opção para autenticar-se no servidor MCP usando um token de acesso.

    • Token Bearer: Insira um token bearer para autenticação no servidor MCP. Este token é emitido pelo administrador do servidor MCP ou pelo provedor de serviços.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    • Versão do Protocolo: Selecione a versão do protocolo MCP a ser utilizada. Você pode escolher entre 2025-06-18 (padrão), 2025-03-26 ou 2024-11-05. A versão padrão é recomendada, a menos que o servidor MCP exija uma versão específica.

    • Tempo Limite (em milissegundos): Insira o tempo máximo em milissegundos para aguardar a resposta do servidor MCP. O padrão é 30000 milissegundos (30 segundos). Aumente esse valor para redes lentas ou operações de servidor que demoram mais.

    • Cabeçalhos de Requisição Personalizados (Enviados com cada requisição ao servidor MCP): Insira quaisquer cabeçalhos adicionais a serem incluídos em todas as requisições enviadas ao servidor MCP. Você pode usar este campo para passar quaisquer cabeçalhos específicos do servidor. Para adicionar uma linha de cabeçalho de requisição, clique no ícone e insira uma Chave de Cabeçalho e um Valor de Cabeçalho.

      Para salvar a linha, clique no ícone na coluna mais à direita.

      Para editar ou excluir uma única linha de cabeçalho de requisição, passe o mouse sobre a coluna mais à direita e use o ícone para editar ou o ícone para excluir.

      Para excluir todas as linhas de cabeçalho de requisição, clique em Limpar Tudo.

      Importante

      Os campos na tabela exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

    • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

  • Teste: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política da organização.

    Nota

    O conector recupera e armazena automaticamente qualquer ID de sessão que o servidor MCP retorna nos cabeçalhos de resposta quando você testa a conexão, e então o inclui em todas as solicitações subsequentes ao servidor MCP, incluindo solicitações das atividades Listar Ferramentas e Invocar Ferramentas. Você não precisa configurar manualmente o ID da sessão como um cabeçalho de solicitação personalizado.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão do Cliente MCP, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para mais detalhes, veja Menus de ações em Conceitos Básicos do Conector.

Esses tipos de atividade estão disponíveis:

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

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