Conectar Fube por API o por MCP (ChatGPT, Claude, VS Code)

Fube guarda tus clientes, tus facturas y tus gastos, pero rara vez tu negocio vive solo en Fube: tienes una web que recoge contactos, un script que cuadra números a fin de mes o un asistente de IA con el que ya trabajas todo el día. Conectar esas piezas a Fube te ahorra reescribir datos a mano y errores de copiar y pegar. Hay dos caminos, y esta guía te explica cuál te encaja y cómo montarlo: la clave API, para tus propias apps y scripts, y el servidor MCP con OAuth, para enlazar ChatGPT, Claude o VS Code sin darles nunca tu contraseña.

Antes de empezar: ¿clave API o MCP?

No son lo mismo, y elegir bien te evita disgustos:

• Clave API. Es una credencial fija —un token largo— que tú generas y pegas en tu propia herramienta: tu web, tu ERP, un script. Da acceso completo a la cuenta, así que úsala solo con herramientas que controlas tú. Es la vía directa para automatizar sin intermediarios.
• Servidor MCP con OAuth. Es el camino recomendado cuando quien se conecta es un asistente de IA o una app de terceros (ChatGPT, Claude Desktop, la extensión de VS Code). En lugar de un token fijo, la herramienta recibe un permiso temporal que tú autorizas de forma explícita y que caduca solo; tu contraseña nunca viaja.

La regla rápida: si el código lo escribes tú, clave API. Si conectas una IA o una app ajena, MCP con OAuth. Ambas vías están en Configuración › Avanzado y las dos van con el acceso por API, que es del plan Elite: las claves API y también los clientes OAuth con los que se conectan los asistentes. Si tu plan no lo incluye, en lugar de la pantalla verás una tarjeta para mejorar de plan. Lo tienes en precios.

Parte 1 — Crear una clave API

Paso 1 — Genera la clave

Ve a Configuración › Avanzado › API Keys y pulsa Crear API Key. Si tu plan no es Elite, ahí es donde te encontrarás la tarjeta de mejora en lugar del listado. Con el plan puesto, se abre Crear nueva API Key con estos campos:

• Un nombre descriptivo (por ejemplo, "Web corporativa" o "Script de facturación"). La buena práctica es una clave por integración: así, si una deja de hacer falta, la revocas sin tocar el resto.
• Una fecha de caducidad, obligatoria: posterior a hoy y, como mucho, dentro de un año. A partir de ese día la clave deja de autenticar. No se puede crear una clave que no caduque, porque una clave sin fecha es una puerta abierta para siempre: apúntate cuándo vence para crear la siguiente antes.
• Permisos (opcional). Si eliges algunos, la clave sólo podrá eso, y nunca más que tú. Vacío, puede todo lo que puedas tú, así que conviene acotarla a lo que la integración necesite.
• IPs permitidas (opcional). Si tu integración corre siempre desde el mismo servidor, escribe sus direcciones o rangos, uno por línea, y desde cualquier otro sitio la clave no valdrá.
• Un código de verificación. Pulsa Enviar código y teclea el de seis dígitos que te llega al correo de tu cuenta; si tienes la verificación en dos pasos con app, puedes elegir App de autenticación y usar el de tu app. Una clave API actúa en tu nombre sin contraseña, así que Fube no deja crearla sólo con tener la sesión abierta.

Paso 2 — Cópiala: solo se muestra una vez

Al crearla, Fube genera una clave con el formato fube_ seguido de una cadena larga (64 caracteres hexadecimales). Esa clave se enseña una única vez, en ese momento. Fube guarda solo un hash, así que no puede volver a mostrártela: cópiala y guárdala en un gestor de secretos antes de cerrar el diálogo. Si la pierdes, no se recupera; tendrías que crear una nueva y actualizar la integración.

Paso 3 — Úsala en tus peticiones

Tu herramienta envía la clave en cada petición HTTP mediante la cabecera X-API-Key. Un ejemplo con curl sería:

curl https://fube.es/api/invoices \
  -H "X-API-Key: tu_clave_api_aqui"

A partir de ahí, tu app puede consultar, crear o sincronizar en tu nombre de forma programática: puede lo mismo que podrías hacer tú en la aplicación, dentro de los permisos que le hayas dado a la clave.

Paso 4 — Vigila y revoca

