LocalTry MCP

Nutzen Sie LocalTry von ChatGPT und anderen MCP-Clients aus, während jedes Unternehmen strikt isoliert bleibt.

LocalTry MCP ist ein entfernter Model-Context-Protocol-Server zum Bedienen eines LocalTry-CRM mit Anweisungen in einfacher Sprache. Er läuft auf Cloudflare Workers, verwendet OAuth 2.1 und bindet jede Verbindung an einen verifizierten LocalTry-Benutzer, ein Unternehmen, eine Rolle und einen Berechtigungssatz.

Was es ermöglicht

• Suchen Sie nach Kunden, Firmen, Kontakten, Leads, Aufträgen, Kostenvoranschlägen und Rechnungen.

• Erstellen und aktualisieren Sie validierte CRM-Datensätze.

• Untersuchen Sie die vollständige Workspace-Architektur des Mandanten.

• Planen und wenden Sie nur für den Mandanten gültige Workspace-Anpassungen an.

• Führen Sie gespeicherte Workflows aus.

• Bitten Sie LocalTry Command, mehrstufige Geschäftsabläufe auszuführen.

• Überprüfen Sie Anpassungsversionen und stellen Sie eine frühere Version wieder her.

• Lesen Sie eine mandantenbezogene Aktivitäts- und Audit-Historie.

Related MCP server: MCP Client Portal

Verfügbare Tools

Die Mandantengrenze

Es gibt einen gemeinsamen MCP-Dienst, aber jede Autorisierung ist logisch privat. Der Client kann keine Mandantenkennung angeben oder ändern.

MCP client
  -> LocalTry OAuth consent
  -> token bound to user + business + role + scopes
  -> LocalTry MCP Worker
  -> private Cloudflare service binding
  -> LocalTry domain services
  -> business-scoped data and workspace runtime

Der MCP-Worker erhält keine Datenbankbindung. Er kann LocalTry nur über den privaten Servicevertrag in docs/localtry-bridge-contract.md erreichen.

Remote-Endpunkt

Der Produktionsendpunkt ist live:

https://mcp.localtry.com/mcp

Gesundheitscheck:

https://mcp.localtry.com/health

Clients entdecken OAuth-2.1-Metadaten automatisch. Die Autorisierung unterstützt PKCE, dynamische Client-Registrierung, kurzlebige Zugriffstokens und Refresh-Tokens. Benutzer melden sich bei LocalTry an und genehmigen einen sichtbaren Workspace; es wird kein LocalTry-API-Schlüssel in den MCP-Client kopiert.

Lokale Entwicklung

Voraussetzungen: Node.js 20 oder neuer und ein Cloudflare-Konto.

npm install
npm run types
npm run check
npm run dev

Erstellen Sie einen OAuth-KV-Namespace und ersetzen Sie die Platzhalter-Namespace-ID in wrangler.jsonc:

npx wrangler kv namespace create OAUTH_KV

Die Dienstbindung LOCALTRY_API muss auf den benannten LocalTryMcpBridge-WorkerEntrypoint zeigen, der von der LocalTry-CRM-Bereitstellung exportiert wird.

Siehe den Bridge-Vertrag für die genaue Vertrauensgrenze.

ChatGPT

ChatGPT unterstützt Remote-MCP-Apps über den Entwicklermodus. Siehe docs/chatgpt.md für den Verbindungsablauf und die aktuellen Plananforderungen. Das Erstellen einer privaten benutzerdefinierten App verbindet diesen Server mit einem ChatGPT-Konto oder -Workspace; die Veröffentlichung im öffentlichen ChatGPT-App-Verzeichnis ist ein separater OpenAI-Überprüfungsprozess.

Designprinzipien

• Kein Roh-SQL-Tool.

• Kein Tool-Argument für die Mandanten-ID.

• Kein Tool zum Lesen von Geheimnissen.

• Zielorientierte Tools statt einer Spiegelung der gesamten API.

• Ausdrückliche Genehmigung für folgenreiche Workspace-Änderungen.

• Versionierung, Audit-Ereignisse und Wiederherstellungsunterstützung.

• Berechtigungsprüfungen sowohl im MCP-Worker als auch in der CRM-Domänenschicht.

Status

Die Produktion ist unter mcp.localtry.com bereitgestellt. OAuth-Autorisierung, Refresh-Tokens, MCP-Initialisierung, Tool-Erkennung, Mandantenbindung und ein Live-Workspace-Lesezugriff wurden Ende-zu-Ende verifiziert. Der öffentliche Worker erreicht das CRM nur über eine private Cloudflare-Service-Bindung und hat keine Datenbankbindung.

Lizenz

MIT