Conectar-se aos servidores do Protocolo de Contexto de Modelo (versão prévia) (clássico)

Você pode estender os recursos do agente do Foundry conectando-o a ferramentas hospedadas em servidores do PROTOCOLO MCP remotos (traga seu próprio endpoint de servidor MCP). Desenvolvedores e organizações mantêm esses servidores. Os servidores expõem ferramentas que clientes compatíveis com MCP, como o Serviço do Foundry Agent, podem acessar.

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

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

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

Os servidores MCP remotos que você decide usar com a ferramenta MCP descrita neste artigo foram criados por terceiros, não Microsoft. Microsoft não testou nem verificou esses servidores. Microsoft não tem nenhuma responsabilidade com você ou com outras pessoas em relação ao uso de servidores MCP remotos.

Recomendamos que você examine e acompanhe cuidadosamente quais servidores MCP você adiciona ao Serviço do Foundry Agent. Também recomendamos que você confie em servidores hospedados por provedores de serviços confiáveis em vez de proxies.

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

Como funciona

Você precisa conectar um servidor MCP remoto (um ponto de extremidade de servidor MCP existente) ao Serviço do Agente do Foundry. 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 examinar cuidadosamente quais servidores MCP você adiciona ao Serviço do Agente do Foundry.

A ferramenta MCP dá suporte a cabeçalhos personalizados, para que você possa se conectar aos servidores MCP usando os esquemas de autenticação necessários ou passando outros cabeçalhos que os servidores MCP exigem. Você só pode especificar cabeçalhos incluindo-os em tool_resources a 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 você passa estão disponíveis somente 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 Protocolo de Contexto de Modelo.
• Compreendendo e mitigando riscos de segurança em implementações do MCP no Blog da Comunidade de Segurança da Microsoft.

Suporte ao uso

Configuração

1. Crie um agente do Foundry seguindo as etapas no início rápido.

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

   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 mcp ferramenta 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 requer.
   3. require_approval: opcionalmente, determine se a aprovação é necessária. Os valores com suporte são:
      • always: um desenvolvedor precisa fornecer aprovação para cada chamada. Se você não fornecer um valor, este será o padrão.
      • never: nenhuma aprovação é necessária.
      • {"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 em seu servidor MCP com a aprovação necessária, você obterá um status de execução de requires_action. No requires_action campo, você pode obter mais detalhes sobre a ferramenta no servidor MCP que é chamada, os argumentos que devem ser passados e o valor call_id. Examine a ferramenta e os argumentos para que você possa tomar uma decisão informada para aprovação.

5. Envie sua aprovação para o agente usando call_id definindo approve como true.

Hospedar um servidor MCP local

O runtime do Serviço de Agente aceita apenas um ponto de extremidade remoto do servidor MCP. Se você quiser adicionar ferramentas de um servidor MCP local, precisará hospedá-lo por conta própria em Aplicativos de Contêiner do Azure ou Azure Functions para obter um endpoint remoto do servidor MCP. Preste atenção às seguintes considerações ao tentar hospedar servidores MCP locais na nuvem:

Limitações conhecidas

• Tempo limite de chamada da ferramenta MCP sem streaming: chamadas de ferramenta MCP sem streaming têm um tempo limite de 50 segundos. Se o servidor MCP levar mais de 50 segundos para responder, a chamada falhará. Para evitar tempos limite, verifique se o servidor MCP responde dentro desse limite. Se o caso de uso exigir tempos de processamento mais longos, considere otimizar a lógica do lado do servidor ou dividir a operação em etapas menores.

Conteúdo relacionado

• Exemplos de código para a ferramenta Protocolo de Contexto de Modelo