APS MCP Server

IMPORTANTE: Este proyecto se ha trasladado a https://github.com/autodesk-platform-services/aps-mcp-server-nodejs.

---

aps-mcp-server

Servidor experimental de Model Context Protocol construido con Node.js, que proporciona acceso a la API de Autodesk Platform Services, con control de acceso granular mediante la nueva función de Secure Service Accounts.

Video de YouTube

Desarrollo

Requisitos previos

• Node.js
• Credenciales de la aplicación APS (debe ser un tipo de aplicación Server-to-Server)
• Acceso aprovisionado a ACC o BIM360

Configuración

Servidor

• Clona este repositorio
• Instala las dependencias: yarn install
• Compila el código TypeScript: yarn run build
• Crea un archivo .env en la carpeta raíz de este proyecto y agrega tus credenciales de APS:
  • APS_CLIENT_ID - tu ID de cliente de la aplicación APS
  • APS_CLIENT_SECRET - tu secreto de cliente de la aplicación APS
• Crea una nueva cuenta de servicio: npx create-service-account <username> <first name> <last name>, por ejemplo, npx create-service-account ssa-test-user John Doe
  • Este script generará un conjunto de variables de entorno con información sobre la nueva cuenta:
    • APS_SA_ID - tu ID de cuenta de servicio
    • APS_SA_EMAIL - tu correo electrónico de cuenta de servicio
    • APS_SA_KEY_ID - tu ID de clave de cuenta de servicio
    • APS_SA_PRIVATE_KEY - tu clave privada de cuenta de servicio
• Agrega estas variables de entorno a tu archivo .env

Autodesk Construction Cloud

• Registra tu ID de cliente de la aplicación APS como una integración personalizada
• Invita el correo electrónico de la cuenta de servicio como nuevo miembro a tus proyectos de ACC

Uso con Inspector

• Ejecuta el Model Context Protocol Inspector: yarn run inspect
• Abre http://localhost:5173
• Pulsa Connect para iniciar este servidor MCP y conectarte a él

Uso con Claude Desktop

• Asegúrate de tener Claude Desktop instalado
• Crea un archivo de configuración de Claude Desktop si aún no tienes uno:
  • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • En Windows: %APPDATA%\Claude\claude_desktop_config.json
• Agrega este servidor MCP a la configuración, usando la ruta absoluta del archivo build/server.js en tu sistema, por ejemplo:

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

• Abre Claude Desktop y prueba algunos de los siguientes prompts de prueba:
  • ¿A qué proyectos de ACC tengo acceso?
  • Dame un panel visual de todos los problemas en el proyecto XYZ

Para más detalles sobre cómo agregar servidores MCP a Claude Desktop, consulta la documentación oficial.

Uso con Visual Studio Code y Copilot

• Asegúrate de haber habilitado los servidores MCP en Visual Studio Code
• Crea el archivo .vscode/mcp.json en tu espacio de trabajo y agrega el siguiente JSON:

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

Para más detalles sobre cómo agregar servidores MCP a Visual Studio Code, consulta la documentación

Uso con Cursor

• Crea el archivo .cursor/mcp.json en tu espacio de trabajo y agrega el siguiente JSON:

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

Para más detalles sobre cómo agregar servidores MCP a Cursor, consulta la documentación