FITsociety Help DE

FITsociety MCP und API: Grundlagen, Einrichtung und Verwendung

13 Min. Lesezeit

Mit FITsociety MCP und API verbindest du dein FITsociety-Konto mit einem KI-Assistenten wie Claude. Anschließend erledigst du deine Coach-Aufgaben in normaler Sprache: Du gibst ein, was du brauchst, und der Assistent erledigt es für dich in FITsociety.

In diesem Artikel erfährst du:

  • was eine API und ein MCP eigentlich sind

  • was du damit tun kannst

  • wie du die Verbindung einrichtest

  • wie du Schritt für Schritt einen Trainingsplan und einen Ernährungsplan erstellst

  • was (noch) nicht möglich ist, sowie Antworten auf häufige Fragen

Dieser Artikel richtet sich an Coaches und Studiobetreiber, die mit FITsociety arbeiten. Technische Kenntnisse brauchst du nicht.

Was ist eine API und was ist ein MCP?

Kurz gesagt: Die API ist die Tür zu FITsociety, und der MCP ist die Anleitung, mit der ein KI-Assistent durch diese Tür gelangt.

API

API steht für Application Programming Interface. Das ist eine festgelegte Art, wie zwei Programme miteinander kommunizieren. Vergleichbar mit dem Service in einem Restaurant: Du gehst nicht selbst in die Küche, sondern gibst deine Bestellung beim Kellner auf. Der Kellner weiß genau, was die Küche zubereiten kann, und bringt es dir.

Die FITsociety-API funktioniert genauso. Andere Software kann über die API Daten aus FITsociety abfragen oder etwas ändern, zum Beispiel einen Kunden suchen oder einen Trainingsplan hinzufügen. Das geschieht immer nach festen Regeln und nur mit den Berechtigungen, die du erteilst.

MCP

MCP steht für Model Context Protocol. Das ist ein offener Standard, mit dem KI-Assistenten wie Claude sicher mit anderer Software arbeiten können. Ein MCP sagt dem Assistenten, welche Aktionen in FITsociety möglich sind, etwa „Kunden suchen“, „Ernährungsplan erstellen“ oder „Nachricht senden“, und wie er sie verwendet.

Ohne MCP kann ein KI-Assistent nur reden und beraten. Mit dem MCP kann er auch wirklich Dinge für dich in deinem eigenen FITsociety-Konto erledigen.

Hoe werkt dat samen?

  1. Du gibst deinem KI-Assistenten eine Frage oder Anweisung in normaler Sprache.

  2. Der Assistent überlegt, welche Aktionen in FITsociety dafür nötig sind.

  3. Über den MCP führt er diese Aktionen in deinem Konto aus, innerhalb der Berechtigungen, die du erteilt hast.

  4. Der Assistent zeigt, was er gefunden oder getan hat. Du prüfst es und steuerst bei Bedarf nach.

Was kannst du damit tun?

Über den MCP kann dein KI-Assistent den Großteil deiner täglichen Coach-Aufgaben in FITsociety für dich erledigen. Welche Bereiche du nutzen kannst, hängt von den Modulen in deinem Konto ab.

Bereich

Was der Assistent kann

Beispielfrage

Kunden

Kunden suchen und anlegen, Profile, Ziele, Messungen, Erstanamnesen und Check-ins ansehen, Notizen führen

„Was sind Sannes Ziele und wie haben sich ihre Messwerte verändert?“

Training

Übungen, Trainingspläne und WODs erstellen, ändern, duplizieren und Kunden zuweisen; Trainingseinheiten und Leistungen einsehen

„Erstelle einen Ganzkörperplan für Anfänger mit 3 Tagen pro Woche.“

Ernährung

Ernährungspläne, Rezepte und Nahrungsergänzungsmittel erstellen und ändern, Ernährungsziele festlegen, die Aufnahme von Kunden ansehen, Produkte suchen

„Wie viel Eiweiß hat Mark diese Woche durchschnittlich gegessen?“

Gewohnheiten

Gewohnheitsvorlagen erstellen, Kunden zuordnen und den Fortschritt verfolgen

„Weise Sanne die Gewohnheit ‚täglich 8.000 Schritte‘ zu.“

