Conectar-se a servidores do Protocolo Contexto de Modelo (em versão de visualização)

Pode expandir as capacidades do seu agente Foundry conectando-o a ferramentas em execução em servidores remotos do Model Context Protocol (MCP) (utilizar o seu próprio endpoint de servidor MCP). Desenvolvedores e organizações mantêm esses servidores. Os servidores expõem ferramentas a que clientes compatíveis com MCP, como o Foundry Agent Service, podem aceder.

MCP é um padrão aberto que define como os aplicativos fornecem ferramentas e dados contextuais para grandes modelos de linguagem (LLMs). Ele permite a integração consistente e escalável de ferramentas externas em fluxos de trabalho de modelo.

Considerações sobre o uso de serviços e servidores que não sejam da Microsoft

Seu uso de serviços conectados que não sejam da Microsoft está sujeito aos termos entre você e o provedor de serviços. Quando você se conecta a um serviço que não é da Microsoft, alguns dos seus dados (como conteúdo de prompt) são passados para o serviço que não é da Microsoft ou seu aplicativo pode receber dados do serviço que não é da Microsoft. O Cliente é responsável pela sua utilização de serviços e dados que não sejam da Microsoft, juntamente com quaisquer encargos associados a essa utilização.

Os servidores MCP remotos que você decide usar com a ferramenta MCP descrita neste artigo foram criados por terceiros, não pela Microsoft. A Microsoft não testou nem verificou esses servidores. A Microsoft não tem qualquer responsabilidade perante si ou terceiros em relação à sua utilização de quaisquer servidores MCP remotos.

Recomendamos que você analise e acompanhe cuidadosamente quais servidores MCP você adiciona ao Foundry Agent Service. Também recomendamos que você confie em servidores hospedados pelos próprios provedores de serviços confiáveis em vez de proxies.

A ferramenta MCP permite que você passe cabeçalhos personalizados, como chaves de autenticação ou esquemas, que um servidor MCP remoto pode precisar. Recomendamos que você revise todos os dados compartilhados com servidores MCP remotos e registre os dados para fins de auditoria. Esteja ciente das práticas que não são da Microsoft para retenção e localização de dados.

Como funciona

Você precisa ligar um servidor MCP remoto (um ponto de extremidade de servidor MCP existente) ao Foundry Agent Service. Você pode trazer vários servidores MCP remotos adicionando-os como ferramentas. Para cada ferramenta, você precisa fornecer um valor exclusivo server_label dentro do mesmo agente e um server_url valor que aponte para o servidor MCP remoto. Certifique-se de revisar cuidadosamente quais servidores MCP você adiciona ao Foundry Agent Service.

A ferramenta MCP oferece suporte a cabeçalhos personalizados, para que você possa se conectar aos servidores MCP usando os esquemas de autenticação que eles exigem ou passando outros cabeçalhos que os servidores MCP exigem. Você pode especificar cabeçalhos somente incluindo-os em tool_resources cada execução. Dessa forma, você pode colocar chaves de API, tokens de acesso OAuth ou outras credenciais diretamente em sua solicitação.

O cabeçalho mais usado é o cabeçalho de autorização. Os cabeçalhos que são passados estão disponíveis apenas para a execução atual e não são persistentes.

Para obter mais informações sobre como usar o MCP, consulte:

• Práticas recomendadas de segurança no site do Model Context Protocol.
• Compreendendo e mitigando riscos de segurança em implementações MCP no Blog da Comunidade de Segurança da Microsoft.

Suporte de utilização

Configuração

1. Crie um agente da Foundry seguindo os passos do quickstart.

2. Localize o servidor MCP remoto ao qual você deseja se conectar, como o servidor MCP do GitHub. Crie ou atualize um agente Foundry com uma mcp ferramenta com a seguinte informação:

   1. server_url: A URL do servidor MCP; por exemplo, https://api.githubcopilot.com/mcp/.
   2. server_label: Um identificador exclusivo deste servidor MCP para o agente; por exemplo, github.
   3. allowed_tools: Uma lista opcional de ferramentas que este agente pode acessar e usar.

3. Crie uma execução e passe informações adicionais sobre a ferramenta mcp em tool_resources com cabeçalhos:

   1. tool_label: Use o identificador que você forneceu quando criou o agente.
   2. headers: Passe um conjunto de cabeçalhos que o servidor MCP exige.
   3. require_approval: Opcionalmente, determine se a aprovação é necessária. Os valores suportados são:
      • always: Um desenvolvedor precisa fornecer aprovação para cada chamada. Se você não fornecer um valor, este é o padrão.
      • never: Não é necessária aprovação.
      • {"never":[<tool_name_1>, <tool_name_2>]}: Você fornece uma lista de ferramentas que não exigem aprovação.
      • {"always":[<tool_name_1>, <tool_name_2>]}: Você fornece uma lista de ferramentas que exigem aprovação.

4. Se o modelo tentar invocar uma ferramenta no servidor MCP com aprovação necessária, você obterá um status de execução de requires_action. No campo requires_action, pode obter mais detalhes sobre qual ferramenta é utilizada no servidor MCP, os argumentos a serem passados e o valor de call_id. Reveja a ferramenta e os argumentos para que possa tomar uma decisão informada para aprovação.

5. Envie sua aprovação ao agente definindo call_id como approvetrue.

Hospedar um servidor MCP local

O runtime do Agent Service só aceita um endpoint remoto de servidor MCP. Se quiser adicionar ferramentas de um servidor MCP local, terá que auto-hospedá-lo nos Aplicações de Contentor do Azure ou nas Azure Functions para obter um endpoint de servidor MCP remoto. Preste atenção às seguintes considerações ao tentar hospedar servidores MCP locais na nuvem:

Conteúdo relacionado

• Exemplos de código para a ferramenta Model Context Protocol