Conectar Claude, ChatGPT y otros agentes de IA

Ver como Markdown Abrir en ChatGPT Abrir en Claude

OneBooks ejecuta un servidor MCP (Model Context Protocol) para que los agentes de IA que ya usas puedan trabajar con tus libros: obtener informes, consultar registros, buscar en esta documentación y preparar documentos que tú confirmas. Reciben exactamente las mismas herramientas que el asistente de la aplicación, con la misma regla: no se escribe nada hasta que una persona lo aprueba.

Elige tu cliente

Claudeclaude.ai y la aplicación de escritorio de Claude Claude CodeEl agente en tu terminal ChatGPTWeb y aplicación de escritorio, con el modo de desarrollador OpenClawTu propio agente siempre activo

Cursor, VS Code, MCP Inspector y los agentes personalizados se conectan de la misma forma: consulta la sección sobre otros clientes MCP más abajo.

Qué necesitas

Una cuenta de OneBooks. El agente hereda tu rol: un espectador recibe herramientas de solo lectura, un miembro puede proponer documentos y solo un propietario o administrador puede proponer pagos.
Claude y ChatGPT llegan a OneBooks desde sus propios servidores; Claude Code y OpenClaw se conectan desde tu ordenador. En ambos casos el cliente inicia sesión a través de la pantalla de consentimiento que se describe a continuación, nunca con una clave copiada.

Aprobar el acceso

La primera vez que un cliente se conecta, OneBooks abre su pantalla de inicio de sesión y consentimiento.

Inicia sesión con tu correo y contraseña de OneBooks si aún no lo has hecho.
Comprueba la empresa que aparece en la pantalla: el acceso se concede solo para tu empresa activa.
Revisa lo que la app podrá hacer y selecciona Aprobar (o Denegar).

Cambiar tu empresa activa en OneBooks termina la conexión; vuelve a conectar y da tu consentimiento para la nueva empresa.

Claude

Claude en la web y Claude Desktop

Los conectores personalizados están disponibles en todos los planes de Claude (el plan gratuito permite uno). Claude se conecta a OneBooks desde los servidores de Anthropic, así que un conector añadido una vez funciona igual en el navegador y en Claude Desktop.

Abre Personalizar → Conectores. En los planes Team y Enterprise lo añade un propietario en Configuración de la organización → Conectores → Añadir → Personalizado; después los miembros seleccionan Conectar.
Selecciona Añadir conector personalizado, llámalo OneBooks e introduce https://api.getonebooks.com/mcp. Deja vacíos los campos avanzados de OAuth: Claude se registra solo.
Selecciona Conectar y aprueba el acceso en la pantalla de OneBooks.
En un chat, abre el menú +, elige Conectores y activa OneBooks. Luego pregunta: “¿Cuál es mi posición de efectivo?”

Claude Code

Registra el servidor una vez para todos tus proyectos y después inicia sesión desde el panel /mcp:

claude mcp add --transport http onebooks --scope user https://api.getonebooks.com/mcp

Dentro de Claude Code ejecuta /mcp, elige onebooks y completa el inicio de sesión en el navegador. claude mcp list muestra la conexión y claude mcp remove onebooks la elimina. Claude Code se identifica con un documento de metadatos de cliente, así que no hay nada que registrar.

ChatGPT

ChatGPT en la web y en la aplicación de escritorio

Los servidores MCP personalizados en ChatGPT necesitan el modo de desarrollador, disponible en los planes Plus, Pro, Business, Enterprise y Edu (puede que un administrador del espacio de trabajo tenga que permitirlo antes). Configúralo una vez en la web; el conector pertenece a tu cuenta de ChatGPT.

Abre Configuración → Aplicaciones (llamado Conectores en algunos planes), luego Configuración avanzada, y activa el modo de desarrollador.
Selecciona Crear, llámalo OneBooks, introduce https://api.getonebooks.com/mcp, elige OAuth como autenticación y confirma que confías en el proveedor.
Aprueba el acceso en la pantalla de OneBooks.
En un chat nuevo selecciona + → Más → Modo de desarrollador, activa OneBooks para esa conversación y pregunta lo que quieras.

Sin el modo de desarrollador, ChatGPT solo usa dos herramientas de solo lectura, search y fetch, que encuentran y citan tus facturas, compras, clientes, proveedores y artículos, por ejemplo en la investigación en profundidad. Los informes y los borradores necesitan el modo de desarrollador.

