Esta página foi traduzida pela API Cloud Translation.

Crie e configure um conetor de MCP

A página descreve como criar e configurar um conetor do MCP nos Integration Connectors. Para mais informações sobre o conetor MCP, consulte o artigo Vista geral do conetor MCP.

Antes de começar

Antes de usar o conector do MCP, conclua as seguintes tarefas:

No seu Google Cloud projeto:
- Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
- Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
- Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticar e ter autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.
- Ative os seguintes serviços:
  - secretmanager.googleapis.com (Secret Manager API)
  - connectors.googleapis.com (API Connectors)
  Para saber como ativar serviços, consulte o artigo Ativar serviços. Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

Na Google Cloud consola, aceda à página Integration Connectors > Ligações.
Aceda a Ligações
Selecione ou crie um projeto para usar no conector.
Clique em Criar associação.
É apresentada a página Criar associação.
Na secção Localização:
1. Clique em Região e, de seguida, selecione uma localização para a ligação.
  Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.
2. Clicar em Seguinte.
Na secção Detalhes da ligação, faculte os seguintes detalhes:
1. Conector: selecione MCP (pré-visualização).
2. Versão do conetor: selecione a versão do conetor a usar.
3. Nome da associação: introduza um nome para a associação.
  Importante: o nome da associação tem de ser exclusivo na região selecionada. O nome da associação tem de cumprir as seguintes regras:
  - O nome tem de conter letras minúsculas, números ou travessões.
  - O nome tem de começar com uma letra e terminar com uma letra ou um número.
  - O nome não pode ter mais de 49 carateres.
4. Descrição: (opcional) introduza uma descrição para a associação.
5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível de registo está definido como Error.
6. Conta de serviço: selecione a conta de serviço a usar para a associação. Certifique-se de que a conta de serviço tem as funções e autorizações de IAM relevantes.
7. Ponto final do MCP: (opcional) deixe em branco para usar o ponto final predefinido: /mcp. Se o ponto final for igual ao endereço do anfitrião, defina este valor como /. Aplicável apenas ao servidor HTTP de streaming.
8. Definições do nó de ligação: (opcional) configure as definições do nó de ligação.
  - Número mínimo de nós: introduza o número mínimo de nós de ligação.
  - Número máximo de nós: introduza o número máximo de nós de ligação.
  Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. Mais nós processam mais transações para uma ligação e menos nós processam menos transações. Para compreender como os nós afetam os preços dos conetores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, o número mínimo de nós é 2 (para uma melhor disponibilidade) e o número máximo de nós é 50.
  
  Nota: só pode personalizar os valores dos nós de associação se for cliente de pagamento conforme o uso.
9. Clicar em Seguinte.
Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual estabelecer ligação.
1. Tipo de destino: selecione o tipo de destino.
  - Para especificar o nome de anfitrião ou o endereço IP de destino, selecione Endereço do anfitrião e introduza o endereço no campo Anfitrião 1.
  - Para estabelecer uma ligação privada, selecione Anexo do ponto final e escolha o anexo necessário na lista Anexo do ponto final.
    Nota: para saber como criar uma associação de ponto final, consulte Associação de serviço do PSC e Associação de ponto final. Depois de criar a associação do ponto final, esta fica visível na lista Associação do ponto final.
  Se quiser estabelecer uma ligação pública aos seus sistemas de back-end com segurança adicional, pode considerar configurar endereços IP estáticos de saída para as suas ligações e, em seguida, configurar as regras da firewall para permitir apenas os endereços IP estáticos específicos.
  
  Exemplos de endereços de anfitrião a usar:
  - https://your-service.example.com/sse (Sem autenticação)
  - https://your-oauth-provider.example.com/sse (OAuth 2.0 – Código de autorização)
  - https://your-api-key-service.example.com/sse (autenticação da chave da API)
2. Para introduzir destinos adicionais, clique em +Adicionar destino.
3. Clicar em Seguinte.
Na secção Autenticação, selecione e configure a autenticação para a ligação:
Sem autenticação

Este tipo é usado para anfitriões sem requisitos de autenticação específicos.
OAuth 2.0 – Código de autorização

Este tipo é usado para anfitriões que suportam o tipo de concessão de código de autorização OAuth 2.0.
1. ID de cliente: introduza o ID de cliente fornecido pela sua aplicação externa.
2. Âmbitos: introduza os âmbitos de autorização necessários.
3. Segredo do cliente: escolha o segredo do Secret Manager que contém o segredo do cliente.
4. Versão do Secret: selecione a versão do Secret do Secret Manager para o segredo do cliente.
5. Ativar PKCE: opcional: ative o PKCE para o fluxo de código de autorização. Ative apenas se o servidor suportar PKCE.
6. URL de autorização: introduza o URL de autorização.
7. URL do token de acesso: introduza o URL para obter o token de acesso.
Para a autenticação Authorization code, depois de criar a associação, tem de concluir alguns passos adicionais para concluir a configuração da autenticação. Para mais informações, consulte Passos adicionais após a criação da associação.