El listado enseña cada clave con su nombre, hasta cuándo es válida («Válida hasta» y la fecha, o Expirada en rojo si ya pasó) y su último uso («Nunca» si no se ha usado). El último uso es tu radar: delata las claves dormidas que nadie llama desde hace meses y que conviene limpiar. En su menú, Ver información añade la fecha de creación y el estado. Cuando una clave ya no se use o sospeches que se ha filtrado, abre su menú y pulsa Eliminar API Key. La baja es inmediata e irreversible: cualquier integración que la usara deja de funcionar al instante.

Tienes el detalle de esta función en API y claves.

Parte 2 — Conectar por MCP con OAuth

El servidor MCP de Fube deja que un asistente externo llame a herramientas concretas de tu cuenta —consultar clientes y facturas, crear documentos— a través de un estándar abierto. La autorización va por OAuth 2.1 con PKCE: tú apruebas el acceso desde Fube y la herramienta recibe un permiso temporal, nunca tu contraseña.

Paso 1 — Crea un cliente OAuth

Ve a Configuración › Avanzado › Clientes OAuth y pulsa Crear cliente OAuth. El formulario tiene estos campos:

• Nombre del cliente. Un nombre para reconocerlo, como "Claude Desktop" o "VS Code".
• Redirect URIs. Las URLs a las que la herramienta puede redirigir tras autorizar. Cada herramienta te indica la suya (por ejemplo, ChatGPT usa una URL de redirección propia que copias de su configuración). Puedes añadir varias.
• Scopes. Los permisos de identidad que solicita el cliente. Por defecto viene openid profile email, y en la práctica es lo que necesitas: son los scopes OIDC de identidad; déjalo con el valor por defecto salvo que la herramienta te pida otra cosa.
• Permisos (opcional). Acota a qué puede llegar la herramienta: si eliges permisos, sólo podrá lo que digan ellos, y nunca más que el usuario que la conecte. Vacío, puede lo mismo que ese usuario.
• IPs permitidas (opcional). Si la herramienta se conecta siempre desde las mismas direcciones, limítalo a ellas. Vacío, desde cualquier sitio.

Al guardarlo, Fube genera un Client ID: es lo que pegarás en la herramienta, y no es secreto. Si al crearlo ves también un Client Secret, no lo necesitas: Fube no lo usa, porque la conexión se protege con PKCE: la herramienta demuestra, al recoger el permiso, que es la misma que lo pidió.

Paso 2 — Copia la URL del servidor MCP

En la misma pantalla, Fube te muestra la URL del servidor MCP de tu cuenta y las instrucciones paso a paso para cada herramienta, en tres pestañas: ChatGPT, Claude Desktop y Visual Studio Code. La URL termina en /sse sobre el dominio de tu Fube. Esa URL, junto al Client ID, es todo lo que necesitas para configurar la herramienta.

Paso 3 — Configura tu asistente

Con el Client ID y la URL del servidor MCP a mano, ve a la herramienta:

• ChatGPT. En Ajustes › Conectores (con el modo desarrollador activado), crea una aplicación con la URL del servidor MCP, autenticación OAuth y tu Client ID; el campo del client secret, déjalo vacío. Recuerda haber puesto en el cliente OAuth la Redirect URI que ChatGPT indica.
• Claude Desktop. Añade el servidor MCP de Fube a tu configuración de mcpServers apuntando a la URL del servidor. La pantalla de Fube trae el bloque exacto listo para copiar.
• Visual Studio Code. Instala una extensión que soporte MCP y configura el servidor con la URL de Fube.

En todos los casos, las instrucciones concretas y el texto a copiar están en la propia pantalla de Clientes OAuth, para que no tengas que recordarlas.

Paso 4 — Autoriza desde Fube

La primera vez que la herramienta se conecta, te lleva a Fube para que apruebes el acceso (si no tienes la sesión abierta, antes te pide entrar). Decides tú: el asistente no entra hasta que confirmas.

Fube abre la pantalla Conectar «nombre del cliente» a tu cuenta, que te dice tres cosas antes de que aceptes: qué aplicación pide conectarse, qué podrá hacer —lo mismo que tú o, si el cliente tiene permisos elegidos, sólo esos— y a qué dirección volverás al confirmar. Si no has empezado tú esta conexión, no sigas: pulsa Cancelar.

