Liga-te aos servidores do Model Context Protocol (pré-visualização) (clássico)

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

O MCP é um padrão aberto que define como as aplicações fornecem ferramentas e dados contextuais a grandes modelos de linguagem (LLMs). Permite a integração consistente e escalável de ferramentas externas nos fluxos de trabalho dos modelos.

Considerações para a utilização de serviços e servidores que não sejam da serviços Microsoft

A sua utilização de serviços não Microsoft conectados está sujeita aos termos entre você e o fornecedor de serviços. Quando se liga a um serviço que não é da Microsoft, alguns dos seus dados (como conteúdo de prompts) são passados para o serviço não-Microsoft, ou a sua aplicação pode receber dados do serviço não Microsoft. És responsável pela utilização de serviços e dados que não sejam da serviços Microsoft, bem como por quaisquer encargos associados a esse uso.

Os servidores MCP remotos que decide usar com a ferramenta MCP descrita neste artigo foram criados por terceiros, não pela Microsoft. A Microsoft não testou nem verificou estes servidores. A Microsoft não tem qualquer responsabilidade para consigo ou para com outros relativamente à utilização de quaisquer servidores MCP remotos.

Recomendamos que reveja cuidadosamente e acompanhe os servidores MCP que adiciona ao Foundry Agent Service. Recomendamos também que confie em servidores alojados pelos próprios fornecedores de serviços de confiança em vez de proxies.

A ferramenta MCP permite-lhe passar cabeçalhos personalizados, como chaves ou esquemas de autenticação, que um servidor MCP remoto possa precisar. Recomendamos que reveja todos os dados partilhados com servidores MCP remotos e que registe esses dados para efeitos de auditoria. Esteja atento às práticas não Microsoft para retenção e localização de dados.

Como funciona

Precisa trazer um servidor MCP remoto (um endpoint existente do servidor MCP) para Foundry Agent Service. Podes trazer vários servidores MCP remotos adicionando-os como ferramentas. Para cada ferramenta, é necessário fornecer um valor único server_label dentro do mesmo agente e um server_url valor que aponte para o servidor MCP remoto. Certifique-se de rever cuidadosamente quais os servidores MCP que adiciona ao Foundry Agent Service.

A ferramenta MCP suporta cabeçalhos personalizados, por isso pode ligar-se aos servidores MCP usando os esquemas de autenticação que eles exigem ou passando outros cabeçalhos que os servidores MCP exigem. Só podes especificar cabeçalhos incluindo-os tool_resources em cada execução. Desta forma, pode colocar chaves API, tokens de acesso OAuth ou outras credenciais diretamente no seu pedido.

O cabeçalho mais utilizado é o cabeçalho de autorização. Os cabeçalhos que você passa estão disponíveis apenas para a execução atual e não são persistidos.

Para mais informações sobre a utilização do MCP, veja:

• Melhores Práticas de Segurança no site Model Context Protocol.
• Compreender e mitigar riscos de segurança nas implementações de MCP no Blogue da Comunidade Microsoft Security.

Suporte de utilização

Configuração

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

2. Encontra o servidor MCP remoto ao qual queres ligar-te, 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 único deste servidor MCP para o agente; por exemplo, github.
   3. allowed_tools: Uma lista opcional de ferramentas a que este agente pode aceder e utilizar.

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

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

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

5. Submeta a sua aprovação ao agente com call_id ao definir approve para true.

Hospedar um servidor MCP local

O runtime do Agent Service só aceita um endpoint remoto de servidor MCP. Se quiseres adicionar ferramentas a partir de um servidor MCP local, terás de o auto-hospedar em Azure Container Apps ou Funções do Azure para obter um endpoint remoto de servidor MCP. Preste atenção às seguintes considerações ao tentar alojar servidores MCP locais na cloud:

Limitações conhecidas

• Tempo limite para chamadas de ferramenta MCP não streaming: Chamadas de ferramentas MCP não streaming têm um timeout de 50 segundos. Se o seu servidor MCP demorar mais de 50 segundos a responder, a chamada falha. Para evitar tempos de espera, certifique-se de que o seu servidor MCP responde dentro desse limite. Se o seu caso de uso exigir tempos de processamento mais longos, considere otimizar a lógica do lado do servidor ou dividir a operação em passos mais pequenos.

Conteúdo relacionado

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