Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/mcp/verbinden.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
MCP und KI / Verbinden / So funktioniert esAls Markdown ansehen

Einen KI-Assistenten verbinden

Der MCP-Server von StampyWallet verbindet Claude, ChatGPT, Cursor oder einen Agenten mit Ihrer Stempelkarte. Eine Adresse, kein Schlüssel, und nichts ändert sich ohne Ihre Zustimmung.

StampyWallet spricht das Model Context Protocol (MCP), den Standard, mit dem ein KI-Assistent Tools nutzen kann. Einmal verbunden, können Sie im Gespräch fragen: „Gestalte mir eine Stempelkarte“, „Wie viele Kunden waren diesen Monat da?“, „Sag meinen Stammkunden, dass ich Montag geschlossen habe.“

Die Serveradresse

MCP-Server
https://app.stampywallet.com/mcp

„Streamable“ HTTP, JSON-Antworten, zustandslos. Mehr müssen Sie Ihrem Assistenten nicht geben.

Einstellungen › Connectors › Benutzerdefinierten Connector hinzufügen, Adresse einfügen. Schritt für Schritt: Claude.

Ohne Konto, dann mit Ihrem Konto

Der Server bietet zwei Gruppen von Tools unter derselben Adresse:

  • Ohne Konto: concevoir_carte gestaltet eine Karte passend zu einem Laden, simuler_fidelite rechnet aus, was sie kostet, und creer_commerce schaltet sie live und gibt einen Link zurück, über den man Inhaber wird. Keine Anmeldung nötig.
  • Mit Ihrem Konto: Ihre Zahlen, Ihre Kunden, Ihre Nachrichten, die Google-Bewertungen, die Karteneinstellungen, der Aufsteller, das Team. Beim ersten Aufruf öffnet der Assistent die StampyWallet-Anmeldeseite (OAuth): Sie melden sich an, wählen den Laden und erlauben den Zugriff.

Auf dem Freigabebildschirm können Sie nur lesen ankreuzen: Der Assistent liest dann Ihre Zahlen und Einstellungen, kann aber nichts ändern. Die Zugänge verwalten Sie unter Einstellungen › Ihre Daten › Verbundene Assistenten, wo sich jeder Assistent mit einem Klick trennen lässt.

BerechtigungWas sie erlaubt
stampy.lectureIhre Zahlen, Ihre Kunden (Vornamen), Ihre Einstellungen und Ihre Karte lesen
stampy.ecritureIn Ihrem Namen handeln: Nachrichten an Kunden, Einstellungen, Karte, Team, immer erst nach Ihrer Zustimmung in der Unterhaltung

Nichts ändert sich ohne Ihre Zustimmung

Die Tools, die schreiben, haben einen Parameter confirmer, standardmäßig false. So aufgerufen, tun sie nichts: Sie liefern eine Vorschau (den genauen Text einer Nachricht und die Zahl der Empfänger, den Zustand einer Einstellung vorher und nachher). Der Assistent zeigt sie Ihnen und ruft das Tool erst nach Ihrem „Ja“ mit confirmer: true erneut auf.

Achtung : Zwei Dinge gehen nur an der Kasse, durch Scannen der Kundenkarte: Stempel vergeben und Prämien einlösen. Kein MCP-Tool kann das. Um sie aus einem Kassensystem zu vergeben, gibt es die API.

Die Tools

ToolKontoWirkung
concevoir_carteOhneNur lesen
simuler_fideliteOhneNur lesen
creer_commerceOhneSchreibt (confirmer)
tableau_de_bordMitNur lesen
rentabiliteMitNur lesen
meilleurs_momentsMitNur lesen
chercher_clientsMitNur lesen
fiche_clientMitNur lesen
envoyer_messageMitSchreibt (confirmer)
lister_messages_recurrentsMitNur lesen
programmer_message_recurrentMitSchreibt (confirmer)
modifier_message_recurrentMitSchreibt (confirmer)
suspendre_message_recurrentMitSchreibt (confirmer)
reprendre_message_recurrentMitSchreibt (confirmer)
arreter_message_recurrentMitSchreibt (confirmer)
historique_messagesMitNur lesen
regler_automatismesMitSchreibt (confirmer)
lister_fermeturesMitNur lesen
ajouter_congesMitSchreibt (confirmer)
supprimer_congesMitSchreibt (confirmer)
regler_jours_fermesMitSchreibt (confirmer)
avis_googleMitSchreibt (confirmer)
voir_carteMitNur lesen
modifier_carteMitSchreibt (confirmer)
fiche_commerceMitSchreibt (confirmer)
affichetteMitNur lesen
envoyer_affichetteMitSchreibt (confirmer)
lister_equipeMitNur lesen
inviter_membreMitSchreibt (confirmer)
changer_role_membreMitSchreibt (confirmer)
retirer_membreMitSchreibt (confirmer)
annuler_invitationMitSchreibt (confirmer)

Die Tools, die ein Konto brauchen, richten sich auch nach Ihrer Rolle: Ein Mitarbeiter hat auf keines Zugriff, und die Team-Tools lister_equipe, inviter_membre, changer_role_membre, retirer_membre und annuler_invitation sind dem Inhaber vorbehalten. Schließlich richten sie sich nach Ihrem Tarif (manche Zahlen und die Google-Bewertungen setzen Wachstum voraus).

Von Hand ausprobieren

Der Server antwortet jedem MCP-Client, oder curl:

curl
curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ohne Konto sind die Aufrufe pro IP-Adresse begrenzt: Darüber hinaus bittet der Server, ein paar Minuten zu warten.

Häufige Fragen

Brauche ich einen Schlüssel, um den MCP-Server zu verbinden?

Nein, keinen Schlüssel. Die Tools ohne Konto funktionieren sofort; für Ihre Zahlen und Ihre Kunden lässt Sie der Assistent beim ersten Aufruf Ihr StampyWallet-Konto verbinden.

Funktioniert das mit dem kostenlosen ChatGPT?

Bei StampyWallet kostet das Verbinden des Servers nichts, und die Tools ohne Konto stehen allen offen. Bei ChatGPT wird StampyWallet in diesen 9 Ländern über die Plugins installiert, ohne Entwicklermodus. Anderswo wird der Connector im Entwicklermodus erstellt, dessen Verfügbarkeit von Ihrem ChatGPT-Abo abhängt. Bietet Ihres ihn nicht an, verbinden sich Claude, Cursor oder jeder andere MCP-Client über dieselbe Adresse.

Kann der Assistent etwas ohne meine Zustimmung ändern?

Nein. Die Tools, die schreiben, liefern zuerst eine Vorschau, und der Assistent ruft sie erst nach Ihrem „Ja“ mit confirmer: true erneut auf. Sie können auch nur Lesezugriff erlauben.

Kann der Assistent Stempel vergeben?

Nein. Stempel vergeben und Prämien einlösen geht nur an der Kasse, durch Scannen der Kundenkarte. Aus einem Kassensystem erledigt das der API-Endpunkt Besuch hinzufügen.

Wie entziehe ich einem Assistenten den Zugriff?

Unter Einstellungen › Ihre Daten › Verbundene Assistenten: Jeder Assistent lässt sich mit einem Klick trennen.

War diese Seite hilfreich?