@next-coaching/mcp

Lokaler MCP-Server für Next Coaching. Gibt dir in Claude Desktop (oder jedem anderen MCP-Client) Werkzeuge, um deinen Coaching-Workspace zu steuern — Klienten anlegen, Programme/Kurse/Workouts zuweisen und deine Klientenliste lesen.

Der Server läuft auf deinem Rechner und hält kein Datenbank-Geheimnis. Er spricht ausschließlich mit der Next-Coaching-App über einen persönlichen Zugriffstoken (PAT), den du in den Einstellungen erzeugst und jederzeit widerrufen kannst.

Verfügbare Tools

| Tool | Zweck | |---|---| | create_client | Neuen Klienten einladen + komplettes Onboarding (Profil, Tags, Notiz, Begrüßung, Custom Fields, Programme/Kurse/Formulare, erster Termin). Nur E-Mail ist Pflicht. | | assign | Programm, Kurs oder Workout einem Klienten zuweisen. | | list_clients | Alle Klienten mit Profil, Body-Metrics, Zielen, Tags, Custom Fields und aktiven Zuweisungs-Counts. | | get_client | Ein Klient mit voller Tiefe (inkl. coach-privater Notizen + Progress). | | list_programs | Aktive Programme als id+name+kind (zum Auflösen einer programId). | | list_courses | Kurse als id+name+status (optional nach Status filtern). | | list_workouts | Aktive Workouts als id+name (zum Auflösen einer workoutId). |

Einrichtung

1. Token erzeugen

Öffne in der Next-Coaching-App Einstellungen → Claude-Integration (MCP) und klicke auf Neuen Token erzeugen. Der Token wird nur einmal angezeigt — kopiere ihn sofort. (Verloren? Einfach einen neuen erzeugen und den alten widerrufen.)

2. Claude Desktop konfigurieren

Öffne die Claude-Desktop-Konfiguration:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Füge den next-coaching-Eintrag hinzu (oder ergänze ihn unter einem bestehenden mcpServers-Block):

{
  "mcpServers": {
    "next-coaching": {
      "command": "npx",
      "args": ["-y", "@next-coaching/mcp"],
      "env": {
        "NEXT_COACHING_TOKEN": "<HIER-DEN-TOKEN-AUS-DEN-EINSTELLUNGEN-EINFÜGEN>",
        "NEXT_COACHING_API_BASE": "https://next-coaching-web.vercel.app"
      }
    }
  }
}

NEXT_COACHING_API_BASE ist optional — ohne den Eintrag wird die Produktions-URL verwendet. Setze ihn nur, wenn du gegen eine andere Umgebung arbeitest.

3. Claude Desktop neu starten

Beende Claude Desktop vollständig und starte es neu. Die sieben Werkzeuge oben erscheinen anschließend im Tool-Menü.

Umgebungsvariablen

| Variable | Pflicht | Default | Zweck | |---|---|---|---| | NEXT_COACHING_TOKEN | ja | — | Dein persönlicher Zugriffstoken aus den App-Einstellungen. | | NEXT_COACHING_API_BASE | nein | https://next-coaching-web.vercel.app | Basis-URL der Next-Coaching-App. |

Sicherheit

• Der Token ist auf genau einen Workspace und deine Coach-Identität begrenzt. Er kann keine fremden Workspaces sehen.
• Der Token liegt in der App nur als unumkehrbarer Hash. Ein Datenbank-Leak gibt keine nutzbaren Tokens preis.
• Widerrufen wirkt sofort: über Einstellungen → Claude-Integration den Token entfernen — der MCP-Server verliert augenblicklich den Zugriff.
• Dieser Server enthält keine Datenbank-Zugangsdaten. Er ruft nur die App-API mit deinem Token.

Für Entwickler

pnpm install
pnpm build        # tsc -> dist/

Das ausführbare Skript ist dist/index.js (registriert als Bin next-coaching-mcp). Der Server kommuniziert über stdio; stdout ist dem MCP-Protokoll vorbehalten, Diagnose läuft über stderr.