IA y MCP

Con una clave API, tu IA lee las ventas, las creadoras y las sesiones de tu agencia, y puede preparar publicaciones o enviar un recordatorio. Tú eliges lo que tiene permitido hacer.

Antes de empezar

• El rol de Propietario o Admin en Velora.
• La doble autenticación activa en tu cuenta.
• Claude Desktop, Claude Code, Cursor u otro cliente MCP.

Crear la clave

1. Abre la página de claves. En la consola, ve a Ajustes y luego Desarrolladores.
2. Haz clic en Crear una clave. Ponle un nombre que diga dónde se usa, por ejemplo Claude de Sara.
3. Marca solo lo necesario. Para preguntar por las cifras, bastan los permisos de lectura. Marca «Enviar notificaciones» solo si lo necesitas.
4. Escribe tu código de doble autenticación. La clave se muestra una sola vez. Cópiala enseguida y guárdala en tu gestor de contraseñas.

Conectar tu IA

1. Apunta la dirección del servidor MCP. Aparece en la consola, en Conectar una IA. Termina en /api/mcp.
2. Claude Code. Ejecuta claude mcp add --transport http velora https://<dominio>/api/mcp --header "Authorization: Bearer vlr_live_…" y luego escribe /mcp para comprobarlo.
3. Cursor. Añade un servidor en ~/.cursor/mcp.json con la dirección en url y tu clave en headers, en Authorization.
4. Claude Desktop. En Ajustes › Desarrollador › Editar configuración, añade el relé mcp-remote con la cabecera Authorization. Reinicia Claude.
5. ChatGPT. Crea un GPT personalizado, añade una Acción, importa el esquema /api/v1/openapi.json y elige Clave API de tipo Bearer.

Lo que puedes pedir

• «¿Cuánto ha facturado cada creadora esta semana, por plataforma?»
• «Lista las sesiones de los próximos 15 días.»
• «Prepara una publicación para felicitar a las creadoras que superaron su objetivo.» Llega como borrador, la publicas tú.
• «Recuérdale a Lina su sesión de mañana.» La IA debe enseñarte el mensaje antes de enviarlo.

Las protecciones

• Una clave solo ve tu agencia, nunca otra.
• Nada de e-mail, teléfono, nombre de fan ni nota interna por la API.
• 50 notificaciones al día como máximo para toda la agencia, además de tus horas de silencio.
• Cada envío y cada borrador queda anotado en el registro, con la clave usada.
• Si el admin que creó la clave deja el equipo, la clave se detiene.

Si no funciona

• Error unauthorized → la clave está mal copiada, caducada o revocada. Crea una nueva.
• Error insufficient_scope → la clave no tiene ese permiso. Crea una clave con ese permiso marcado.
• Error rate_limited o notification_cap_reached → espera los segundos indicados, o a mañana para las notificaciones.
• Error browser_not_allowed → la llamada sale de un navegador. La API solo responde a servidores y aplicaciones.

Enlaces oficiales

• Model Context Protocol
• Servidores MCP en Claude Code