Tu agencia, conectada a tus IA

1. Entra en la consola como Propietario o Admin, con la doble autenticación activa.
2. Abre Ajustes, luego Desarrolladores, y haz clic en Crear una clave.
3. Ponle un nombre claro. Marca solo lo que tu herramienta necesita.
4. Escribe tu código de doble autenticación. La clave solo se muestra una vez: cópiala enseguida.
5. Pégala en la cabecera Authorization de tu herramienta: Bearer y luego la clave.

Una clave empieza por vlr_live_ seguido de 43 caracteres. Después, la consola solo muestra el principio, para reconocerla.

https://<domaine>/api/mcp

claude mcp add --transport http velora https://<domaine>/api/mcp \
  --header "Authorization: Bearer vlr_live_…"

{
  "mcpServers": {
    "velora": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://<domaine>/api/mcp",
        "--header", "Authorization:${VELORA_AUTH}"
      ],
      "env": { "VELORA_AUTH": "Bearer vlr_live_…" }
    }
  }
}

{
  "mcpServers": {
    "velora": {
      "url": "https://<domaine>/api/mcp",
      "headers": { "Authorization": "Bearer vlr_live_…" }
    }
  }
}

https://<domaine>/api/v1/openapi.json

Las herramientas MCP

Una clave solo ve las herramientas de sus permisos. Las de lectura van marcadas como solo lectura: tu IA puede usarlas sin preguntarte.

Cada llamada lleva la cabecera Authorization: Bearer vlr_live_…. Las llamadas desde un navegador se rechazan: llama desde un servidor.

curl https://<domaine>/api/v1/stats/summary?from=2026-10-01&to=2026-10-31 \
  -H "Authorization: Bearer vlr_live_…"

Una lista devuelve 50 elementos como máximo y un nextCursor. Pásalo en cursor para la página siguiente. Vale null al final.

En caso de error, la respuesta da un código y un mensaje. Los códigos: unauthorized (401), insufficient_scope y browser_not_allowed (403), not_found (404), invalid_request (400), rate_limited y notification_cap_reached (429).

{ "error": { "code": "insufficient_scope", "message": "This key lacks the read:sales scope." } }

El esquema OpenAPI 3.1 completo

Referencia

• 120 llamadas por minuto y por clave, 600 por minuto para toda la agencia.
• 50 notificaciones al día para la agencia, sumando todas las claves. Además se aplica el límite por modelo de la consola.
• Por encima: respuesta 429 con la cabecera Retry-After. Espera ese número de segundos.
• 20 claves activas como máximo por agencia.

• Solo guardamos la huella de tu clave. Ni siquiera nosotros podemos leerla.
• Cada clave está ligada a tu agencia. La propia base de datos se niega a mostrar los datos de otra agencia.
• Una clave solo tiene los permisos marcados. Una clave de lectura no cambia nada.
• Si el admin que la creó deja el equipo o pierde su rol, la clave deja de funcionar.
• Cada envío y cada borrador queda anotado en el registro de la agencia, con la clave usada.
• La API nunca devuelve correos, teléfonos, nombres de fans, notas internas ni archivos.
• ¿Clave perdida o compartida por error? Revócala en la consola, el efecto es inmediato.