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):

https://mcp.wama.cloud/mcp
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étodoCuándo usarlo
Iniciar sesión con WAMA (recomendado)La herramienta abre el navegador y pide iniciar sesión
Pegar una clave APILa herramienta solo pide una clave, o el inicio de sesión no está disponible

Iniciar sesión con WAMA

  1. Añade la dirección del servidor arriba en tu herramienta de IA.
  2. Si pide un client id, introduce: wama-mcp
  3. Completa el login en el navegador, elige un punto de venta y el alcance read o read & write.
  4. 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

  1. En la web de WAMA: Configuración → Integraciones → Crear clave API.
  2. Elige el punto de venta y el alcance, luego copia la clave (se muestra solo una vez).
  3. En la herramienta de IA, añade la misma dirección del servidor y pon la clave en el header Authorization así:
Bearer wama_…tu_clave…

Más detalle: Integraciones y la guía API.


Cursor

  1. Abre Cursor Settings → MCP (o edita el archivo de config MCP).
  2. Añade un servidor llamado wama con URL https://mcp.wama.cloud/mcp.
  3. Prefiere el inicio de sesión: client id wama-mcp y scope read (o read_write si hace falta).
  4. Aprueba el login en el navegador y prueba una pregunta sencilla como “Lista algunos productos”.

Ejemplo de config (inicio de sesión):

{
  "mcpServers": {
    "wama": {
      "url": "https://mcp.wama.cloud/mcp",
      "auth": {
        "CLIENT_ID": "wama-mcp",
        "scopes": ["read"]
      }
    }
  }
}

Alternativa con clave: la misma URL y un header Authorization con Bearer wama_….

Claude Code

En una terminal:

claude mcp add --transport http --client-id wama-mcp wama https://mcp.wama.cloud/mcp

Luego ejecuta claude mcp login wama (o usa /mcp en Claude Code) y termina el login en el navegador.

Claude.ai

  1. Abre la configuración de Claude.ai para connectors / MCP personalizado.
  2. Añade la URL https://mcp.wama.cloud/mcp.
  3. Si pide un client id, usa wama-mcp.
  4. Completa el login y el consentimiento de WAMA en el navegador.

ChatGPT

  1. Activa el Developer mode (o MCP / connectors personalizados, según tu plan de ChatGPT).
  2. Añade un servidor MCP con URL https://mcp.wama.cloud/mcp.
  3. Prefiere el client id wama-mcp (sin secret) si la interfaz lo permite.
  4. Si ChatGPT solo ofrece registro automático del cliente y falla, usa pegar una clave API.

Gemini

  1. Abre Gemini Settings → Connected apps.
  2. Elige + Custom.
  3. Introduce la URL del servidor MCP https://mcp.wama.cloud/mcp.
  4. Abre Additional settings → Show more.
  5. Pon Client ID en wama-mcp y deja Client secret vacío.
  6. 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

  1. Abre la configuración MCP / Copilot MCP (JSON).
  2. Añade un servidor HTTP hacia https://mcp.wama.cloud/mcp con OAuth client id wama-mcp.
  3. Completa el login en el navegador cuando se solicite.

Ejemplo:

{
  "servers": {
    "wama": {
      "type": "http",
      "url": "https://mcp.wama.cloud/mcp",
      "oauth": {
        "clientId": "wama-mcp"
      }
    }
  }
}

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:

  1. Usa la URL https://mcp.wama.cloud/mcp.
  2. Client id wama-mcp (sin secret) para el inicio de sesión.
  3. 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.