APS MCP Server

IMPORTANTE: Este projeto foi movido para https://github.com/autodesk-platform-services/aps-mcp-server-nodejs.

---

aps-mcp-server

Servidor experimental do Model Context Protocol construído com Node.js, fornecendo acesso à API do Autodesk Platform Services, com controle de acesso refinado usando o novo recurso de Secure Service Accounts.

Vídeo no YouTube

Desenvolvimento

Pré-requisitos

• Node.js
• Credenciais do aplicativo APS (deve ser um tipo de aplicativo Server-to-Server)
• Acesso provisionado ao ACC ou BIM360

Configuração

Servidor

• Clone este repositório
• Instale as dependências: yarn install
• Compile o código TypeScript: yarn run build
• Crie um arquivo .env na pasta raiz deste projeto e adicione suas credenciais APS:
  • APS_CLIENT_ID - o ID do cliente do seu aplicativo APS
  • APS_CLIENT_SECRET - o segredo do cliente do seu aplicativo APS
• Crie uma nova conta de serviço: npx create-service-account <username> <first name> <last name>, por exemplo, npx create-service-account ssa-test-user John Doe
  • Este script gerará várias variáveis de ambiente com informações sobre a nova conta:
    • APS_SA_ID - o ID da sua conta de serviço
    • APS_SA_EMAIL - o e-mail da sua conta de serviço
    • APS_SA_KEY_ID - o ID da chave da sua conta de serviço
    • APS_SA_PRIVATE_KEY - a chave privada da sua conta de serviço
• Adicione essas variáveis de ambiente ao seu arquivo .env

Autodesk Construction Cloud

• Registre o ID do cliente do seu aplicativo APS como uma integração personalizada
• Convide o e-mail da conta de serviço como novo membro para seus projetos ACC

Uso com o Inspector

• Execute o Model Context Protocol Inspector: yarn run inspect
• Abra http://localhost:5173
• Clique em Connect para iniciar este servidor MCP e conectar-se a ele

Uso com o Claude Desktop

• Certifique-se de ter o Claude Desktop instalado
• Crie um arquivo de configuração do Claude Desktop se ainda não tiver um:
  • No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • No Windows: %APPDATA%\Claude\claude_desktop_config.json
• Adicione este servidor MCP à configuração, usando o caminho absoluto do arquivo build/server.js no seu sistema, por exemplo:

{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

• Abra o Claude Desktop e experimente alguns dos seguintes prompts de teste:
  • A quais projetos ACC tenho acesso?
  • Dê-me um painel visual de todos os problemas no projeto XYZ

Para mais detalhes sobre como adicionar servidores MCP ao Claude Desktop, consulte a documentação oficial.

Uso com Visual Studio Code e Copilot

• Certifique-se de ter habilitado servidores MCP no Visual Studio Code
• Crie o arquivo .vscode/mcp.json no seu workspace e adicione o seguinte JSON a ele:

{
    "servers": {
        "Autodesk Platform Services": {
            "type": "stdio",
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

Para mais detalhes sobre como adicionar servidores MCP ao Visual Studio Code, consulte a documentação

Uso com Cursor

• Crie o arquivo .cursor/mcp.json no seu workspace e adicione o seguinte JSON a ele:

{
  "mcpServers": {
    "Autodesk Platform Services": {
      "command": "node",
      "args": [
        "/Users/brozp/Code/Temp/aps-mcp-server-node/build/server.js"
      ]
    }
  }
}

Para mais detalhes sobre como adicionar servidores MCP ao Cursor, consulte a documentação