Connect Claude
Set up your stamp card, see your numbers and run automations by chat. How to connect Claude to stemp, what it may do, and how to disconnect it.
Connect Claude
Tell Claude which reward you want, and your stamp card for Apple Wallet and Google Wallet is ready. Claude talks to stemp through the stemp MCP server and only does what you allow when you connect.
What You Need
- A stemp account. If you don't have one yet, you create it while connecting and land right back in the chat.
- Claude, in the browser or the desktop app.
stemp is in German and made for shops in Germany, Austria and Switzerland. The sign-in and the consent screen are German, too.
Connect Claude
- In Claude, go to Customize → Connectors and select Discover.
- Search for stemp and select Connect to Claude.
- Sign in to stemp, or create your account.
- On the consent screen, check the shop and select Autorisieren.
- You're back in Claude. Try one of the example prompts.
What Happens When You Connect
- Your assistant opens the stemp sign-in. If you're new, select Noch kein Konto? Registrieren and create your account there.
- The consent screen lists what the assistant may do, one sentence per permission. If your account has several shops, you pick the one the assistant works with.
- After Autorisieren you return to the chat. The assistant stays connected and renews its access on its own.
Try It
| You write | What happens |
|---|---|
| "Mach mir eine Stempelkarte: Nach zehn Haarschnitten ist der elfte gratis." | The assistant creates your stamp card with 10 stamps and a free haircut as reward, and gives you the link to your sign-up page. Open it on your phone, and your card is in your wallet a minute later. |
| "Wie lief mein Blumenladen in den letzten 30 Tagen?" | New guests, stamps and redeemed rewards for the last 30 days, plus all guests and regulars since the start. |
| "Ab jetzt gibt's die Prämie schon nach acht Stempeln." | The assistant asks you first, then changes your card. Your guests see the new number in their wallet. |
You can write in English, too.
What the Assistant Can Do
Your assistant shows each tool by its German title, for example when it asks before a change.
| Tool | Title | What it does | Changes data |
|---|---|---|---|
list_shops | Meine Läden | Lists your shops and their stores | No |
get_shop_stats | Statistiken | New guests, stamps and redeemed rewards for a period, all guests and regulars since the start | No |
get_stamp_card | Stempelkarte anzeigen | Shows your stamp card with the link to your sign-up page, or the designs to start from if you have none | No |
create_stamp_card | Stempelkarte anlegen | Creates your stamp card from a design, with reward and number of stamps. If your shop still carries the name from your email address, it gets the name you gave in the chat. Returns the link to your sign-up page | Yes |
update_stamp_card | Stempelkarte ändern | Changes the reward, its description or the number of stamps. Guests see it on their card | Yes, asks first |
list_tags | Tags anzeigen | Your tags and how many guests carry each one | No |
list_automations | Automationen anzeigen | Your automations, how many messages they sent and how many are waiting | No |
preview_automation | Automation prüfen | Previews an automation: who it applies to and who it would reach now, without sending | No |
create_automation | Automation anlegen | Creates an automation from a template, switched off | Yes |
activate_automation | Automation einschalten | Switches an automation on. Guests start getting its message on their card | Yes, asks first |
pause_automation | Automation pausieren | Pauses an automation. Messages due during the pause are skipped | Yes, asks first |
The automation tools work for shops on Max. No tool returns names, email addresses or phone numbers of your guests.
What the Assistant Cannot Do
- Delete anything: no cards, guests, stores or automations.
- Give or take stamps.
- See or export the contact data of your guests.
- Change your plan, start a payment or see your payment details.
- Invite team members, change roles or create API tokens.
If you ask for one of these, the assistant tells you it can't and points you to the stemp dashboard. A team member can only do what their role in stemp allows, with or without an assistant.
Permissions
The consent screen lists these permissions. Your assistant gets all of them, and stemp checks them on every call like any other API request.
| Permission | Allows the assistant to |
|---|---|
openid | Know which stemp account you are |
offline_access | Stay connected without signing in again, for up to 30 days after its last use |
org:read, location:read | See your shops, stores and their numbers |
user_tag:read | See your tags and how many guests carry them |
template:read, template:create, template:update | See, create and change your stamp card |
workflow:read, workflow:manage | See, create, switch on and pause automations. Switched on, they send messages to your guests |
Disconnect
In Claude, go to Customize → Connectors, select stemp, then Disconnect. To take it off your list, open the three-dot menu and select Remove.
The assistant can't use stemp after that. The access it held runs out on its own at the latest 30 days after its last use. To end it at once, write to hallo@stemp.app.
Troubleshooting
| The assistant says | What to do |
|---|---|
| Your shop already has a stamp card | Every shop has one stamp card. Ask the assistant to change it instead. |
| Automations are not enabled | Automations come with Max. Everything else works as usual. |
| It can't reach stemp, or asks you to sign in again | Disconnect and connect again. Sign in with the account that belongs to the shop. |
| It picked the wrong shop | Name the shop in your message, for example "bei Blumen Lea". |
Still stuck? Write to hallo@stemp.app or visit help.stemp.app.
For Developers
| Server URL | https://mcp.stemp.app |
| Transport | Streamable HTTP, stateless |
| Authorization | OAuth 2.1 Authorization Code with PKCE (S256). A request without a token gets 401 with WWW-Authenticate pointing to the protected resource metadata (RFC 9728), which names the stemp authorization server. |
| Clients | Claude is registered by stemp. Other MCP clients can't connect yet. |
| Tokens | Access tokens last 30 minutes. Refresh tokens last 30 days and are replaced on every refresh. |
| Tool annotations | Every tool sets title, readOnlyHint, destructiveHint and openWorldHint. Tools that overwrite data or reach your guests are marked destructive, so the assistant asks before it calls them. |
| Errors | An error names its code and the field, for example stamp_card_already_exists. See Error Handling. |
The tools call the same services and check the same scopes as the stemp API. To build your own integration, start with Getting Started.
Privacy
The assistant receives your shop's numbers and settings, never data of individual guests. stemp does not receive your chat history, only what the assistant sends for a task. Details are in the privacy policy.