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 y ventas de un punto de venta — el que elijas al conectar.

Dirección del servidor (igual en todas las herramientas):

https://mcp.wama.cloud/mcp

Dos formas de conectar

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.

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 …”
• “¿Cuál es el stock del producto …?”
• “Dame un resumen breve de ventas de esta semana”

Las acciones de escritura (ajustar stock, crear o completar una venta) 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.