Field Control MCP Server

Entfernter MCP-Server (Model Context Protocol), der Claude mit der Field Control Integrations-API (https://developers.fieldcontrol.com.br/) verbindet und es ermöglicht, Kunden, Arbeitsaufträge, Mitarbeiter, Serviceanfragen, Geräte usw. direkt in einem Gespräch mit Claude abzufragen und zu erstellen.

Was er bereitstellt

Für Claude verfügbare Tools:

Related MCP server: Jobber MCP Connector

1. Holen Sie sich Ihren Field Control API-Schlüssel

1. Melden Sie sich als Administrator im Field Control-Panel an.

2. Gehen Sie zu Einstellungen > Konfiguration für Entwickler (oder direkt: https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores).

3. Klicken Sie unter „Integrationsschlüssel" auf „Neuen Schlüssel erstellen", geben Sie einen Namen ein und klicken Sie auf Erstellen.

4. Bewahren Sie diesen Schlüssel auf – Sie verwenden ihn als Umgebungsvariable FIELD_CONTROL_API_KEY.

2. Lokal ausführen (optional, zum Testen)

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

Der Server läuft unter http://localhost:3000, mit dem MCP-Endpunkt unter POST /mcp.

3. Server ins Internet stellen (erforderlich, damit Claude darauf zugreifen kann)

Claude verbindet sich aus der Cloud von Anthropic, daher muss der Server öffentlich über HTTPS erreichbar sein. Jeder Anbieter, der Node.js ausführt, funktioniert. Zwei einfache Optionen mit kostenloser Stufe:

Option A: Render.com

1. Laden Sie dieses Projekt in ein GitHub-Repository hoch.

2. Erstellen Sie bei Render einen Web Service, der auf das Repository zeigt.

3. Build-Befehl: npm install – Start-Befehl: npm start.

4. Fügen Sie unter „Environment" die Variable FIELD_CONTROL_API_KEY mit Ihrem Schlüssel hinzu.

5. Nach dem Deployment erhalten Sie eine URL wie https://ihre-app.onrender.com. Der MCP-Endpunkt lautet https://ihre-app.onrender.com/mcp.

Option B: Railway.app

1. Laden Sie das Projekt auf GitHub hoch.

2. Bei Railway: „New Project" > „Deploy from GitHub repo".

3. Fügen Sie die Umgebungsvariable FIELD_CONTROL_API_KEY hinzu.

4. Railway erkennt npm start automatisch und stellt eine öffentliche URL bereit.

(Jeder andere Node.js-Host – Fly.io, Vercel mit Functions, ein eigener VPS mit Nginx usw. – funktioniert genauso, solange /mcp über HTTPS bereitgestellt wird.)

4. Als benutzerdefinierten Connector mit Claude verbinden

1. Gehen Sie in Claude zu Einstellungen > Connectors.

2. Klicken Sie auf + und dann auf Benutzerdefinierten Connector hinzufügen.

3. Fügen Sie die URL Ihres Servers ein, die auf /mcp endet (z. B. https://ihre-app.onrender.com/mcp).

4. Geben Sie einen Namen ein (z. B. „Field Control") und klicken Sie auf Hinzufügen.

Fertig – in zukünftigen Gesprächen kann Claude Ihre Arbeitsaufträge, Kunden, Mitarbeiter usw. auflisten, wann immer dies hilft, Ihre Anfrage zu beantworten.

In Team-/Enterprise-Plänen muss ein Eigentümer den Connector zuerst unter Organisationseinstellungen > Connectors > Hinzufügen > Benutzerdefiniert > Web aktivieren; danach verbindet jedes Mitglied sein eigenes Konto.

Sicherheit

• Der API-Schlüssel liegt nur auf dem Server (Umgebungsvariable) und wird niemals an Claude oder den Browser weitergegeben.

• Standardmäßig teilen sich alle, die diesen Server verwenden, denselben API-Schlüssel (den der Umgebung). Wenn Sie diesen Connector mehreren Personen mit unterschiedlichen Schlüsseln anbieten möchten, passen Sie getApiKeyFromRequest() in src/server.js an, um den Schlüssel aus einem Header pro Anfrage zu lesen, und lassen Sie jede Person dies in den „Erweiterten Einstellungen" des Connectors konfigurieren.

• Committen Sie Ihren API-Schlüssel niemals in das Repository – verwenden Sie immer Umgebungsvariablen des Hosting-Anbieters.