← Todas as conexões

Conectar no Microsoft Foundry

Microsoft Foundry — o NewAlgorithm como ferramenta MCP dos agentes do Agent Service.

Antes de começar, crie a sua conta gratuita.Criar conta

Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.

  1. 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 chave
    na_live_xxxxxxxxxxxxxxxxx
  2. 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. 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çalho
    https://totvs.mcp.newalgorithm.io/mcp
    Authorization: Bearer na_live_xxxxxxxxxxxxxxxxx
  4. 4

    Ou declare pelo SDK

    Em Python, a ferramenta MCP é declarada com McpTool e os cabeçalhos entram por update_headers:

    Python
    import 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. 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. 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.