Kalender und Buchungen

Kurse, Termine und Aufgaben ansehen und planen, Buchungen erstellen und Anwesenheit aktualisieren

„Wer hat sich für das Bootcamp am Donnerstag angemeldet?“

Nachrichten

Gespräche mit Kunden lesen und Nachrichten versenden

„Schick Mark eine Nachricht, dass sein neuer Plan bereitsteht.“

Übersichten

Zusammenfassungen dazu, wie gut sich Kunden an ihren Plan halten, sowie zu Buchungen, Abonnements, Rechnungen und Credits

„Welche Kunden haben diesen Monat weniger als die Hälfte ihrer Trainings absolviert?“

Du kannst mehrere Schritte auch in einem Auftrag kombinieren. Zum Beispiel: „Suche Sanne, erstelle anhand ihrer Erstanamnese einen Trainingsplan, weise ihn ihr zu und schick ihr eine Nachricht, dass er bereitsteht.“

Sicherheit: Du behältst die Kontrolle

Die Verbindung kann nie mehr, als du selbst in FITsociety darfst, und du bestimmst selbst, wie viel sie darf.

  • Nur dein eigenes Konto. Der Assistent arbeitet nur in deinem Konto und dem Unternehmen, das mit der Verbindung verknüpft ist. Daten anderer Unternehmen sind niemals sichtbar.

  • Nur deine eigenen Module. Hast du ein Modul nicht, zum Beispiel Ernährung, kann auch der Assistent damit nichts tun.

  • Zustimmung deiner Kunden. Kundendaten sind nur im Rahmen der Zustimmung verfügbar, die sie erteilt haben. Fehlt diese, kann der Assistent diese Daten nicht einsehen.

  • Lesen und Ändern sind getrennt. Du wählst, ob eine Verbindung nur mitlesen oder auch etwas erstellen und ändern darf. Änderungen sind nur mit den Berechtigungen möglich, die du dafür erteilst.

  • Du bleibst der Coach. Ein KI-Assistent kann Fehler machen. Prüfe immer, was er vorschlägt oder erstellt hat, bevor du es mit einem Kunden teilst. Das gilt besonders für Ernährung und Training bei Verletzungen, Schwangerschaft oder medizinischen Beschwerden.

Tipp: Beginne mit reinen Leserechten. So kannst du in Ruhe entdecken, was der Assistent kann, ohne dass sich etwas ändert. Aktiviere danach Schreibrechte, sobald du mit der Funktionsweise vertraut bist.

Die Verbindung einrichten

Du verbindest FITsociety in wenigen Minuten mit deinem KI-Assistenten. Du brauchst einen Assistenten, der MCP-Verbindungen unterstützt, zum Beispiel Claude.

Verfügbarkeit: Ist der MCP in deinem Konto noch nicht aktiviert? Frag über den Chat danach. Du wirst dann an das Team weitergeleitet, das den MCP in deinem Konto für dich aktiviert.

Stap 1: Open de MCP-pagina in FITsociety

Gehe in FITsociety zu Einstellungen → KI-Verbindungen (MCP). Dort findest du die MCP-Seite. Unter Connector-URL findest du den Endpunkt (die Webadresse der Verbindung), den du kopieren kannst. Siehst du die Seite nicht? Dann ist der MCP in deinem Konto noch nicht aktiviert. Frag über den Chat danach, dann helfen wir dir weiter.

Stap 2: Maak een sleutel aan en kies de rechten

Erstelle auf derselben Seite einen neuen Schlüssel (Token). Wähle dabei, was die Verbindung darf:

  • Nur lesen: Der Assistent kann Daten ansehen und zusammenfassen, aber nichts ändern.

  • Lesen und schreiben: Der Assistent kann auch Pläne, Notizen, Nachrichten und Termine erstellen und ändern.

Kopiere den Schlüssel und bewahre ihn sicher auf. Teile ihn mit niemandem: Wer den Schlüssel hat, kann mit den gewählten Rechten auf dein Konto zugreifen.

Stap 3: Voeg de koppeling toe aan je AI-assistent

