> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claves de API

> Cómo crear, usar, rotar y revocar las claves de la API y del MCP.

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.

> [!WARNING]
>
> 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](https://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:

```bash Authorization: Bearer theme={null}
curl https://app.blockgence.com/v1/account \
  -H "Authorization: Bearer bkg_live_…"
```

```bash X-API-Key theme={null}
curl https://app.blockgence.com/v1/account \
  -H "X-API-Key: bkg_live_…"
```

Detalle en [Autenticación](https://docs.blockgence.com/es/api/authentication.md).

## 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](https://docs.blockgence.com/es/mcp/connect.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.