@lcapps/mcp-crm

Verbinde dein CRM von LCApps mit Claude und anderen KI-Assistenten.

Welche der beiden Möglichkeiten du brauchst

Es gibt zwei Verbindungsmöglichkeiten, und die meisten Leute wollen die erste.

Beginne mit dem Connector. Wenn du später doch brauchst, dass Rechnungen und Angebote als Datei gespeichert werden, komm hierher zurück.

Related MCP server: capsulemcp

Verbinden ohne etwas zu installieren

Du brauchst die Adresse deines CRM. Es ist die übliche, nur den Anfang durch mcp ersetzt:

Die Schritte:

1. Öffne Claude und gehe zu seinen Einstellungen.

2. Suche den Bereich Connectors und wähle, einen benutzerdefinierten hinzuzufügen.

3. Füge die Adresse aus der Tabelle ein und speichere.

4. Claude öffnet dein CRM im Browser, damit du dich anmeldest und autorisierst. Es ist deine gewohnte Sitzung mit deinem Benutzer.

5. Überprüfe, was verlangt wird, und akzeptiere.

Fertig. Frage nach deinen Kunden, deinen Rechnungen oder deinen Ausgaben.

Wenn etwas nicht funktioniert

Du siehst nur das, was dein Benutzer im CRM sehen kann. Die Verbindung gibt keine neuen Berechtigungen.

Dokumente auf deinem Rechner speichern

Dafür ist dieses Paket nötig. Ein normaler Connector kann nicht auf deine Festplatte schreiben, also kommt ein PDF innerhalb der Antwort an und bleibt dort.

Dieses Programm läuft auf deinem Rechner, leitet die Unterhaltung an den Server weiter und speichert die eingehenden Dateien, wobei Claude den Pfad erhält, wo sie gelandet sind.

Du brauchst Node.js installiert. Danach in der Konfiguration deines Clients:

{
  "mcpServers": {
    "lcrm-int": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-int.lcrm.es/mcp" }
    },
    "lcrm-test": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-test.lcrm.es/mcp" }
    },
    "lcrm": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp.lcrm.es/mcp" }
    }
  }
}

Alle drei Einträge können gleichzeitig aktiv sein. Die Anmeldedaten werden pro Server gespeichert, sodass die Autorisierung für einen Server die Sitzung der anderen nicht beendet.

Wo die Konfigurationsdatei liegt:

• Claude Desktop unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop unter Windows: %APPDATA%\Claude\claude_desktop_config.json

• Cursor: in seinen MCP-Einstellungen

--url https://…/mcp dient als Alternative zur Umgebungsvariable.

Autorisierung

Beim ersten Mal öffnet sich der Browser, damit du den Zugriff autorisierst. Das Paket registriert sich als OAuth-Client, wartet auf die Antwort unter http://localhost:33420/callback und speichert die Anmeldedaten in ~/.lcrm/credentials/<server>.json mit Berechtigungen 0600. Danach wird das Refresh-Token wiederverwendet, sodass der Browser nur einmal pro Server erscheint.

Du kannst es auch manuell starten:

LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm login
LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm logout

Wo die Dateien landen

Die vom CRM zurückgegebenen Dokumente werden in ~/Downloads/lcrm-mcp/ gespeichert, und der Assistent erhält den Pfad. Der Name stammt vom CRM selbst – budget_26_010.pdf und ähnliches – reduziert auf ein einziges sicheres Segment: Der Server entscheidet nicht, wo geschrieben wird. Eine vorhandene Datei wird niemals überschrieben; es wird ein Suffix -1, -2 angehängt.

Umgebungsvariablen

Das Ändern des Ports ändert die Rückrufadresse, sodass eine erneute Autorisierung erforderlich ist.

Entwicklung

npm install
npm run typecheck
npm test
npm run build

Lizenz

MIT – siehe LICENSE.