Füge in deinem KI-Assistenten eine neue MCP-Verbindung hinzu:

  1. Gib der Verbindung einen erkennbaren Namen, zum Beispiel FITsociety.

  2. Füge den Endpunkt aus Schritt 1 als Adresse ein. Wähle als Verbindungstyp Streamable HTTP, wenn dein Assistent danach fragt.

  3. Füge deinen Schlüssel an der Stelle hinzu, an der dein KI-Assistent danach fragt.

  4. Speichere und lass den Assistenten die verfügbaren Aktionen abrufen.

Stap 4: Test de koppeling

Stelle eine einfache Frage, zum Beispiel: „Welche Kunden habe ich in FITsociety?“ oder „Was steht heute in meinem Kalender?“ Bekommst du eine Antwort mit deinen eigenen Daten, funktioniert die Verbindung.

Funktioniert es nicht? Prüfe, ob du den Schlüssel vollständig kopiert hast, ob die Verbindung in deinem Assistenten aktiviert ist und ob der MCP in deinem Konto bereits aktiviert wurde.

Sleutel intrekken

Möchtest du den Zugriff beenden, zum Beispiel weil dein Schlüssel offengelegt wurde oder du einen anderen Assistenten verwenden wirst? Dann widerrufe den Schlüssel auf der MCP-Seite in FITsociety. Die Verbindung funktioniert danach sofort nicht mehr.

Beispiel: Einen Trainingsplan erstellen

In diesem Beispiel erstellst du einen Kraftplan für eine neue Kundin, Sanne, und weist ihn ihr zu. Dafür brauchst du eine Verbindung mit Schreibrechten.

Stap 1: Laat de assistent je klant leren kennen

Beginne mit einer Frage, damit der Assistent die richtigen Informationen hat:

Suche Sanne de Vries in FITsociety. Fasse ihre Erstanamnese, Ziele und mögliche Verletzungen zusammen.

Der Assistent sucht Sanne und stellt ihre Erstanamnese und Ziele für dich zusammen. Stimmt etwas nicht oder fehlt etwas? Ergänze es in deiner nächsten Nachricht.

Stap 2: Vraag om een voorstel

Beschreibe so konkret wie möglich, was du möchtest:

Erstelle einen Vorschlag für einen Trainingsplan für Sanne: 3 Tage pro Woche, Schwerpunkt Kraft, ungefähr 60 Minuten pro Training. Sanne trainiert im Studio mit freien Gewichten und Geräten. Berücksichtige ihre Kniebeschwerden. Verwende Übungen aus meiner Übungsbibliothek. Erstelle noch nichts, zeig mir zuerst den Vorschlag.

Der Assistent zeigt pro Trainingstag, welche Übungen er vorschlägt, mit Sätzen, Wiederholungen und Pausen.

Stap 3: Stuur bij

Passe den Vorschlag in normaler Sprache an, so oft du möchtest:

Ersetze die Ausfallschritte durch Step-ups und füge an Tag 2 eine Rumpfübung hinzu. Setze die Pause bei den Mehrgelenksübungen auf 2 Minuten.

Stap 4: Laat het schema aanmaken en toewijzen

Zufrieden? Dann gib den Auftrag, ihn wirklich in FITsociety anzulegen:

Sieht gut aus. Erstelle diesen Plan in FITsociety und weise ihn Sanne ab Montag zu.

Der Assistent erstellt den Plan, füllt die Trainingstage mit den Übungen und weist ihn Sanne zu. Er meldet sich, wenn er fertig ist.

Stap 5: Controleer en laat het weten

Öffne den Plan in FITsociety und prüfe ihn noch einmal. Danach kannst du den Assistenten auch die Nachricht versenden lassen:

Schick Sanne eine Nachricht, dass ihr neuer Plan in der App bereitsteht und sie jederzeit Fragen stellen darf.

Tipp: Verwendest du häufiger denselben Plantyp? Lass den Assistenten ihn als Vorlage speichern. Danach sagst du zum Beispiel: „Dupliziere meine Vorlage ‚Kraft Anfänger 3x‘ für Mark und passe sie für jemanden ohne Kniebeschwerden an.“

Beispiel: Einen Ernährungsplan erstellen

In diesem Beispiel erstellst du einen Ernährungsplan für Mark, der abnehmen und Muskeln erhalten möchte. Dafür brauchst du das Ernährungsmodul und eine Verbindung mit Schreibrechten.

Stap 1: Breng de uitgangssituatie in kaart

Suche Mark Jansen. Was sind seine Ziele, sein aktuelles Gewicht und seine Ernährungsziele? Und was hat er in der letzten Woche durchschnittlich gegessen?

Der Assistent ruft Marks Ziele, Messungen und eingestellte Ernährungsziele ab und fasst seine protokollierte Aufnahme zusammen. So siehst du sofort, wo das größte Verbesserungspotenzial liegt.

Stap 2: Stel de voedingsdoelen in

Lege die Ziele selbst fest oder lass den Assistenten einen Vorschlag machen, den du prüfst:

Stelle für Mark folgende Tagesziele ein: 2.200 kcal, 170 Gramm Eiweiß, 220 Gramm Kohlenhydrate und 70 Gramm Fett.

Stap 3: Vraag om een voorstel voor het plan

Erstelle einen Vorschlag für einen Ernährungsplan für Mark, der zu diesen Zielen passt: Frühstück, Mittagessen, Abendessen und zwei Zwischenmahlzeiten. Er isst keinen Fisch und hat wenig Zeit zum Kochen, also halte es einfach. Verwende nach Möglichkeit Rezepte aus meiner Rezeptbibliothek. Erstelle noch nichts.

Der Assistent zeigt pro Mahlzeit, was er vorschlägt, mit den Mengen sowie den Gesamtkalorien und Makronährstoffen pro Tag.

Stap 4: Stuur bij

Ersetze den Quark beim Frühstück durch Haferflocken mit Whey und mach das Mittagessen an Werktagen zu etwas, das er mitnehmen kann. Passt das Eiweiß dann noch?

Der Assistent passt den Plan an und rechnet erneut nach, ob er innerhalb der Ziele liegt.

Stap 5: Laat het plan aanmaken en controleer het

Prima. Erstelle diesen Ernährungsplan für Mark in FITsociety und prüfe, ob er zu seinen Zielen passt.

Der Assistent erstellt den Plan und prüft ihn anhand der eingestellten Ziele. Weicht ein Tag zu stark ab, meldet er das. Öffne den Plan danach selbst in FITsociety, um ihn zu prüfen.

Stap 6: Volg de voortgang

Nach ungefähr zwei Wochen kannst du schnell prüfen, wie es läuft:

Wie gut hält sich Mark in den letzten zwei Wochen an seinen Ernährungsplan? An welchen Tagen weicht er am stärksten ab?

Tipp: Erstellst du ein neues Rezept für einen Kunden, lass es den Assistenten auch in deiner Rezeptbibliothek speichern. So kannst du es später für andere Kunden wiederverwenden.

Weitere Beispielfragen und Tipps

Voorbeeldvragen

Kunden und Fortschritt

  • „Welche Kunden haben ihren Check-in für diese Woche noch nicht ausgefüllt?“

  • „Fasse Sannes letzte drei Check-ins zusammen und hinterlege eine Notiz in ihrer Akte.“

  • „Wie hat sich Marks Gewicht in den letzten drei Monaten verändert?“

Training und WODs

  • „Erstelle ein WOD für Samstag: ein AMRAP von 20 Minuten mit Kettlebells und Rudern, und veröffentliche es.“

  • „Welche Trainings hat Sanne diesen Monat abgeschlossen und was waren ihre schwersten Kniebeugen?“

Kalender und Buchungen

  • „Plane nächsten Dienstag um 18:00 ein Erstgespräch mit Lisa.“

  • „Wie viele Personen waren diesen Monat durchschnittlich in meinen Gruppenkursen?“

Verwaltung

  • „Gib mir eine Übersicht der offenen Rechnungen.“

  • „Welche Abonnements laufen im kommenden Monat aus?“

  • „Wie viele Credits hat Mark noch?“

Tips voor goede opdrachten

  1. Sei konkret. Nenne den Kunden beim vollständigen Namen und gib Anzahlen, Tage, Uhrzeiten und Ziele mit an.

  2. Gib Kontext. Erzähle von Verletzungen, Vorlieben, verfügbarem Equipment und davon, wie viel Zeit dein Kunde hat.

  3. Bitte zuerst um einen Vorschlag. Sag „Erstelle noch nichts“, wenn du zuerst sehen möchtest, was der Assistent vorhat.

  4. Steuere in normaler Sprache nach. Du musst nicht neu beginnen; sag einfach, was anders sein soll.

  5. Prüfe das Ergebnis. Kontrolliere in FITsociety, ob alles stimmt, bevor du es mit deinem Kunden teilst.

  6. Arbeite bei großen Aufgaben schrittweise. Bearbeite erst einen Kunden richtig, bevor du den Assistenten bittest, dasselbe für zehn Kunden zu tun.

Was (noch) nicht möglich ist

  • Rechnungen und Zahlungen erstellen. Rechnungen und Abonnements kannst du ansehen und zusammenfassen lassen. Credits kannst du ansehen und mit Schreibrechten auch ändern. Rechnungen erstellen oder Zahlungen verarbeiten machst du wie gewohnt direkt in FITsociety.

  • Abonnements und Bankdaten aus einem anderen System importieren. Mitglieder kannst du mit Schreibrechten durchaus aus einer CSV- oder Excel-Datei importieren lassen. Abonnements, Bankdaten und andere Finanzdaten importierst du nicht über den MCP. Wechselst du von einem anderen System? Kontaktiere uns, dann helfen wir dir beim Umstieg.

  • Medizinische Beratung. Der Assistent ist ein Hilfsmittel für deine Arbeit als Coach, kein Arzt oder Ernährungsberater. Bei medizinischen Beschwerden bleiben dein eigenes Urteil und das eines Spezialisten maßgeblich.

  • Außerhalb deiner Module oder Berechtigungen arbeiten. Was dein Konto oder dein Schlüssel nicht erlaubt, kann auch der Assistent nicht.

Mis je iets? Zet het op de wensenlijst

Kann der Assistent etwas noch nicht? Frag ihn einfach. Wenn es wirklich um eine fehlende Funktion geht, bietet er an, deine Idee auf unsere Wunschliste zu setzen. Andere Coaches können dafür abstimmen, damit wir sehen, was am häufigsten gewünscht wird. Ein Wunsch auf der Liste ist keine Garantie, dass wir ihn umsetzen, und auch keine Zusage, wann. Auf der Wunschliste stehen niemals Kundendaten oder persönliche Informationen.

Häufig gestellte Fragen

Welchen KI-Assistenten brauche ich?
Einen Assistenten, der MCP-Verbindungen unterstützt, zum Beispiel Claude. Bei manchen Assistenten brauchst du dafür ein kostenpflichtiges Abonnement.

Kostet der MCP extra?
Kontaktiere uns, dann sagen wir dir, welche Möglichkeiten es innerhalb deines Pakets gibt.

Kann der Assistent versehentlich etwas löschen oder ändern?
Mit einem Schlüssel mit reinen Leserechten kann er nichts ändern. Mit Schreibrechten kann er zwar Dinge erstellen und ändern, aber nur innerhalb deines Kontos und deiner Module. Bitte deshalb zuerst um einen Vorschlag und prüfe das Ergebnis.

Sehen meine Kunden, dass ich einen KI-Assistenten verwende?
Nein, nicht automatisch. Ein Plan oder eine Nachricht, die der Assistent erstellt, steht ganz normal in FITsociety, genau wie wenn du es selbst erstellst.

Was geschieht mit den Daten meiner Kunden?
Der Assistent kann nur Daten einsehen, für die deine Kunden ihre Zustimmung erteilt haben, und nur innerhalb deines Kontos. Lies auch die Datenschutzbedingungen des KI-Assistenten, den du verwendest.

Ich erhalte eine Fehlermeldung. Was nun?
Prüfe zuerst den Schlüssel, die Berechtigungen und ob die Verbindung in deinem Assistenten aktiviert ist. Bekommst du eine Meldung über fehlende Rechte, hat dein Schlüssel wahrscheinlich nur Leserechte. Kommst du nicht weiter? Kontaktiere unseren Support.

War dieser Artikel hilfreich? Danke für dein Feedback!

Danke, wir lesen jeden Kommentar.

Ähnliche Artikel