Nota: se estiver a usar a autenticação Authorization code e tiver feito alterações de configuração na sua aplicação, tem de autorizar novamente a ligação. Para autorizar novamente, consulte o artigo Autorização novamente para o código de autorização.

Passos adicionais após a criação da associação

Se selecionou OAuth 2.0 – Código de autorização para autenticação, tem de concluir os seguintes passos adicionais após criar a associação:
1. Na página Associações, localize a associação criada recentemente.
2. O estado da nova associação é Autorização necessária.
3. Clique em Autorização obrigatória.
  É apresentado o painel Editar autorização.
4. Copie o valor do URI de redirecionamento para a sua aplicação externa.
5. Valide os detalhes da autorização.
6. Clique em Autorizar.
  Se a autorização for bem-sucedida, o estado da associação é definido como Ativo na página Associações.
Autenticação de chaves de API

Este tipo é usado para anfitriões que requerem uma chave da API para autenticação.
- Chave da API: selecione o segredo do Secret Manager que contém a chave da API. Por exemplo, projects/PROJECT_ID/secrets/your-api-key-secret/versions/1.
- Nome do parâmetro da chave da API: o nome do parâmetro da chave da API. Por exemplo, Authorization.
- Localização da chave da API: a localização onde a chave da API é enviada. Por exemplo, Header.
Clicar em Seguinte.
Na secção Rever, reveja os detalhes da ligação e da autenticação. Para fazer alterações, clique em qualquer uma das secções anteriores.
Clique em Criar.
O Integration Connectors começa a criar a ligação com a configuração fornecida. A criação da associação demora alguns minutos. Depois de criar a associação, o sistema redireciona para a página Associações.

Use a ligação MCP numa integração

Depois de criar a ligação, esta fica disponível na integração de aplicações. Pode usar a ligação numa integração através da tarefa Conectores.

Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Crie uma integração através do conetor da MCP

Para criar uma integração através do conector da MCP, siga estes passos:

Adicione um acionador de API à sua integração:
1. Na Google Cloud consola, aceda à página Application Integration.
  Aceda à solução Application Integration
2. No menu de navegação, clique em Integrações. É apresentada a página Lista de integrações.
3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.
4. Se estiver a criar uma nova integração:
  1. Introduza um nome e uma descrição da integração no painel Criar integração.
  2. Selecione uma região para a integração.
    O menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu Google Cloud projeto. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
  3. Opcional. Selecione uma conta de serviço para a integração.
    A opção para selecionar uma conta de serviço só é apresentada se tiver ativado a gestão da integração para a região selecionada.
  4. Clique em Criar. A integração recém-criada é aberta no editor de integrações.
5. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
6. Clique e coloque o elemento Acionador da API no criador.
Adicione o Mapeamento de dados, se necessário.
Aceda a Tasks e escolha um dos conetores indicados acima ou o que criou, se aplicável.
Clique em Configurar conetor e escolha as ações. As predefinições estão pré-selecionadas.
É apresentado um menu pendente com várias ações, que são ferramentas neste contexto.
1. Configure os parâmetros de entrada necessários para a ação. Pode defini-los como entradas de integração, usar variáveis de tarefas anteriores ou especificar valores predefinidos diretamente.
2. Transmita os argumentos necessários e teste a ligação.

Para ver a lista de entidades e operações suportadas, consulte o artigo Entidades e operações suportadas. Para obter informações sobre as ações específicas do conetor suportadas, consulte o artigo Ações suportadas.

Exemplo de utilização na solução Application Integration

Os exemplos seguintes demonstram como usar a tarefa Connectors na integração de aplicações para realizar operações através da sua ligação MCP configurada.

Exemplo: Jira: criar problema

Para criar um problema no Jira através de uma ligação MCP:

Na caixa de diálogo da tarefa Configurar conetor, selecione a sua associação do MCP do Jira (por exemplo, jira-connection).
Clique em Ações.
Selecione a ação create_issue.
Clique em Concluído.

Na secção Entrada da tarefa, transmita os seguintes argumentos:

{
  "fields": {
    "project": {
      "key": "YOUR_PROJECT_KEY"
    },
    "summary": "New issue created from Integration Connectors",
    "issuetype": {
      "name": "Task"
    },
    "description": "This is a test issue created via the MCP Jira connector."
  }
}

Crie associações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de associações, consulte o modelo de exemplo.

Quando cria esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
proxy_enabled	BOOLEAN	Falso	Definido como verdadeiro para configurar um servidor proxy para a ligação.
proxy_auth_scheme	ENUM	Falso	O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user	STRING	Falso	Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password	SECRET	Falso	Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype	ENUM	Falso	O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL