Microsoft lança Toolboxes no Foundry: um endpoint MCP único pra todos os tools dos seus agentes

A Microsoft liberou o Toolbox no Foundry em public preview. A ideia: você define um conjunto de tools uma vez, gerencia central no Foundry, e expõe tudo num endpoint MCP (Model Context Protocol) único que qualquer agente consome. Sem refazer auth, credencial e código de integração em cada agente novo.

O problema que tá atacando

Hoje cada time monta agente num framework diferente, e cada agente fia as tools na mão: auth própria, credencial própria, código de integração próprio. Quando a empresa escala uso de agente, isso vira trabalho duplicado, comportamento inconsistente e deploy frágil em produção.

O exemplo que a Microsoft usa é onboarding de dev. Um agente que provisiona ambiente pra engenheiro novo precisa: criar conta Entra ID, dar acesso a repo no GitHub, subir recursos de cloud, criar tarefa no Azure DevOps e mandar mensagem no Teams. São 5 tools, 5 tipos diferentes (APIs, MCP servers, skills, connectors, flows), 5 modelos de autenticação, 5 times donos. Multiplica isso por cada agente da empresa e o gargalo não é mais o modelo: é integração de tool.

Na prática, é o mesmo problema que API gateway resolveu pra microsserviço há 10 anos, só que agora aplicado a tool calling de agente. Faz sentido a Microsoft empacotar isso no Foundry, já que eles já têm gateway, cofre de credencial, política e observabilidade rodando no Azure.

Os 4 pilares

O Toolbox cobre o ciclo de vida de tool em 4 pilares. No public preview saem só dois (Build e Consume):

• Discover (em breve): achar a tool certa sem garimpar catálogo enorme.
• Build (já): montar o toolbox, um bundle nomeado e reusável de tools.
• Consume (já): endpoint MCP único que expõe todas as tools do bundle pra qualquer runtime de agente.
• Govern (em breve): auth centralizada e observabilidade em cada chamada que passa pelo toolbox.

Build: o que cabe num Toolbox

Tools suportadas no preview:

• Built-in: Web Search, Code Interpreter, File Search, Azure AI Search
• Protocolos: MCP, Agent-to-Agent (A2A), OpenAPI

Autenticação sai central via OAuth identity passthrough ou Microsoft Entra managed identity. Agente individual não mexe com credencial.

Consume: um endpoint, qualquer agente

Quando você publica um toolbox, o Foundry devolve um endpoint MCP único pro bundle inteiro:

https://zava.services.ai.azure.com/api/projects/<project>/toolbox/<toolbox-name>/mcp?api-version=v1

Com esse endpoint, o agente:

• Descobre e invoca todas as tools dinamicamente
• Atravessa múltiplos protocolos e modelos de auth de forma transparente
• Usa uma versão production-ready enquanto o toolbox continua evoluindo

Foundry-homed, não Foundry-bound

A pergunta óbvia: "tô preso no Foundry Agents?" A Microsoft responde que não, e diz que foi decisão de design. O toolbox é criado e governado no Foundry, mas o consumo é aberto. Qualquer runtime que fale MCP usa.

Isso inclui:

• Agentes custom: Microsoft Agent Framework, LangGraph ou código próprio
• Agentes de código: GitHub Copilot, Claude Code e IDEs com MCP

Incluir Claude Code explicitamente na lista é curioso. A Microsoft tá admitindo que dev BR que usa Foundry provavelmente também usa Claude Code no editor, e facilitar essa vida é melhor do que tentar empurrar só Copilot. Pragmatismo raro.

Como começa na prática

Fluxo básico em 5 passos:

1. Setup do client do projeto Foundry:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
import os

client = AIProjectClient(
    endpoint=os.environ["FOUNDRY_PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential()
)

2. Criar o toolbox com client.beta.toolboxes.create_toolbox_version(...), combinando web search, Azure AI Search sobre documentação interna e um MCP server do GitHub pra agir.

3. Atachar a um agente via MCPStreamableHTTPTool do Microsoft Agent Framework, apontando pro endpoint do toolbox. Auth vai via DefaultAzureCredential e bearer token injetado em cada request.

4. Rodar o agente com chat_client.as_agent(name=..., instructions=SYSTEM_PROMPT, tools=[mcp_tool]).

5. Promover versão production-ready:

toolbox = client.beta.toolboxes.update(
    toolbox_name="my-toolbox",
    default_version="<version_id>",
)

Depois de promover, o endpoint sem número de versão vira o default e quem consome não precisa mexer em código quando você publica versão nova.

Pra começar

Documentação oficial, AZD CLI, código sample pra Microsoft Agent Framework, LangGraph e Copilot SDK. Dá pra começar pelo Foundry Portal (Build → Tools) ou pelo Foundry Toolkit pro VS Code (pre-release).