O Protocolo de Contexto de Modelo (MCP) é um padrão de código aberto para conectar aplicativos de IA a sistemas externos. Ele estabelece um conjunto específico de entidades e uma estrutura definida, que funciona como uma maneira padrão de conectar várias fontes de dados e ferramentas a modelos de IA.
Você pode usar ferramentas do MCP para conectar seu aplicativo de agente a um servidor MCP atual.
Limitações
Considere as seguintes limitações:
- O CX Agent Studio só é compatível com servidores baseados em StreamableHttpTransport. Servidores de transporte SSE não são aceitos.
Criar ou selecionar um servidor MCP
Para criar seu próprio servidor do MCP, recomendamos usar os SDKs oficiais do MCP ou outros SDKs confiáveis de terceiros, como o FastMCP (link em inglês). Depois que o servidor MCP for criado, implante-o em um serviço de hospedagem. É possível usar o Cloud Run ou o Compute Engine para hospedar o servidor MCP. Siga este guia para entender o processo de ponta a ponta: Criar e implantar um servidor MCP remoto no Google Cloud Run em menos de 10 minutos.
Em vez de criar um servidor MCP do zero, você também pode usar um servidor MCP pré-criado, como um servidor MCPGoogle Cloud .
Autenticação
As ferramentas do MCP têm as mesmas opções de autenticação das ferramentas do OpenAPI.
Testar o servidor MCP de forma independente
Antes de conectar seus agentes ao servidor MCP, recomendamos testar o servidor MCP de forma independente.
Os servidores criados com StreamableHttpTransport
terminam com o sufixo (/mcp ou /mcp/).
Por exemplo, se o servidor estiver hospedado em https://example.com,
o URL correto para enviar solicitações ao servidor será https://example.com/mcp.
Para testar o servidor localmente, use curl ou Postman (que oferece suporte nativo a conexões MCP). Isso garante que o servidor esteja funcionando e que as informações de autenticação necessárias para se comunicar com ele sejam compreendidas.
Criar a ferramenta MCP
Para criar uma ferramenta do MCP no console:
- Clique no ícone de ferramenta no lado direito do criador de agentes.
- Selecione Ferramenta MCP.
- Forneça um nome para a ferramenta.
- Forneça uma descrição da ferramenta.
- Informe o endereço do servidor MCP.
- Selecione um tipo de autenticação.
- Clique em Criar.
Para servidores hospedados no Cloud Run, a opção de autenticação recomendada é o token de ID do agente de serviço.
Esse método usa a conta de serviço do CX Agent Studio
(no formato: service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com)
para enviar solicitações
ao job do Cloud Run.
Conceda o
papel de invocador do Cloud Run
à conta de serviço do CX Agent Studio
, para que ela possa enviar solicitações ao servidor usando a própria identidade.
Antes de adicionar mais ferramentas ao agente, recomendamos testar pelo menos uma para garantir que as informações de autenticação estejam configuradas corretamente.