Conectar un asistente de IA
El servidor MCP de StampyWallet conecta Claude, ChatGPT, Cursor o un agente con tu tarjeta de fidelidad. Una dirección, ninguna clave, y nada cambia sin tu aprobación.
StampyWallet habla el Model Context Protocol (MCP), el estándar que permite a un asistente de IA usar herramientas. Una vez conectado, puedes pedir en la conversación: «diséñame una tarjeta de fidelidad», «¿cuántos clientes han venido este mes?», «avisa a mis clientes habituales de que cierro el lunes».
La dirección del servidor
https://app.stampywallet.com/mcpHTTP «streamable», respuestas JSON, sin estado. Es lo único que tienes que darle a tu asistente.
Configuración › Conectores › Añadir conector personalizado, pega la dirección. Paso a paso: Claude.
Configuración › Aplicaciones y conectores, modo desarrollador, Crear, pega la dirección. Paso a paso: ChatGPT.
{
"mcpServers": {
"stampywallet": { "url": "https://app.stampywallet.com/mcp" }
}
}Paso a paso, y Claude Code: Cursor y agentes.
Sin cuenta, y luego con tu cuenta
El servidor ofrece dos familias de herramientas en la misma dirección:
- Sin cuenta:
concevoir_cartediseña una tarjeta a imagen de un comercio,simuler_fidelitecalcula lo que cuesta, ycreer_commercela pone en marcha y devuelve un enlace para convertirse en su propietario. No se pide ninguna conexión. - Con tu cuenta: tus cifras, tus clientes, tus mensajes, las reseñas de Google, los ajustes de la tarjeta, el cartel, el equipo. En la primera llamada, el asistente abre la página de inicio de sesión de StampyWallet (OAuth): inicias sesión, eliges el comercio y autorizas el acceso.
En la pantalla de autorización, puedes marcar solo lectura: el asistente lee tus cifras y tus ajustes, pero no puede cambiar nada. Los accesos se gestionan en Ajustes › Tus datos › Asistentes conectados, donde cada asistente se desconecta con un clic.
| Alcance | Lo que permite |
|---|---|
stampy.lecture | Leer tus cifras, tus clientes (nombres), tus ajustes y tu tarjeta |
stampy.ecriture | Actuar por ti: mensajes a los clientes, ajustes, tarjeta, equipo, siempre con tu aprobación en la conversación |
Nada cambia sin tu aprobación
Las herramientas que escriben aceptan un parámetro confirmer, false por defecto. Llamadas así, no hacen nada: devuelven una vista previa (el texto exacto de un mensaje y el número de destinatarios, el antes y el después de un ajuste). El asistente te la enseña y solo vuelve a llamar a la herramienta con confirmer: true después de tu «sí».
Atención : dos cosas solo se hacen en el mostrador, escaneando la tarjeta del cliente: poner sellos y entregar recompensas. Ninguna herramienta MCP lo hace. Para ponerlos desde un TPV, existe la API.
Las herramientas
| Herramienta | Cuenta | Efecto |
|---|---|---|
concevoir_carte | Sin | Solo lectura |
simuler_fidelite | Sin | Solo lectura |
creer_commerce | Sin | Escribe (confirmar) |
tableau_de_bord | Con | Solo lectura |
rentabilite | Con | Solo lectura |
meilleurs_moments | Con | Solo lectura |
chercher_clients | Con | Solo lectura |
fiche_client | Con | Solo lectura |
envoyer_message | Con | Escribe (confirmar) |
historique_messages | Con | Solo lectura |
regler_automatismes | Con | Escribe (confirmar) |
fermetures | Con | Escribe (confirmar) |
avis_google | Con | Escribe (confirmar) |
voir_carte | Con | Solo lectura |
modifier_carte | Con | Escribe (confirmar) |
fiche_commerce | Con | Escribe (confirmar) |
affichette | Con | Solo lectura |
envoyer_affichette | Con | Escribe (confirmar) |
equipe | Con | Escribe (confirmar) |
Las herramientas que requieren una cuenta también respetan tu rol (un empleado no tiene acceso a ninguna; equipe está reservada al propietario) y tu plan (algunas cifras y las reseñas de Google requieren Crecimiento).
Probar a mano
El servidor responde a cualquier cliente MCP, o a 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"}'Sin cuenta, las llamadas están limitadas por dirección IP: por encima del límite, el servidor pide esperar unos minutos.
Preguntas frecuentes
¿Necesito una clave para conectar el servidor MCP?
No, ninguna clave. Las herramientas sin cuenta funcionan enseguida; para tus cifras y tus clientes, el asistente te pide conectar tu cuenta StampyWallet en la primera llamada.
¿Funciona con ChatGPT gratis?
Por parte de StampyWallet, no hay nada que pagar para conectar el servidor, y las herramientas sin cuenta están abiertas a todos. Por parte de ChatGPT, el conector se crea en modo desarrollador, y el acceso a ese modo depende de tu plan de ChatGPT. Si el tuyo no lo ofrece, Claude, Cursor o cualquier otro cliente MCP se conectan a la misma dirección.
¿El asistente puede cambiar algo sin mi aprobación?
No. Las herramientas que escriben devuelven primero una vista previa, y el asistente solo las vuelve a llamar con confirmer: true después de tu «sí». También puedes autorizar solo la lectura.
¿El asistente puede poner sellos?
No. Poner sellos y dar recompensas se hace solo en el mostrador, escaneando la tarjeta del cliente. Desde un TPV, lo hace la API.
¿Cómo corto el acceso de un asistente?
En Ajustes › Tus datos › Asistentes conectados: cada asistente se corta con un clic.
Actualizado el