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 as ferramentas do MCP para conectar seu aplicativo de agente a um servidor do 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. 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 servidorGoogle Cloud MCP.
Autenticação
As ferramentas MCP têm as mesmas opções de autenticação das ferramentas OpenAPI.
Cabeçalhos personalizados
É possível fornecer cabeçalhos HTTP personalizados para serem enviados em solicitações ao servidor do MCP. Também é possível injetar variáveis do contexto da sessão nesses cabeçalhos. Para mais informações, consulte Variáveis de contexto da sessão.
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.
Cabeçalhos personalizados
É possível definir cabeçalhos personalizados que são incluídos ao enviar solicitações HTTP para o servidor MCP (solicitações de lista de ferramentas e execução de ferramentas). Os valores desses cabeçalhos precisam ser fornecidos por variáveis. Portanto, para definir um cabeçalho personalizado, primeiro defina uma variável que vai conter o valor do cabeçalho. Se uma variável não tiver um valor e não houver um valor padrão no tempo de execução, o cabeçalho não será incluído nas solicitações.
Criar a ferramenta MCP
Para criar uma ferramenta do MCP no console do Google Cloud:
- 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.
- Se quiser, defina cabeçalhos personalizados fornecendo nomes de cabeçalho e variáveis usadas como valores de cabeçalho.
- 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 outras ferramentas ao agente, recomendamos testar pelo menos uma para garantir que as informações de autenticação estejam configuradas corretamente.