FieldRoutes MCP Server für Claude

Verbinde Claude mit deinem FieldRoutes-Konto, sodass Kunden, Routen, Termine, Service‑Historie und mehr direkt im Gespräch nachgeschlagen werden können – ganz ohne umständliche Navigation.

Enthaltene Werkzeuge

Related MCP server: ServiceTitan MCP Server

Einrichtung

1. Dieses Projekt kopieren und Abhängigkeiten installieren

npm install

2. Anmeldedaten konfigurieren

cp .env.example .env

Öffne .env und trage Folgendes ein:

• FR_AUTH_KEY – aus FieldRoutes: Admin → API → Manage Keys

• FR_AUTH_TOKEN – gleicher Ort

• FR_SUBDOMAIN – der Teil vor .pestroutes.com in deiner URL (z. B. crownpest)

3. Lokal bauen und testen

npm run build
npm start

Du solltest Folgendes sehen:

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

Auf Railway bereitstellen (empfohlen – kostenlose Stufe verfügbar)

1. Gehe zu railway.app und registriere dich (kostenlos)

2. Klicke auf New Project → Deploy from GitHub repo

3. Verbinde dein GitHub‑Konto und pushe diesen Code in ein neues Repository

4. Railway erkennt Node.js und stellt automatisch bereit

5. Gehe in Railway zu deinem Projekt → Variables und füge folgende Variablen hinzu:

   • FR_AUTH_KEY

   • FR_AUTH_TOKEN

   • FR_SUBDOMAIN

6. Railway gibt dir eine öffentliche URL wie https://fieldroutes-mcp-production.up.railway.app

Auf Render bereitstellen (Alternative – ebenfalls kostenlos)

1. Gehe zu render.com und registriere dich

2. Klicke auf New → Web Service

3. Verbinde dein GitHub‑Repository

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

5. Setze Start Command: npm start

6. Füge unter Environment die Variablen FR_AUTH_KEY, FR_AUTH_TOKEN, FR_SUBDOMAIN hinzu

7. Bereitstellen – Render gibt dir eine URL wie https://fieldroutes-mcp.onrender.com

Mit Claude verbinden

1. Öffne in der Claude‑Desktop‑App Einstellungen → Connectors

2. Klicke auf Add custom connector

3. Gib deine bereitgestellte URL + /mcp ein:

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

4. Speichern – Claude kann jetzt alle 10 FieldRoutes‑Werkzeuge nutzen

Endpunkte mit deiner FieldRoutes‑Dokumentation abgleichen

Die API‑Pfade in diesem Server (customer/search, appointment/search usw.) folgen dem üblichen FieldRoutes‑REST‑Schema. Falls einer einen 404 zurückgibt, prüfe deine mandantenspezifische API‑Dokumentation unter:

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

oder wende dich an den FieldRoutes‑Support, um den genauen Pfad für deine Account‑Stufe zu bestätigen.

Sicherheitshinweise

• Deine API‑Zugangsdaten werden ausschließlich in Umgebungsvariablen gespeichert – niemals im Code

• Der Server benötigt keine eigene Authentifizierung (Claude ist der einzige Aufrufer)

• Für zusätzliche Sicherheit kannst du eine API_SECRET‑Umgebungsvariable anlegen und bei eingehenden Anfragen als Bearer‑Token prüfen