Last.app MCP Remote Bridge

Servidor HTTP que expone el MCP de Last.app como endpoint remoto para Claude Desktop.

Permite conectar Claude Desktop al MCP de Last.app añadiéndolo como MCP personalizado por URL, sin necesidad de instalar el plugin .plugin ni tener Cowork.

Despliegue rápido

Opción A: En un servidor con Node.js

# 1. Copiar la carpeta lastapp-mcp-remote a tu servidor

# 2. Instalar dependencias
npm install

# 3. Arrancar
LASTAPP_API_KEY=393f8be1-5860-4b38-86ce-1993039cad3f node bridge.mjs

El servidor arrancará en http://tu-servidor:3000/mcp.

Para mantenerlo corriendo en segundo plano, usa pm2:

npm install -g pm2
LASTAPP_API_KEY=393f8be1-5860-4b38-86ce-1993039cad3f pm2 start bridge.mjs --name lastapp-mcp
pm2 save

Opción B: Con Docker

# Construir imagen
docker build -t lastapp-mcp-remote .

# Arrancar contenedor
docker run -d \
  --name lastapp-mcp \
  -p 3000:3000 \
  -e LASTAPP_API_KEY=393f8be1-5860-4b38-86ce-1993039cad3f \
  --restart unless-stopped \
  lastapp-mcp-remote

Opción C: En Render.com (hosting gratuito)

1. Subir esta carpeta a un repositorio Git (GitHub/GitLab)
2. Ir a render.com → New → Web Service
3. Conectar el repositorio
4. Configurar:
   • Build Command: npm install
   • Start Command: node bridge.mjs
   • Environment Variables: LASTAPP_API_KEY = 393f8be1-5860-4b38-86ce-1993039cad3f
5. Deploy

Render asigna una URL tipo https://lastapp-mcp-xxxx.onrender.com. El endpoint MCP será https://lastapp-mcp-xxxx.onrender.com/mcp.

Configurar en Claude Desktop

Una vez desplegado, añadir en Claude Desktop:

1. Ir a Settings → Extensions
2. Pulsar "Añadir" (o "Add custom MCP")
3. Pegar la URL del servidor: https://tu-servidor.com/mcp
4. Guardar

Abrir una conversación nueva y probar: "¿Cómo fueron las ventas de ayer?"

Variables de entorno

Variable	Requerida	Default	Descripción
LASTAPP_API_KEY	Sí	—	API key de Last.app
PORT	No	3000	Puerto HTTP
BRIDGE_SECRET	No	—	Secret compartido para auth
LASTAPP_API_URL	No	https://api.last.app/v2	URL de la API
LASTAPP_TIMEOUT	No	30000	Timeout en ms

Seguridad

En producción, se recomienda:

• Usar HTTPS (Render, Railway, etc. lo dan automáticamente)
• Configurar BRIDGE_SECRET para que solo clientes autorizados puedan conectarse
• No exponer el puerto directamente a internet sin un reverse proxy

Verificar que funciona

# Health check
curl https://tu-servidor.com/

# Debería devolver:
# {"name":"lastapp-mcp-remote","version":"0.1.0","status":"ok","activeSessions":0}