MCP de Clau

El MCP de Clau conecta tu asistente de IA con los datos de tu negocio: ventas, clientes, puntos, niveles, promociones, campañas, segmentos, tareas y reportes. El asistente usa herramientas con los permisos que tú eliges y nunca puede hacer más que tu usuario del dashboard.

https://mcp.clau.io/mcp

Dato	Valor
URL del servidor MCP	`https://mcp.clau.io/mcp`
Nombre sugerido en tu cliente	`clau`
Transporte	Streamable HTTP
Autenticación	OAuth con tu cuenta del dashboard (recomendada) o una API key con permisos
Negocios por conexión	Uno. Para usar otro negocio, desconecta y vuelve a conectar, o agrega otro servidor con otro nombre
Quién puede conectar	Usuarios del dashboard con el permiso API Keys

Conector oficial en el directorio de Claude · Guía del conector para Claude · Configurar otros clientes · Ver flujos de ejemplo

MCP (Model Context Protocol) es el protocolo abierto que conecta a los asistentes de IA con herramientas externas. Cualquier cliente compatible con servidores MCP remotos por HTTP puede usar Clau.

Cómo te conectas

Con tu cuenta del dashboard (OAuth). Es la forma recomendada y la única disponible en Claude web y Desktop, donde Clau está en el directorio de conectores. En otros clientes agregas la URL y el cliente abre la pantalla de Clau:

Inicias sesión con tu usuario del dashboard.
Revisas el negocio y eliges los permisos. Los de ver vienen marcados; los que modifican datos, no.
Tocas Autorizar y vuelves a tu cliente con las herramientas activas.

No necesitas crear ni copiar ninguna key: la conexión crea una propia, visible y revocable en Configuración → API Keys.

Con una API key con permisos. Sirve para clientes sin navegador (por ejemplo un servidor o una tarea automática) o si prefieres fijar los permisos de antemano. Crea la key en Configuración → API Keys → API keys con permisos y configúrala en el header apikey del cliente, o como Authorization: Bearer ck_.... La key ya identifica tu negocio (ck_<APPID>_...): no hace falta APPID. Guárdala en la configuración privada del cliente, nunca en una conversación.

Los pasos para cada cliente están en Configurar tu cliente de IA.

Qué puede hacer el asistente

El servidor publica solo las herramientas que permiten los permisos de la conexión. Las que modifican datos están marcadas como tales, y los clientes como Claude piden tu confirmación antes de usarlas. Las acciones sobre un grupo de clientes (grupos_puntos, grupos_etiquetar, grupos_regalo…) requieren el permiso de lo que aplican: puntos, clientes o promociones.

Área	Herramientas principales	Permiso
Tu conexión	`cuenta_actual`: negocio, permisos y límites de la conexión	Ninguno
Ventas y compras	`ventas_resumen` (por día, tienda y forma de pago), `compras_listar`, `compras_puntos`, `clientes_compras`	`compras:read`
Clientes	`clientes_buscar`, `clientes_obtener`, `clientes_listar`, `clientes_canjes`, `clientes_etiquetas_activas`, `segmentos_grupo_clientes`	`clientes:read`
Clientes (cambios)	`clientes_crear`, `clientes_actualizar`, `clientes_nota`, `clientes_etiquetar`, `clientes_desetiquetar`, `grupos_etiquetar`, `grupos_desetiquetar`	`clientes:write`
Puntos	`clientes_puntos_historial`; con cambios, `clientes_puntos_agregar` y `grupos_puntos`	`puntos:read` / `puntos:write`
Niveles	`config_niveles`; con cambios, `clientes_nivel_recalcular`	`niveles:read` / `niveles:write`
Promociones	`promociones_listar`, `promociones_obtener`, `promociones_estadisticas`, `promociones_cupones_uso`, `promociones_descuentos`, `beneficios_listar`, `clientes_regalos`; con cambios, crear, actualizar, cambiar estado o stock y asignar regalos a un cliente o a un grupo	`promociones:read` / `promociones:write`
Reportes	`reportes_catalogo`, `reportes_ejecutar`, `reportes_job` y reportes listos de puntos, cupones, canjes, niveles, referidos y clientes (inactivos, mejores, frecuencia, registrados)	`reportes:read`
Segmentos	`segmentos_evaluar`, `segmentos_por_lista` (arman un grupo de clientes); con cambios, `segmentos_guardar_nombre`	`segmentos:read` / `segmentos:write`
Campañas	`campanas_listar`, `campanas_obtener`, `campanas_plantillas`, `campanas_grupos`	`campanas:read`
Tareas automáticas	`tareas_listar`, `tareas_catalogo`, `tareas_historial`, `tareas_ejecuciones`; con cambios, `tareas_status`	`tareas:read` / `tareas:write`
Notificaciones	`clientes_push`: envía una notificación push a un cliente	`notificaciones:write`

El MCP no mueve dinero: pagos, cobros, tarjetas y saldos de gift cards no están disponibles.

Para empezar, pide al asistente:

Usa cuenta_actual del MCP de Clau y dime con qué negocio estás conectado,
qué permisos tienes y tus límites por minuto.

Permisos y seguridad

Los permisos tienen techo. En la pantalla de autorización, los permisos que tu usuario no tiene en el dashboard aparecen deshabilitados.
Las escrituras se auditan. Cada operación que modifica datos queda en la bitácora del negocio, con la key que la hizo.
Reintentos seguros. Las herramientas que modifican datos aceptan idempotency_key: si el asistente repite la misma operación con el mismo valor, Clau devuelve el resultado original en vez de aplicarla dos veces.
Revocación inmediata. Revocar la key en Configuración → API Keys corta el acceso en la siguiente llamada. Las conexiones por OAuth vencen si no se usan en 90 días.
Límites por conexión. Hay un máximo de llamadas por minuto para lecturas, escrituras y acciones sobre grupos. cuenta_actual muestra los límites efectivos.

Solución de problemas

Situación	Qué hacer
«Tu usuario no tiene el permiso API Keys»	Pide a un administrador del negocio que active ese permiso a tu usuario, o conecta con otra cuenta.
«La solicitud de conexión venció»	Vuelve a tu cliente y conecta Clau otra vez: la pantalla de autorización vence a los 15 minutos.
El cliente pide volver a conectar o responde `401`	La key de la conexión fue revocada o la conexión venció. Conecta de nuevo. Con API key, revisa que sea válida y que el header sea `apikey` o `Authorization: Bearer`.
`400` «APPID requerido» con API key	La key es del formato anterior (`ck_` seguido directamente de 8 caracteres hexadecimales). Cambia su secreto desde el dashboard para obtener una key que ya incluye el negocio.
Falta una herramienta	La conexión no tiene ese permiso. Desconecta y vuelve a conectar marcándolo, o usa una key con ese scope.
Una herramienta responde que falta un permiso	Lee el permiso requerido en el mensaje y solicítalo al administrador del negocio.
Límite de llamadas	Espera los segundos que indique la respuesta y vuelve a intentar.
Un reporte queda «en proceso»	Pide al asistente consultar `reportes_job` con el `jobId` recibido, en lugar de volver a ejecutar el reporte.

Si necesitas soporte, indica el cliente de IA, la hora, la herramienta y lo que pediste. No compartas API keys ni datos personales de clientes.