Field Control MCP Server

Servidor MCP (Model Context Protocol) remoto que conecta Claude con la API de Integración de Field Control (https://developers.fieldcontrol.com.br/), permitiendo consultar y crear clientes, órdenes de servicio, colaboradores, solicitudes de servicio, equipos, etc. directamente en una conversación con Claude.

Lo que expone

Herramientas (tools) disponibles para Claude:

Related MCP server: Jobber MCP Connector

1. Obtén tu clave de API de Field Control

1. Accede al panel de Field Control como administrador.

2. Ve a Configuraciones > Configuración para desarrolladores (o directamente: https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores).

3. En "Clave de integración", haz clic para crear una nueva clave, dale un nombre y haz clic en Crear.

4. Guarda esa clave: la usarás como variable de entorno FIELD_CONTROL_API_KEY.

2. Ejecuta localmente (opcional, para probar)

npm install
FIELD_CONTROL_API_KEY="sua-chave-aqui" npm start

El servidor se levanta en http://localhost:3000, con el endpoint MCP en POST /mcp.

3. Pon el servidor en internet (necesario para que Claude acceda a él)

Claude se conecta desde la nube de Anthropic, por lo que el servidor debe ser accesible públicamente por HTTPS. Cualquier proveedor que ejecute Node.js funciona. Dos opciones simples y con capa gratuita:

Opción A: Render.com

1. Sube este proyecto a un repositorio en GitHub.

2. En Render, crea un Web Service apuntando al repositorio.

3. Build command: npm install — Start command: npm start.

4. En "Environment", agrega la variable FIELD_CONTROL_API_KEY con tu clave.

5. Después del deploy, tendrás una URL tipo https://seu-app.onrender.com. El endpoint MCP será https://seu-app.onrender.com/mcp.

Opción B: Railway.app

1. Sube el proyecto a GitHub.

2. En Railway, "New Project" > "Deploy from GitHub repo".

3. Agrega la variable de entorno FIELD_CONTROL_API_KEY.

4. Railway detecta npm start automáticamente y expone una URL pública.

(Cualquier otro host de Node.js — Fly.io, Vercel con functions, un VPS propio con Nginx, etc. — funciona de la misma manera, siempre que exponga /mcp vía HTTPS.)

4. Conecta a Claude como conector personalizado

1. En Claude, ve a Configuraciones > Conectores.

2. Haz clic en + y luego en Agregar conector personalizado.

3. Pega la URL de tu servidor terminando en /mcp (ej: https://seu-app.onrender.com/mcp).

4. Dale un nombre (ej: "Field Control") y haz clic en Agregar.

Listo: en las próximas conversaciones, Claude podrá listar tus órdenes de servicio, clientes, colaboradores, etc. siempre que eso ayude a responder lo que pidas.

En planes Team/Enterprise, un Propietario debe habilitar el conector primero en Configuraciones de la Organización > Conectores > Agregar > Personalizado > Web; luego cada miembro conecta su propia cuenta.

Seguridad

• La clave de API queda solo en el servidor (variable de entorno), nunca se expone a Claude ni al navegador.

• Por defecto, todos los que usen este servidor comparten la misma clave de API (la del entorno). Si quieres ofrecer este conector a varias personas con claves diferentes, adapta getApiKeyFromRequest() en src/server.js para leer la clave de un header por solicitud, y haz que cada persona configure eso en las "Configuraciones avanzadas" del conector.

• Nunca hagas commit de tu clave de API en el repositorio: usa siempre variables de entorno del proveedor de hospedaje.