
Conectar no Microsoft Foundry
Microsoft Foundry — o NewAlgorithm como ferramenta MCP dos agentes do Agent Service.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 1
Gere sua chave de API
Entre em app.newalgorithm.io com sua conta, abra Chaves e apps e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chavena_live_xxxxxxxxxxxxxxxxx - 2
Guarde a chave no Key Vault
Grave a chave de API como segredo do Azure Key Vault e dê acesso à identidade gerenciada do projeto. A chave não deve aparecer em código nem em variáveis de ambiente compartilhadas.
- 3
Pelo portal: adicione a ferramenta
No projeto do Foundry, abra o agente e vá em Tools → Add → MCP server. Informe o rótulo, a URL do servidor e o cabeçalho de autorização.
URL do servidor e cabeçalhohttps://totvs.mcp.newalgorithm.io/mcp Authorization: Bearer na_live_xxxxxxxxxxxxxxxxx - 4
Ou declare pelo SDK
Em Python, a ferramenta MCP é declarada com McpTool e os cabeçalhos entram por update_headers:
Pythonimport os from azure.ai.agents.models import McpTool na = McpTool( server_label="newalgorithm", server_url="https://totvs.mcp.newalgorithm.io/mcp", allowed_tools=["na_search", "na_route", "na_specialists", "na_version"], ) na.update_headers("Authorization", f"Bearer {os.environ['NA_API_KEY']}") agent = project.agents.create_agent( model="gpt-4o", name="agente-sap", instructions=( "Consulte o NewAlgorithm antes de responder qualquer coisa sobre SAP. " "Deixe o Manager Agent escolher o Specialist." ), tools=na.definitions, ) - 5
Decida a política de aprovação
Por padrão o Agent Service pede aprovação a cada chamada de ferramenta MCP. Em automações sem humano no circuito, ajuste esse comportamento conscientemente — é uma decisão de governança, não de conveniência.
na.set_approval_mode("never") - 6
Confirme
Rode uma thread de teste com uma pergunta de SAP e verifique no rastro da execução que as ferramentas na_* foram chamadas.
Passe allowed_tools com a lista explícita: além de reduzir a superfície exposta ao agente, deixa registrado no código o que aquele agente pode consultar.
Detalhes de autenticação e ferramentas na Documentação.