Pré-lançamento

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Conector MCP

Com o conector do Protocolo de Contexto de Modelo (MCP), é possível criar e configurar uma conexão MCP no Integration Connectors. Você pode usar essa conexão nos seus aplicativos de negócios para trocar dados com segurança e realizar operações com o MCP.

Para conferir a lista de entidades e operações compatíveis, consulte Exemplos de operações de entidade. Para informações sobre as ações específicas do conector compatíveis, consulte Ações.

Todas as conexões nos Integration Connectors fornecem uma camada de abstração para os objetos de serviço subjacentes. Esses objetos são expostos como entidades gerenciáveis, permitindo que você execute operações padrão ou use ações específicas do conector.

Versões do conector MCP

O conector da MCP é compatível com duas versões:

• MCP v1: use esta versão do conector para acessar a API MCP v1.
• MCP v2: use esta versão do conector para acessar a API MCP v2.

Para informações sobre como criar uma conexão do MCP, consulte Criar e configurar um conector do MCP.

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

Observação:você pode ver as entidades, as operações e as ações de um conector na tarefa de conectores.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não for compatível com nenhuma das operações de entidade, essas operações não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Observação : todas as entidades e ações terão um esquema associado a elas. Por exemplo, um esquema de ação terá os detalhes do parâmetro, como: os nomes do parâmetro e tipos de dados correspondentes. O esquema (metadados) de entidades e ações é buscado pela conexão no ambiente de execução do back-end. Se houver atualizações no esquema, elas não serão refletidas automaticamente nas suas conexões, faça isso manualmente. Para atualizar o esquema de uma conexão, abra a página Detalhes da conexão e clique em Atualizar esquema de conexão.

Entidades e operações compatíveis

O conector MCP é compatível com entidades e operações, e as específicas disponíveis dependem da ferramenta conectada pelo MCP.

Exemplos de operações de entidade

Esta seção fornece exemplos de operações de entidade para diferentes ferramentas.

Listar entidade de problemas do Jira

Este exemplo lista todos os problemas na entidade Problemas usando uma conexão do MCP do Jira.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Problemas na lista Entidade.
3. Selecione a operação List e clique em Done.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

Listar todas as solicitações

Este exemplo lista todas as Solicitações na entidade Solicitações.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Solicitações na lista Entidade.
3. Selecione a operação List e clique em Done.

Receber um usuário por ID

Este exemplo recebe o usuário com AccountId como "6035864ce2020c0070b5285b" da entidade Users. AccountId é a chave primária da entidade Users. Para receber uma entidade específica, use a operação List com um filterClause na chave primária, já que a operação Get não é compatível com essa entidade.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Usuários na lista Entidade.
3. Selecione a operação List e clique em Done.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em filterClause e insira `AccountId`=6035864ce2020c0070b5285b no campo Valor padrão.

Ações

O conector MCP oferece várias ações, e as específicas disponíveis dependem da ferramenta conectada pelo MCP.

Exemplos de ações

Nesta seção, descrevemos como realizar algumas das ações disponíveis no conector do MCP para diferentes ferramentas.

Ações do Jira: receber problemas

Este exemplo demonstra como listar problemas do Jira usando uma conexão do MCP configurada para o Jira.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação get_issues e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Ações lineares: listar problemas

Este exemplo demonstra como listar problemas no Linear usando uma conexão do MCP configurada para o Linear.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação list_issues e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "limit": 50
     }

Sentry Actions: Whoami

Este exemplo demonstra como receber informações do usuário do Sentry usando uma conexão do MCP configurada para o Sentry.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação whoami e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "name": "example-org"
     }

Encontrar organizações

Este exemplo demonstra como encontrar organizações no Sentry usando uma conexão do MCP configurada para o Sentry.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação find_organizations e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {}

Ações do Intercom: pesquisar conversas

Este exemplo demonstra como pesquisar detalhes de conversas no Intercom usando uma conexão da MCP configurada para o Intercom.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação pesquisar e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

Limitações do sistema

O conector do MCP tem limitações de sistema que podem variar de acordo com a ferramenta específica conectada. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Observação:o número de nós do Integration Connectors será escalonado automaticamente de forma dinâmica com base no seu uso. No entanto, se você quiser reservar capacidade para grandes volumes sem esperar pelo escalonamento automático, ajuste o valor mínimo do nó para uma conexão. Mais nós são necessários para processar mais transações para uma conexão. Por outro lado, menos nós são necessários se uma conexão processar menos transações. Para configurar os valores do nó, faça o seguinte:

• Se você for um cliente de pagamento por utilização, configure o valor mínimo e máximo do nó na página de edição da conexão.
• Se você for um cliente por assinatura, entre em contato com o suporte.

O número máximo de transações que um nó pode processar depende de vários fatores. Portanto, antes de ajustar o número mínimo de nós para melhorar a capacidade de processamento, recomendamos que você verifique se os sistemas de back-end estão configurados de maneira ideal para lidar com o tráfego necessário.