Servidor MCP de FieldRoutes para Claude

Conecta Claude a tu cuenta de FieldRoutes para que puedas consultar clientes, verificar rutas, revisar citas, obtener el historial de servicio y más, directamente en la conversación.

Herramientas incluidas

Related MCP server: Jobber MCP Connector

Configuración

1. Copia este proyecto e instala las dependencias

npm install

2. Configura tus credenciales

cp .env.example .env

Abre .env y completa:

• FR_AUTH_KEY — desde FieldRoutes: Admin → API → Manage Keys

• FR_AUTH_TOKEN — misma ubicación

• FR_SUBDOMAIN — la parte antes de .pestroutes.com en tu URL (ej. crownpest)

3. Compila y ejecuta localmente para probar

npm run build
npm start

Deberías ver:

FieldRoutes MCP server running on port 3000
MCP endpoint: http://localhost:3000/mcp

Despliega en Railway (recomendado — nivel gratuito disponible)

1. Ve a railway.app y regístrate (gratis)

2. Haz clic en New Project → Deploy from GitHub repo

3. Conecta tu cuenta de GitHub y sube este código a un nuevo repositorio

4. Railway detectará Node.js y lo desplegará automáticamente

5. En Railway, ve a tu proyecto → Variables y añade:

   • FR_AUTH_KEY

   • FR_AUTH_TOKEN

   • FR_SUBDOMAIN

6. Railway te dará una URL pública como https://fieldroutes-mcp-production.up.railway.app

Despliega en Render (alternativa — también gratuita)

1. Ve a render.com y regístrate

2. Haz clic en New → Web Service

3. Conecta tu repositorio de GitHub

4. Establece Build Command: npm install && npm run build

5. Establece Start Command: npm start

6. En Environment, añade FR_AUTH_KEY, FR_AUTH_TOKEN, FR_SUBDOMAIN

7. Despliega — Render te da una URL como https://fieldroutes-mcp.onrender.com

Conéctate a Claude

1. En la aplicación de escritorio de Claude, ve a Settings → Connectors

2. Haz clic en Add custom connector

3. Ingresa tu URL desplegada + /mcp:

   https://your-app.up.railway.app/mcp

4. Guarda — Claude ahora puede usar las 10 herramientas de FieldRoutes

Verifica los endpoints con tu documentación de FieldRoutes

Las rutas de API en este servidor (customer/search, appointment/search, etc.) siguen el patrón estándar REST de FieldRoutes. Si alguna devuelve un 404, consulta la documentación de API específica de tu inquilino en:

https://YOUR_SUBDOMAIN.pestroutes.com/api/docs

o contacta al soporte de FieldRoutes para confirmar la ruta exacta según tu nivel de cuenta.

Notas de seguridad

• Tus credenciales de API se almacenan solo en variables de entorno — nunca se incluyen en el código

• El servidor no requiere su propia autenticación (Claude es el único que lo llama)

• Para mayor seguridad, puedes añadir una variable de entorno API_SECRET y validarla como token bearer en las solicitudes entrantes