Saltar al contenido principal
Una clave de API tiene la forma bkg_live_ seguida de 48 caracteres hexadecimales. Es un secreto: quien la tenga consulta como vos y consume tu cupo.
No publiques tu clave ni la subas a un repositorio. Si se filtra, revocala enseguida y creá otra.

Claves personales

Cada persona crea sus propias claves desde la aplicación. La misma clave sirve para la API REST (/v1) y para el MCP.
1

Abrí el menú de tu nombre

En app.blockgence.com, arriba a la derecha → MCP….
2

Creá la clave

Crear clave, con un nombre que diga dónde la vas a usar (por ejemplo, «servidor de reportes» o «Cursor en mi notebook»).
3

Copiala en ese momento

El valor se muestra una sola vez. Después solo queda su prefijo, para reconocerla en la lista.
Podés tener hasta 5 claves personales a la vez. Usá una por cliente o por máquina: si una se compromete, revocás solo esa. La revocación es inmediata y se hace desde el mismo lugar. Cada clave tiene el plan de tu organización y actúa como vos: ve tus casos y tus labels, y lo que consulte se mide en tu cuenta.

Claves de la organización

Un admin puede crear claves que no son de una persona, para integraciones: Administración → keys de la organización.
  • Actúan como la organización y consumen su cupo.
  • Ven los casos de la organización y los que ella comparte. Los casos que crean nacen compartidos con la organización, para que no queden inaccesibles si se revoca la clave.
  • Se pueden limitar a recursos de la API (scopes): por ejemplo, solo trace y cases. Fuera de ellos responden 403 con error: "key_scope".
  • Pueden ser de solo lectura (read_only), con las mismas reglas que el rol viewer.
  • Dejan de andar si se las revoca o si la organización queda inactiva (401).

Usar la clave

Mandala en cada pedido, en cualquiera de los dos headers:
Detalle en Autenticación.

Aplicaciones conectadas por OAuth

Si conectás Blockgence a un asistente con login (por ejemplo, un conector de claude.ai), no pegás ninguna clave: la aplicación obtiene una clave tuya que vence al día y se renueva sola. Las ves y las desconectás en MCP… → Aplicaciones conectadas; desconectar revoca la conexión y todas sus claves al instante. Ver Conectarse al MCP.