Para confirmar, la pantalla pide un código de verificación: pulsa Enviar código y teclea el de seis dígitos que te llega al correo de tu cuenta. Si tienes la verificación en dos pasos con app, puedes elegir App de autenticación y usar el de tu app. Pulsa Conectar y vuelves a la herramienta, ya enlazada. Es lo mismo que te pide crear una clave API, y por la misma razón: tener tu sesión abierta no basta para sacar un acceso que funciona en tu nombre.

Se hace una vez por conexión: a partir de ahí, la herramienta renueva su permiso sola, sin volver a pedirte el código, hasta que la desconectes (paso 5). Si un día la quitas y la vuelves a conectar, te lo pedirá otra vez.

Si trabajas en varias empresas, conecta con la misma en la que se creó el cliente OAuth. Si entras con otra, la pantalla dice No se puede conectar esta aplicación y te explica que no está dada de alta en la empresa con la que has entrado: cambia a la empresa correcta dentro de Fube y vuelve a conectar desde la herramienta.

Y conviene dimensionar bien lo que le estás abriendo, porque no es una ventanita de consulta. El servidor MCP de Fube expone cerca de doscientas herramientas repartidas en catorce áreas de la aplicación —facturación, clientes y CRM, gastos, catálogo, datos de empresa, analítica e informes, tesorería, proyectos, control horario, ajustes, maestros, base de conocimiento, agente de IA y soporte—, y no son sólo de lectura: también crean y modifican documentos y fichas. Tu asistente puede leer y escribir prácticamente en cualquier rincón de tu cuenta.

Eso es justamente lo que lo hace útil, pero también la razón de conectar sólo herramientas en las que confías, y de que exista el paso 5.

Tienes el recorrido completo en MCP y OAuth.

Paso 5 — Cortar el acceso

El cliente OAuth es inmutable: una vez creado, no se edita. Desde su menú solo puedes Ver información (nombre, Client ID, estado, redirect URIs, scopes y fecha) o Eliminar cliente. Si necesitas cambiar el nombre o las URLs de redirección, la vía es eliminar el cliente y crear uno nuevo.

Borrar el cliente corta el acceso de lo que ya está conectado con él. En su siguiente petición, la herramienta se encuentra con que sus permisos ya no valen y no puede renovarlos: queda desconectada. Si quieres volver a usarla, crea un cliente nuevo y conéctala otra vez.

Hay otra forma de desconectar, que actúa sobre tu cuenta y no sobre un cliente: en Mi perfil › Seguridad, la tarjeta Dispositivos y accesos tiene el botón Cerrar las demás sesiones. Cierra la sesión de todos tus navegadores menos el que estás usando y desconecta también todas las aplicaciones que hayas conectado con tu usuario (ChatGPT, Claude, VS Code…), de cualquier cliente: dejan de poder renovar su permiso, y el que tengan en ese momento caduca como mucho en un cuarto de hora. Se confirma con el mismo código del correo o de tu app, y las aplicaciones tendrán que volver a conectarse. Quitar un solo navegador de esa lista, en cambio, no toca las aplicaciones.

Si sospechas que alguien ha conectado una herramienta que no debía, bórrala así y cierra las demás sesiones. Y si además crees que tienen tu contraseña, cámbiala: eso cierra todas las sesiones y los permisos de renovación de ese usuario, también los de cualquier aplicación conectada con él. Es una llave gorda —esa persona tendrá que volver a entrar en todas partes—, y por eso conviene autorizar las integraciones con un usuario pensado para ello y no con el que usas a diario.

Casos límite y errores comunes

