MCP
Usar WAMA con IA (MCP)
WAMA puede hablar con herramientas de IA populares mediante MCP (Model Context Protocol). Tras una configuración breve, puedes preguntar al asistente por productos, stock, ventas, proveedores y compras de un punto de venta — el que elijas al conectar.
Dirección del servidor (igual en todas las herramientas):
Consejo
Necesitas una cuenta WAMA. Prefiere acceso de solo lectura salvo que el asistente deba escribir datos (stock, ventas, borradores de pedidos de compra o proveedores).
Dos formas de conectar
| Método | Cuándo usarlo |
|---|---|
| Iniciar sesión con WAMA (recomendado) | La herramienta abre el navegador y pide iniciar sesión |
| Pegar una clave API | La herramienta solo pide una clave, o el inicio de sesión no está disponible |
Iniciar sesión con WAMA
- Añade la dirección del servidor arriba en tu herramienta de IA.
- Si pide un client id, introduce:
wama-mcp - Completa el login en el navegador, elige un punto de venta y el alcance read o read & write.
- Vuelve a la herramienta de IA — ya estás conectado.
Puedes revocar el acceso después en la app web: Configuración → Integraciones.
Pegar una clave API
- En la web de WAMA: Configuración → Integraciones → Crear clave API.
- Elige el punto de venta y el alcance, luego copia la clave (se muestra solo una vez).
- En la herramienta de IA, añade la misma dirección del servidor y pon la clave en el header Authorization así:
Más detalle: Integraciones y la guía API.
Cursor
- Abre Cursor Settings → MCP (o edita el archivo de config MCP).
- Añade un servidor llamado
wamacon URLhttps://mcp.wama.cloud/mcp. - Prefiere el inicio de sesión: client id
wama-mcpy scoperead(oread_writesi hace falta). - Aprueba el login en el navegador y prueba una pregunta sencilla como “Lista algunos productos”.
Ejemplo de config (inicio de sesión):
Alternativa con clave: la misma URL y un header Authorization con Bearer wama_….
Claude Code
En una terminal:
Luego ejecuta claude mcp login wama (o usa /mcp en Claude Code) y termina el login en el navegador.
Claude.ai
- Abre la configuración de Claude.ai para connectors / MCP personalizado.
- Añade la URL
https://mcp.wama.cloud/mcp. - Si pide un client id, usa
wama-mcp. - Completa el login y el consentimiento de WAMA en el navegador.
ChatGPT
- Activa el Developer mode (o MCP / connectors personalizados, según tu plan de ChatGPT).
- Añade un servidor MCP con URL
https://mcp.wama.cloud/mcp. - Prefiere el client id
wama-mcp(sin secret) si la interfaz lo permite. - Si ChatGPT solo ofrece registro automático del cliente y falla, usa pegar una clave API.
Gemini
- Abre Gemini Settings → Connected apps.
- Elige + Custom.
- Introduce la URL del servidor MCP
https://mcp.wama.cloud/mcp. - Abre Additional settings → Show more.
- Pon Client ID en
wama-mcpy deja Client secret vacío. - Continúa y completa el login y el consentimiento de WAMA en el navegador.
Gemini puede indicar que el servidor no admite el registro automático — es lo esperado; usa el client id estático de arriba.
VS Code / GitHub Copilot
- Abre la configuración MCP / Copilot MCP (JSON).
- Añade un servidor HTTP hacia
https://mcp.wama.cloud/mcpcon OAuth client idwama-mcp. - Completa el login en el navegador cuando se solicite.
Ejemplo:
OpenAI Codex CLI
Añade un servidor MCP HTTP con URL https://mcp.wama.cloud/mcp y client id OAuth wama-mcp. Sigue la documentación actual de Codex para el archivo de config. Completa el login en el navegador si se pide.
Windsurf
Añade un MCP remoto https://mcp.wama.cloud/mcp con client id wama-mcp y termina el login en el navegador.
Otras herramientas de IA
Si tu herramienta admite MCP remoto por HTTPS:
- Usa la URL
https://mcp.wama.cloud/mcp. - Client id
wama-mcp(sin secret) para el inicio de sesión. - O pega una clave API como
Authorization: Bearer wama_….
Las apps de escritorio que abren una URL local (http://localhost… o http://127.0.0.1…) están admitidas automáticamente.
Qué puedes preguntar
Con un asistente conectado (ejemplos):
- “Busca productos que contengan …”
- “Lista categorías” / “Busca categorías …” / “Obtén la categoría …”
- “Crea un producto llamado …” / “Actualiza el precio del producto …”
- “Crea una categoría …” / “Renombra la categoría …”
- “¿Cuál es el stock del producto …?”
- “Lista las ubicaciones de este almacén”
- “Lista proveedores” / “Actualiza la dirección del proveedor …”
- “Crea un borrador de pedido de compra para …”
- “Dame un resumen breve de ventas de esta semana”
Las acciones de escritura (ajustar stock, crear o actualizar un producto o una categoría, crear o completar una venta, crear un borrador de pedido de compra, actualizar un proveedor) necesitan alcance read & write. Prefiere read hasta que las necesites.
Consejos de seguridad
- Una conexión = un punto de venta. Crea otra clave o vuelve a conectar si necesitas otro almacén/tienda.
- Trata las claves API como contraseñas. No las compartas en chat, correo o tickets públicos.
- Revoca las claves que no uses en Configuración → Integraciones.
- Para desarrolladores con la API REST (no MCP), consulta la guía API.