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).

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 do 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 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 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 do Cliente MCP e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint 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 específico do endpoint (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.

    • Token de Acesso: Selecione esta opção se a autenticação no servidor MCP for necessária.

      • 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 este valor para redes lentas ou operações de servidor de longa duração.

  • 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 de adicionar e insira uma Chave de Cabeçalho e um Valor de Cabeçalho.

    Para salvar a linha, clique no ícone <span class="icon-check"></span> de enviar 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 <span class="icon-edit"></span> de editar ou o ícone <span class="icon-trash"></span> de excluir.

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

!!! important "Importante"
    Os campos na tabela exibem o ícone <span class="icon-variable"></span> de variável apenas no modo de edição. Para que os valores de variável desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos [10.75 / 11.13](/pt/release-notes/harmony-release-notes/summer-2023/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 agentes 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 de organização Desativar Atualização Automática do Conector.

  • 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 para você confirmar 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 para você confirmar que deseja excluir a conexão.

Próximas etapas

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 que serão usadas como fontes (para fornecer dados em uma operação) ou como destinos (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 no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja os Menus de ações em Conceitos básicos do Conector.

Estes tipos de atividade estão disponíveis: