Werkzeuge · Credits
MCP-Tools für Buchungs-Credits: Stand, Kontoauszug, Credits vergeben, korrigieren und abziehen, und die Regeln der Community (Ansparen, Stornofrist, späte Stornierung und Nichterscheinen). Mindestrolle und Rezepte.
Die Credits über den Assistenten: den Stand und den Kontoauszug sehen (das eigene oder, für das Team, das jedes Mitglieds), Credits vergeben und korrigieren, sie abziehen und die Regeln der Community lesen oder ändern. Die Credits der Pläne und Produkte legst du mit create_plan und update_plan (monthly_credits) und create_product und update_product (granted_credits und granted_credits_validity_days) fest; in einer Community ohne Bereich für Buchungen oder Terminbuchung erklärt der Assistent, dass zuerst einer angelegt werden muss.
Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
get_credit_balance | Der Stand, was in 7 Tagen verfällt, und die Posten | Alle (eigenes); Team (anderer) | Nur lesen |
list_credit_entries | Der Kontoauszug, vom neuesten zum ältesten | Alle (eigener); Team (anderer) | Nur lesen |
grant_credits | Legt einen neuen Posten mit Credits an, mit Grund | Finanzen | Mit Bestätigung |
adjust_credits | Fügt Credits als Korrektur hinzu, mit Grund | Finanzen | Mit Bestätigung |
revoke_credits | Zieht Credits ab (negative Korrektur) | Finanzen | Mit Bestätigung |
get_credit_settings | Die Credit-Regeln der Community | Moderator (oder Finanzen) | Nur lesen |
update_credit_settings | Ändert die Regeln | Administrator | Ändert |
„Finanzen“ bedeutet hier Eigentümer, Administrator oder Finanzen; der Moderator liest nur. „Team“ sind Eigentümer, Administrator, Moderator und Finanzen. Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person in der Oberfläche tun würde. Die Plattformvariable, die entscheidet, ob ein pausiertes oder säumiges Abonnement die Credits weiter nutzt, gehört dem SuperAdmin und hat kein Tool.
get_credit_balance
Nur lesen
Der Stand. Der nutzbare Stand (die Summe der nicht verfallenen Posten; er kann negativ sein, was das Buchen blockiert), was in den nächsten 7 Tagen verfällt, und die Posten, jeder mit der Herkunft (Tarif, Produkt oder Team), dem Rest und dem Verfallsdatum. Mindestrolle: alle (eigenes); das Team liest das jedes Mitglieds.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
profile_id | ID | Nein | Nur das Team: von wem. Ohne ihn ist es deins (ein Mitglied, das nach dem einer anderen Person fragt, wird abgewiesen) |
Frag so: „Wie viele Credits habe ich?“ · „Wie ist der Stand von Maria Souza?“
list_credit_entries
Nur lesen
Der Kontoauszug. Jeder Eintrag mit der Art (Vergabe, Nutzung für eine Buchung, Erstattung, Korrektur, Verfall, Widerruf), dem Betrag mit Vorzeichen, der Herkunft, der dahinterstehenden Buchung, dem Produkt oder dem Abonnement und dem Grund. Das Buch wächst nur: Nichts wird bearbeitet oder gelöscht. Seitenweise.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
profile_id | ID | Nein | Nur das Team: von wem. Ohne ihn ist es deiner |
kind | GRANT, DEBIT, REFUND, ADJUSTMENT, EXPIRATION oder REVOCATION | Nein | Filtert nach Art |
page, limit | Zahl | Nein | Seiten (limit bis 200) |
Frag so: „Zeig mir den Credit-Kontoauszug von Maria für diesen Monat.“
grant_credits
Mit Bestätigung
Credits vergeben. Legt einen neuen Posten mit Pflichtgrund und optionaler Gültigkeit an (ohne sie verfallen sie nicht). Vor dem Handeln zeigt es eine Zusammenfassung und wiederholt den Aufruf erst nach deinem Ja. Liefert den neuen Stand und den Eintrag. Mindestrolle: Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
profile_id | ID | Ja | Das Mitglied (list_members) |
amount | ganze Zahl, von 1 bis 100.000 | Ja | Wie viele Credits |
reason | Text (bis 255) | Ja | Der Grund: bleibt im Kontoauszug |
expires_at | Datum und Uhrzeit in der Zukunft | Nein | Wann sie verfallen; ohne oder mit null nie |
Frag so: „Gib João 10 Kulanz-Credits, gültig bis Monatsende, weil er ein neues Mitglied empfohlen hat.“
adjust_credits
Mit Bestätigung
Nach oben korrigieren. Fügt Credits als Korrektur hinzu (ein Korrektureintrag: So behebst du einen Fehler, da das Buch nie bearbeitet wird). Dieselben Parameter wie grant_credits (bis 100.000 auf einmal), und es verlangt ebenfalls eine Bestätigung. Um Credits abzuziehen, nutze revoke_credits, das eine Bestätigung verlangt. Mindestrolle: Finanzen.
revoke_credits
Mit Bestätigung
Credits abziehen. Eine negative Korrektur, mit Pflichtgrund. Verbraucht zuerst die Posten, die früher verfallen, und geht nicht über den nutzbaren Stand hinaus (sonst 409: lies vorher den Stand). Vor dem Handeln zeigt es eine Zusammenfassung (wie viel, der Stand jetzt, der Stand danach und der Grund) und wiederholt den Aufruf mit dem confirmation_token erst nach einem ausdrücklichen Ja. Mindestrolle: Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
profile_id | ID | Ja | Das Mitglied |
amount | ganze Zahl, 1 oder mehr | Ja | Wie viele Credits abgezogen werden |
reason | Text | Ja | Der Grund |
get_credit_settings
Nur lesen
Die Regeln. Ansparen (ein, Obergrenze, Monate), Anteil im ersten Monat, Stornofrist in Stunden, ob späte Stornierung und Nichterscheinen die Credits kosten, und die Tage der Verfallswarnung. Mindestrolle: Moderator (oder Finanzen).
update_credit_settings
Ändert
Die Regeln ändern. Ändert nur, was du schickst. Gilt ab dem nächsten Monatswechsel und ändert nie einen bestehenden Posten. Mindestrolle: Administrator.
| Parameter | Typ | Beschreibung |
|---|---|---|
rollover_enabled | wahr oder falsch | Credits des Plans in den nächsten Monat übertragen (Voreinstellung: nein) |
rollover_cap | ganze Zahl oder null | Die Obergrenze der Übertragung; null: keine Obergrenze |
rollover_max_cycles | 1 bis 12 | Wie viele Monate das Angesparte gilt |
prorate_first_month | wahr oder falsch | Anteil für die verbleibenden Tage im ersten Monat |
change_window_hours | 0 bis 720 | Frist zum Stornieren oder Ändern ohne Verlust (Voreinstellung: 24) |
late_cancel_loses_credits | wahr oder falsch | Späte Stornierung kostet die Credits (Voreinstellung: ja) |
no_show_loses_credits | wahr oder falsch | Nichterscheinen kostet die Credits (Voreinstellung: ja) |
expiry_notice_days | 0 bis 30 | Tage der Warnung vor dem Verfall (0 = keine Warnung) |
Frag so: „Schalte das Ansparen von Credits ein, mit einer Obergrenze von 20, für 2 Monate, und setze die Stornofrist auf 12 Stunden.“