Conexão MCP Client no Jitterbit Studio

Introdução

Uma conexão MCP Client, criada usando o conector MCP Client, estabelece acesso a um servidor Model Context Protocol (MCP). Este conector é um cliente MCP que se conecta a um servidor MCP externo para usar suas ferramentas e funcionalidades. Depois de configurar uma conexão, você pode criar instâncias de atividades MCP Client associadas à essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão MCP Client

Uma nova conexão MCP Client é criada usando o conector MCP Client em um destes locais:

• Guia Project endpoints and connectors da paleta de componentes de design (consulte Paleta de componentes de design).
• Página Global Endpoints (consulte Criar um endpoint global em Global Endpoints).

Uma conexão MCP Client existente pode ser editada nesses locais:

• Guia Project endpoints and connectors da paleta de componentes de design (consulte Paleta de componentes de design).
• Guia Components do painel de projetos (consulte Menu de ações de componentes em Guia Components do painel de projetos).
• Página Global Endpoints (consulte Editar um endpoint global em Global Endpoints).

Configurar uma conexão MCP Client

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

• Connection name: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão MCP Client e não deve conter barras (/) ou dois-pontos (:). Este nome também é usado para identificar o endpoint MCP Client, que se refere tanto a uma conexão específica quanto às suas atividades.

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

• Authentication mechanism: Selecione o mecanismo de autenticação, Access Token ou No Auth.

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

  • Authorization Code Grant: Selecione esta opção para autenticar no servidor MCP usando autenticação 3LO.

    • OAuth application: Selecione um aplicativo do conector MCP Client configurado na página App Registrations do Management Console. Para mais informações sobre como configurar um aplicativo do conector MCP Client na página App Registrations, consulte os pré-requisitos OAuth 2.0 de 3 pernas (3LO) do MCP Client.

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

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

    • Token Bearer: insira um token Bearer para autenticação no servidor MCP. O administrador do servidor MCP ou o provedor de serviço fornece este token.

• Configurações opcionais: clique para expandir configurações opcionais adicionais:

  • Versão do Protocolo: selecione a versão do protocolo MCP a usar. Você pode escolher entre 2024-11-05, 2025-03-26, 2025-06-18 (padrão) ou 2026-07-28. 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 a aguardar pela resposta do servidor MCP. O padrão é 30000 milissegundos (30 segundos). Aumente este valor para redes lentas ou operações de servidor de longa duração.

  • Cabeçalhos de Solicitação Personalizados (Enviados com cada solicitação ao servidor MCP): insira todos os cabeçalhos adicionais a incluir em todas as solicitações enviadas ao servidor MCP. Você pode usar este campo para passar qualquer cabeçalho específico do servidor. Para adicionar uma linha de cabeçalho de solicitação, clique no ícone adicionar e insira uma Chave de Cabeçalho e um Valor de Cabeçalho.

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

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

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

    Importante

    Campos na tabela exibem o ícone variável apenas em modo de edição. Para que os valores de 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.

• Testar: clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada:

  • A versão mais recente do conector é baixada pelos agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política organizacional Desabilitar Atualização Automática do Conector.
  • Uma solicitação de inicialização MCP é executada para verificar a conectividade, exceto para a versão do protocolo 2026-07-28, que não usa um handshake de inicialização. Se o servidor MCP valida credenciais durante a inicialização depende da implementação do servidor. Alguns servidores MCP validam credenciais apenas quando uma operação Listar Ferramentas ou Invocar Ferramentas é executada, em vez de durante o teste de conexão.
  • 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, depois 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 de sessão como um cabeçalho de solicitação personalizado. Isso não se aplica à versão do protocolo 2026-07-28, que não usa um ID de sessão.
  • Se o servidor MCP não suporta a versão do protocolo selecionada, o teste de conexão exibe um erro listando as versões do protocolo que o servidor suporta.

• Salvar: Clique para salvar e fechar a configuração de 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 solicita que você confirme se 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 (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme se deseja excluir a conexão.

Próximas etapas

Após criar uma conexão de 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 destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel de projeto e na paleta de componentes de design. Para detalhes, consulte Menus de ações em Noções básicas de conectores.

Estes tipos de atividade estão disponíveis:

• Listar ferramentas: Recupera as 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 Invocar ferramentas.

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

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

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

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

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