La API y las claves API
Un asistente como Claude o ChatGPT se conecta mediante la página de autorización de To Bill: consulte Conectar un asistente de IA. Una herramienta que no dispone de esa página, como un script, un cliente MCP de línea de comandos o una automatización, utiliza una clave API personal. Esta página explica las claves y da las direcciones técnicas.
Las direcciones
| Qué | Dirección |
|---|---|
| Servidor MCP (asistentes de IA) | https://app.tobill.ch/mcp |
| API de To Bill | https://app.tobill.ch/api/… |
| Descubrimiento OAuth | https://app.tobill.ch/.well-known/oauth-authorization-server |
| Referencia de la API (beta) | https://docs.tobill.ch/api |
El servidor MCP da al asistente herramientas listas para usar para la contabilidad y la facturación, además de dos herramientas que abren todo el resto de To Bill: una busca la ruta adecuada de la API y la otra la llama, con los mismos controles que la app.
La referencia de la API describe cada ruta que abre una clave, con sus parámetros, respuestas y ejemplos; su versión interactiva le permite probar una solicitud con su clave.
Crear una clave
- Abra Configuración › Conexiones IA y API.
- En Claves API personales, haga clic en Crear una clave.
- Dele un Nombre que indique para qué sirve, elija el Acceso (Solo lectura o Lectura y modificación) y la Validez (30, 90 o 365 días), y haga clic en Crear la clave.
- Copie la clave: solo se muestra una vez. Después haga clic en He copiado la clave.
La clave empieza por tb_pk_. Abre la empresa en la que usted estaba al crearla, con sus derechos en esa empresa. Después, la lista muestra su comienzo, su acceso, su empresa, su fecha de caducidad y su último uso, nunca la clave completa.
Una clave es una contraseña
Cualquiera que tenga la clave actúa en To Bill en su nombre. No la ponga en un correo electrónico, ni en un documento compartido, ni en un repositorio de código. Una clave perdida se revoca de inmediato (véase más abajo) y se sustituye por una nueva.
Enviar la clave
Cada solicitud lleva la clave en la cabecera HTTP Authorization, como token Bearer:
curl https://app.tobill.ch/api/clients -H "Authorization: Bearer tb_pk_…"Claude Code con una clave
claude mcp add --transport http tobill https://app.tobill.ch/mcp --header "Authorization: Bearer tb_pk_…"Lo que una clave abre y lo que no abre
- Con Solo lectura, la clave solo lee: cualquier modificación se rechaza.
- Con Lectura y modificación, hace lo que usted puede hacer en la empresa, con los mismos controles que la app, y nunca más que los derechos de su rol.
- No abre el inicio de sesión en su cuenta, ni la suscripción, ni los pagos, ni la gestión de las conexiones y las claves, ni otra empresa, ni el cockpit de una fiduciaria.
- Cada modificación hecha con la clave queda registrada en la actividad de la empresa con el nombre que usted le dio.
- To Bill limita el número de solicitudes por minuto y por clave; por encima de ese límite, rechaza las solicitudes durante un rato y la herramienta debe esperar antes de volver a intentarlo.
Revocar una clave
En Configuración › Conexiones IA y API, haga clic en Revocar junto a la clave y confirme. Deja de funcionar de inmediato. Una clave caducada permanece en la lista, marcada como Caducada, hasta que usted la revoque.