garmonia-crm-mcp

MCP-Server zum Testen der CRM «Гармония отеля» über ihre interne API. Meldet sich per Passwort an (Session-Cookie), bietet Werkzeuge für Bestellungen, Kunden, Marken, Kalender und universellen Zugriff auf das gesamte übrige CRUD.

Schnellinstallation (ein Befehl, ohne Klonen)

Benötigt wird nur Node 18+. Installieren und Repository klonen ist nicht nötig — npx startet den Server direkt aus GitHub.

1. Erstelle eine lokale Datei mit den Zugangsdaten, z. B. ~/garmonia-crm.json:

{
  "baseUrl": "https://адрес-crm",
  "login": "твой-логин",
  "password": "твой-пароль"
}

2. Füge MCP mit einem Befehl hinzu (ersetze den Pfad zu deiner Datei):

claude mcp add garmonia-crm \
  -e CRM_CONFIG="$HOME/garmonia-crm.json" \
  -- npx -y github:AlekseiKastsiuk/garmonia-crm-mcp

3. Starte Claude Code neu.

Die Zugangsdaten liegen nur in deiner lokalen Datei und werden nirgendwohin gesendet — npx lädt von GitHub nur den Server-Code.

Related MCP server: MCP CRUD Tools

Installation aus den Quellen (Alternative)

git clone https://github.com/AlekseiKastsiuk/garmonia-crm-mcp
cd garmonia-crm-mcp
npm install
cp crm-config.example.json crm-config.json
# открой crm-config.json и впиши baseUrl, логин и пароль своей CRM

crm-config.json — das ist die CRM-Adresse und Login/Passwort, nicht in git committen (steht bereits in .gitignore).

Verbindung zu Claude Code

In ~/.claude.json (oder über claude mcp add) den Server hinzufügen:

{
  "mcpServers": {
    "garmonia-crm": {
      "command": "node",
      "args": ["/полный/путь/к/garmonia-crm-mcp/server.mjs"]
    }
  }
}

Wenn die Konfiguration nicht neben dem Server liegt — Pfad in env angeben:

"env": { "CRM_CONFIG": "/полный/путь/к/crm-config.json" }

Nach der Änderung — Claude Code neu starten.

Werkzeuge

Sicherheit

• Passwort und CRM-Adresse stehen in crm-config.json, das in .gitignore liegt — gelangt nicht ins Repository.

• In crm-config.example.json nur Platzhalter, ohne echte Daten.

• Vor dem ersten Push prüfen: git ls-files darf crm-config.json nicht enthalten, und git grep -i password — nur den Feldnamen im Code.

Hinweise

• Bestellungen werden über den öffentlichen Endpunkt POST /api/form-lead erstellt — keine Autorisierung nötig.

• Das Löschen einer Bestellung ist kein REST, sondern eine Next.js server action (derselbe Button „Löschen“ im Tab der geschlossenen). crm_order_delete ruft sie selbst auf. Die Aktions-ID ist an den Frontend-Build gebunden; wenn nach einem CRM-Deploy das Löschen nicht mehr funktioniert — aktualisiere bulkDeleteActionId in crm-config.json (im JS-Bundle nach bulkDelete suchen).

• Produkte/Kategorien liefern ihre Listen über Server-Rendering, nicht über die GET-API — zum Erstellen/Bearbeiten/Löschen nutze crm_request (POST/PATCH/DELETE).