# Tokens y permisos

Un token le da a tu agente acceso a los datos de tu empresa. Cada uno tiene un nombre y un permiso, y puedes revocarlo cuando quieras.

## Crear un token

Solo los dueños y administradores de la empresa pueden crear tokens.

1. En Bison, entra a **Ajustes → API y agentes**.
2. Pulsa **Crear token**.
3. Ponle un nombre que diga dónde lo vas a usar, para reconocerlo después.
4. Elige el permiso: **Solo lectura** o **Lectura y edición**.
5. Copia el token. No se vuelve a mostrar: si lo pierdes, crea otro y revoca este.

Los tokens empiezan con `bsn_`. De cada uno Bison guarda solo una huella, nunca el token completo.

## Permisos

| Permiso | Qué puede hacer | Herramientas |
| --- | --- | --- |
| Solo lectura | Consultar tu visibilidad, competidores, fuentes, preguntas, mejoras, auditorías y reportes. | 18 |
| Lectura y edición | Todo lo anterior, más completar el perfil de marca, crear y archivar preguntas, aceptar sugerencias, agregar o editar competidores, cambiar el estado de mejoras y lanzar trabajos con costo (auditoría de schema, FAQs y recálculo de mejoras). | 30 |

> **Elige el permiso mínimo:** Usa solo lectura salvo que de verdad necesites que tu agente cambie datos o lance trabajos. Con edición, el servidor le indica a tu agente que pida tu confirmación antes de usar una herramienta que cambia datos o tiene costo.

Mira la lista completa, con el permiso de cada una, en [Herramientas](https://docs.bisonagents.com/mcp/herramientas/).

## Buenas prácticas

- Crea un token por herramienta o por persona, con un nombre que diga dónde se usa. Así puedes revocar uno sin cortar los demás.
- No lo guardes en repositorios, chats ni documentos compartidos. Usa variables de entorno o el gestor de secretos de tu cliente.
- Si sospechas que se filtró, revócalo de inmediato.

## Revocar un token

En la tabla de tokens de **Ajustes → API y agentes**, revoca el que ya no uses. Desde ese momento, el agente que lo tenga recibe un error 401.

Cada empresa puede tener hasta 10 tokens activos a la vez. Revoca uno antes de crear otro.