OpenClaw

OpenClaw es un agente personal de código abierto que se ejecuta en tu propio equipo y habla contigo a través de tus aplicaciones de mensajería.

Abre Configuración → MCP, selecciona Añadir servidor, llámalo onebooks, elige el transporte Streamable HTTP e introduce https://api.getonebooks.com/mcp.
Establece la autenticación del servidor en OAuth (la entrada de configuración se muestra más abajo).
Ejecuta openclaw mcp login onebooks. El navegador abre la pantalla de consentimiento de OneBooks y OpenClaw guarda los tokens; si el navegador no puede llegar al retorno de llamada de OpenClaw, usa el comando --code que imprime.
openclaw mcp status --verbose confirma la conexión.

En el archivo de configuración de OpenClaw, la entrada del servidor queda así:

{
  mcp: {
    servers: {
      onebooks: {
        url: "https://api.getonebooks.com/mcp",
        transport: "streamable-http",
        enabled: true,
        auth: "oauth",
      },
    },
  },
}

Otros clientes MCP

Cualquier cliente compatible con Streamable HTTP y OAuth 2.0 con PKCE puede conectarse: Cursor, VS Code, Windsurf, MCP Inspector o agentes personalizados. Cuando el cliente usa un archivo de configuración, la entrada es:

{
  "mcpServers": {
    "onebooks": { "type": "http", "url": "https://api.getonebooks.com/mcp" }
  }
}

El cliente descubre el servidor de inicio de sesión, se registra (o presenta su documento de metadatos de cliente) y abre la pantalla de consentimiento.

Qué puede hacer el agente

Exactamente lo mismo que el asistente de la aplicación: informes y consultas, respuestas basadas en esta documentación y propuestas de facturas, compras, gastos, pagos, clientes y proveedores.

Aquí la escritura también tiene dos pasos. El agente pide a OneBooks que prepare el documento; OneBooks guarda una propuesta y devuelve una vista previa que el agente te muestra. Solo después de que apruebes esa vista previa exacta el agente confirma la propuesta: nunca en el mismo turno, una sola vez y dentro de 24 horas. Cada propuesta aparece también en el asistente de la aplicación, donde puedes confirmarla o cancelarla tú mismo. No existen herramientas de eliminación, anulación, edición ni reembolso para ningún agente.

Gestionar y revocar el acceso

Aplicaciones → Aplicaciones con el filtro Aplicaciones muestra los clientes de IA conectados a tu empresa, cada uno con su nombre y su marca, la fecha de autorización y el último uso.

La página Aplicaciones filtrada por aplicaciones conectadas, con las tarjetas de Claude y ChatGPT

Selecciona una tarjeta para ver lo que la app puede hacer y para Revocar acceso. Sus tokens dejan de funcionar de inmediato; nada de lo que ya creó se elimina.

El panel de la app conectada Claude con sus permisos y el botón Revocar acceso

Límites

120 solicitudes por minuto por dirección, un límite semanal de llamadas por empresa y la asignación semanal compartida de créditos. Consulta Créditos y límites.

Solución de problemas

La pantalla de consentimiento muestra la empresa equivocada — cambia primero tu empresa activa en OneBooks y vuelve a conectar.
El cliente dejó de funcionar después de cambiar de empresa — es lo esperado; vuelve a conectar y da tu consentimiento para la nueva empresa.
Faltan herramientas — un espectador solo recibe herramientas de lectura, los pagos necesitan un propietario o administrador, y ChatGPT necesita el modo de desarrollador para todo lo que vaya más allá de search y fetch.
El agente informa de que se agotaron los créditos — la asignación se renueva cada semana; consulta Créditos y límites.
OpenClaw no muestra nada después de Aprobar — el navegador no pudo llegar a su retorno de llamada local; ejecuta el comando --code impreso en la terminal.

Para desarrolladores

¿Construyes tu propio cliente MCP o una integración? La documentación para desarrolladores en developer.getonebooks.com cubre OAuth, los ámbitos, el registro dinámico, los documentos de metadatos de cliente y la referencia de la API.

Relacionado

Seguridad, privacidad y límites

Aplicaciones conectadas y OAuth

¿Te resultó útil esta página?No, cuéntanos por qué