Vista geral do protocolo Model Context Protocol (MCP) no Apigee

Esta página aplica-se ao Apigee, mas não ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Esta página descreve como usar o Apigee para expor os seus produtos de API como ferramentas de MCP a aplicações com agentes. Pode aplicar políticas do Apigee aos seus produtos de API para fornecer uma camada de segurança e controlo sobre a forma como as suas ferramentas do MCP são usadas.

O que é o MCP?

O protocolo Model Context Protocol (MCP) é um protocolo de código aberto desenvolvido pela Anthropic que padroniza a forma como as aplicações de IA se ligam a origens de dados, fluxos de trabalho e ferramentas.

As aplicações de IA podem usar o MCP para aceder aos serviços Google Cloud e Apigee como ferramentas. Neste contexto, os seguintes termos do MCP são úteis para compreender:

  • Anfitrião do MCP: a aplicação ou o ambiente de IA que interage com o utilizador. O anfitrião do MCP usa grandes modelos de linguagem (GMLs) para processar pedidos que podem exigir dados ou ferramentas externos.
  • Cliente MCP: um componente no anfitrião do MCP que ajuda o GML e o servidor MCP a comunicarem entre si. Traduz os pedidos do MDG para o MCP e converte as respostas do MCP para o MDG. Também encontra e usa servidores MCP disponíveis.
  • Servidor MCP: o serviço externo que fornece contexto, dados ou capacidades ao MDG, atuando como um proxy entre o MDG e o cliente MCP.

Como funciona a MCP no Apigee

Os pontos finais do MCP para o Google, Google Cloude o Apigee implementam a especificação do servidor MCP. Isto permite que os clientes do MCP em conformidade acedam a eles para:

  • Descubra os pontos finais disponíveis.
  • Indicar as ferramentas disponíveis num ponto final.
  • Autentique-se num ponto final.
  • Chamar ferramentas de acordo com as políticas de acesso definidas.
  • Receber respostas em streaming de ferramentas.

Qualquer cliente MCP que suporte pontos finais MCP remotos através de HTTP/S pode aceder a estas ferramentas. Uma vez que os pontos finais são geridos, não precisa de instalar nem gerir servidores MCP locais, servidores MCP remotos ou infraestrutura adicional para permitir que as aplicações baseadas em agentes acedam aos seus serviços.

O MCP no Apigee oferece compatibilidade com JSON-RPC para os métodos tools/list e tools/call. Pode personalizar o seu ponto final da MCP com parâmetros de deteção, segurança, disponibilidade de rede e observabilidade.

Principais funcionalidades do MCP no Apigee

O MCP no Apigee oferece funcionalidades para a descoberta de ferramentas, segurança e governação. Estas funcionalidades ajudam a gerir a forma como as aplicações autónomas interagem com os seus serviços.

Descoberta de ferramentas simplificada

Pode descobrir os pontos finais do MCP disponíveis para os serviços Apigee através de um serviço de diretório acessível através de uma interface REST. Cada ponto final do MCP também suporta o método tools/list do MCP, que permite que os clientes do MCP descubram as ferramentas disponíveis nesse ponto final.

Segurança

O MCP no Apigee inclui várias camadas de segurança para proteger os seus serviços. Pode controlar o acesso através da autenticação, da autorização, dos limites de rede e da análise de conteúdo.

Autenticação

Os pontos finais do MCP alojados no Apigee suportam a autenticação OAuth 2.1. Isto garante que apenas os agentes, os clientes do MCP e os utilizadores finais com identidades estabelecidas podem aceder aos seus pontos finais do MCP e chamar as ferramentas do MCP. Os metadados de recursos protegidos permitem que os clientes descubram os servidores de autorização OAuth.

Políticas de autorização detalhadas

Pode restringir o acesso às suas ferramentas do MCP com base nas identidades de cliente OAuth, incluindo a identidade do utilizador final. Por exemplo, pode configurar uma política no proxy de deteção do MCP para especificar que apenas os agentes designados com identidades de cliente conhecidas podem aceder a uma ferramenta do MCP para um serviço de pagamentos.

Estatísticas centralizadas

Para pontos finais alojados no Apigee, pode ver informações de utilização da ferramenta MCP no Apigee Analytics.

Usar o MCP com o Apigee

Pode expor as suas APIs Apigee existentes como ferramentas MCP e torná-las acessíveis através de pontos finais da MCP. Estes pontos finais podem ser configurados ao nível de cada anfitrião ou grupo de ambientes. Por exemplo, se a sua organização Cymbal tiver oito nomes de anfitrião (por exemplo, api.Cymbal.com, partners.Cymbal.com), cada um associado a um grupo de ambientes diferente, pode alojar um servidor MCP dedicado para cada nome de anfitrião.

Um ponto final alvo gerido (mcp.apigee.internal) é implementado através de um proxy de descoberta do MCP especializado na sua organização do Apigee, onde os seus servidores MCP são disponibilizados.

A tabela seguinte mostra um exemplo de como os clientes, incluindo a organização fictícia Cymbal, podem configurar vários pontos finais da MCP através do Apigee.

Cliente Nome do anfitrião e caminho base do MCP Ponto final de destino do servidor MCP API proxy e produto Ferramentas
Cymbal api.cymbal.com/mcp mcp.apigee.internal
(Projeto de inquilino do Cymbal)		 mcp-api-proxy1 e api-product1 Tool1..50
api-internal.cymbal.com/mcp mcp.apigee.internal
(Projeto de inquilino do Cymbal)		 mcp-api-proxy2 e api-product2 Tool51..100
api-service.cymbal.com/mcp mcp.apigee.internal
(Projeto de inquilino do Cymbal)		 mcp-api-proxy3 e api-product3 Tool101..130

Limitações

As seguintes limitações aplicam-se ao lançamento da pré-visualização privada da MCP no Apigee:

  • O tamanho total da especificação OpenAPI está limitado a 1 MB ao nível da organização.
  • O MCP no Apigee suporta as seguintes versões da OpenAPI: 3.0.0, 3.0.1 e 3.0.2. 3.0.3.
  • O MCP no Apigee não está disponível para utilização com organizações do Apigee Hybrid ou organizações do Apigee que têm de cumprir os requisitos de residência dos dados.

Além disso, tenha em atenção que esta oferta de pré-visualização privada do MCP no Apigee não é adequada para utilização no ambiente de produção.

O que se segue?