• Perdí la clave API. No se recupera: Fube solo guarda un hash y la muestra una única vez. Genera una clave nueva y actualiza la integración. El Client ID de un cliente OAuth no se pierde: no es secreto y lo ves siempre en Ver información.
• Quiero "editar" un cliente OAuth. No se puede: es inmutable. Elimínalo y crea otro con los datos correctos.
• Busco la opción "Revocar" en OAuth. No hay un botón aparte porque no hace falta: eliminar el cliente es la revocación, y corta en su siguiente petición a las herramientas conectadas con él. Y para desconectar de golpe todo lo que has conectado tú, Cerrar las demás sesiones. Los dos, en el paso 5.
• Al conectar, Fube dice "No se puede conectar esta aplicación". Lee el motivo que da debajo. Si dice que la aplicación no está dada de alta en tu empresa, has entrado con otra empresa distinta de la del cliente OAuth: cambia de empresa y vuelve a conectar. Si dice que tu plan no incluye conectar asistentes, es el acceso por API del plan Elite. Y si dice que la petición no es válida, vuelve a la herramienta y empieza la conexión de nuevo.
• No me llega el código al conectar. Mira en la carpeta de correo no deseado; a los 30 segundos puedes pulsar Reenviar código, y vale el último que te llegue. Con la 2FA por app, también puedes usar el código de la app.
• En lugar de las API Keys o de los Clientes OAuth veo una tarjeta de mejora. Es lo normal fuera del plan Elite: las dos cosas van con el acceso por API, que es de ese plan.
• Mi integración ha dejado de funcionar de un día para otro. Mira la clave en el listado: si pone Expirada, ha llegado a su fecha de caducidad y ya no autentica. No se puede alargar: crea una nueva y cámbiala en la integración. Para que no te pille, crea la siguiente unos días antes de que venza la anterior.
• Una clave antigua pone "No expira". Son claves creadas antes de que la caducidad fuera obligatoria. Siguen funcionando, pero conviene sustituirlas por una con fecha y eliminarlas.
• No me deja poner la fecha que quiero. La caducidad tiene que ser posterior a hoy y como mucho a un año vista; el calendario no deja elegir fuera de ese margen.
• No encuentro las pantallas. Ambas viven bajo Configuración › Avanzado: "API Keys" y "Clientes OAuth". Si tu rol no tiene permisos de administración, es posible que no veas la opción de crear.

Preguntas frecuentes

¿La clave API tiene permisos limitados? Si quieres, sí: al crearla puedes elegir sus permisos, y entonces sólo podrá eso (nunca más que tú). Si no eliges ninguno, puede lo mismo que tú.

¿Puedo restringir una clave o un cliente por dirección IP? Sí. Las claves API y los clientes OAuth tienen un campo de IPs permitidas: si lo rellenas, sólo funcionan desde esas direcciones o rangos. Y para cortar un acceso, en los dos casos basta con borrarlo: la clave deja de autenticar al instante y el cliente OAuth desconecta la herramienta en su siguiente petición.

¿Mi contraseña llega al asistente de IA? No. Ese es el sentido de OAuth: la herramienta recibe un permiso que tú autorizas de forma explícita, y tu contraseña nunca sale de Fube. Eso sí, que el permiso sea temporal no significa que se apague solo con el tiempo: se renueva mientras la integración siga viva. Para retirarlo hay que hacerlo a mano, como se explica en "Cortar el acceso".

¿Los scopes controlan a qué datos accede la IA? No: los scopes del cliente OAuth (openid profile email) son de identidad OIDC. Lo que acota a qué llega el asistente es el campo Permisos del cliente: con permisos elegidos, sólo puede eso; sin ellos, alcanza lo mismo que el usuario que lo conectó, con todo el catálogo de herramientas del servidor MCP.

¿Esto afecta a Verifactu o a mis obligaciones fiscales? No directamente. API y MCP son formas de conectar herramientas; el cumplimiento de Verifactu lo sigue garantizando Fube al emitir las facturas, las cree quien las cree. Una factura generada por tu asistente pasa por el mismo flujo conforme —firma, encadenamiento y QR— que una creada a mano. Si quieres, repasa empezar con Verifactu.

¿Necesito saber programar para usar el MCP? Para conectar ChatGPT, Claude Desktop o VS Code, no: la pantalla de Clientes OAuth trae las instrucciones de cada herramienta y todo se reduce a copiar y pegar el Client ID y la URL del servidor. La clave API sí está pensada para integraciones que programas tú.

Conecta Fube con tu stack

Tienes dos caminos y ninguno te pide compartir la contraseña: la clave API para tus propias apps —genérala, cópiala una vez y úsala con la cabecera X-API-Key— y el servidor MCP con OAuth para enlazar tu asistente de IA de confianza sin intermediarios. Los dos viven en Configuración › Avanzado y los dos van con el plan Elite. Y antes de conectar nada, ten clara la salida: borrar el cliente OAuth desconecta la herramienta en su siguiente petición. Crea tu cuenta gratis y, con el plan Elite, conecta tu primera herramienta en unos minutos. Cuando quieras profundizar, tienes el detalle de API y claves y de MCP y OAuth.