--- title: Facturar desde ChatGPT o Claude: MCP Verifactu | BeeL. description: Conecta ChatGPT, Claude, Cursor o n8n al servidor MCP de BeeL. (OAuth 2.1): tu agente emite facturas Verifactu con los permisos que le das. QR y sandbox. image: https://beel.es/api/og/card?title=Facturar%20desde%20ChatGPT%20o%20Claude%3A%20MCP%20Verifactu&domain=beel.es --- Agentes # Facturas Verifactu desde ChatGPT o Claude: tu agente emite con los permisos que tú le das. Le pides a Claude o a ChatGPT la factura del pedido y sale una factura Verifactu de verdad: numerada, registrada en la AEAT, con QR y enviada. El agente solo puede hacer lo que tú le autorizas. [Crear cuenta gratis](https://app.beel.es/signup)[Ver documentación↗](https://docs.beel.es/mcp) Conectores ## Conecta el que ya usas: Claude, Cursor, ChatGPT o n8n. El servidor MCP lo alojamos nosotros: no instalas nada ni dejas una clave pegada en un fichero de configuración. Cualquier cliente MCP vale, esté en la lista o no. Empiezas en sandbox. [Ver la documentación del servidor↗](https://docs.beel.es/mcp) ### Claude Code El plugin beel-api lee el contrato en vivo, monta la integración en tu código y la verifica contra el sandbox antes de que toques producción. Claude Code 1 Añade el marketplace ›`/plugin marketplace add beel-es/claude-plugins` Copiar: Añade el marketplace/plugin marketplace add beel-es/claude-plugins 2 Instala el plugin ›`/plugin install beel-api@beel` Copiar: Instala el plugin/plugin install beel-api@beel [Ver el plugin de Claude Code](/api-verifactu/claude-code) ### Cursor Añades el servidor como cualquier otro MCP y el editor factura desde la misma conversación en la que estás escribiendo el código que cobra, contra el sandbox mientras desarrollas. mcp.jsonCopiar: mcp.jsonhttps://mcp.beel.es/mcp `https://mcp.beel.es/mcp` [Configuración por cliente↗](https://docs.beel.es/mcp) ### ChatGPT Lo añades como conector personalizado y le pides la factura hablando. ChatGPT la emite con tu cuenta, tu numeración y tu logo en el PDF, en sandbox o en Live según lo que autorices. ConectorCopiar: Conectorhttps://mcp.beel.es/mcp `https://mcp.beel.es/mcp` Ajustes → Conectores → Avanzado → Añadir conector personalizado. ### n8n El nodo verificado deja la factura dentro del workflow que ya tienes: entra el pedido, sale la factura, y el segundo nodo arranca lo que quieras cuando Hacienda responde. Nodo verificado75 operacionesNodo de eventos [Ver el nodo de n8n](/integraciones/n8n-verifactu) MCP ## ¿Qué es un servidor MCP de facturación? Un servidor MCP es el servicio al que se conecta un asistente para usar herramientas de verdad, no para describirlas. El de facturación expone la API para que el agente la ejecute en tu cuenta. Protocolo ### Para tu equipo técnico Está alojado en https://mcp.beel.es/mcp y habla Streamable HTTP con OAuth 2.1. No hay que registrar la aplicación a mano ni pegar una clave en ningún fichero, y la autorización se revoca desde tu panel. Streamable HTTPOAuth 2.1PKCERegistro dinámicoMetadata de descubrimiento Sin MCP ### Si prefieres escribir el código Las mismas facturas salen por REST y con el SDK de Node, con el mismo contrato OpenAPI y los mismos webhooks. El agente no tiene precio aparte: pagas por factura emitida en producción. [Ver la API Verifactu](/api-verifactu) La llamada ## Le pides la factura del pedido y la factura ya está emitida. El agente no redacta un PDF con pinta de factura: llama a la API y recibe la que esta emite, con su número, su hash encadenado y su QR Verifactu, ya remitida a la AEAT. [Ver el catálogo de tools↗](https://docs.beel.es/mcp/tools) Emite la factura del pedido 8841 y mándasela al cliente.mcp.beel.es La ejecución 1 Autorizar el acceso · OAuth 2.1 · registro dinámico de clientesConcedido09:11 2 Localizar al cliente · Comercial Martínez SL09:11 3 Crear la factura · beel\_create\_company\_invoice · 49,00 €Borrador09:12 4 Registrar en la AEAT · F-2026-0042Aceptada09:12 5 Avisar a tu sistema · webhooks:read09:12 Paso 4 · por dentro Permiso usado invoices:write Registro AEAT reg\_8f2c41 Huella encadenada a41f…9c02 Encadena con F-2026-0041 201 CreatedPOST /v1/invoices guardada en el registro de peticiones Empiezas en sandbox: nada tiene efecto fiscal hasta que lo decidas tú. [Crear cuenta gratis](https://app.beel.es/signup) Las tools ## Lo que tu agente puede hacer con una factura Verifactu. Cada tool pide sus permisos: el agente solo puede usar las que cubren lo que le aprobaste. El catálogo cubre la API entera, desde validar un NIF hasta emitir una rectificativa. [Ver el catálogo completo↗](https://docs.beel.es/mcp/tools) ### Validar el NIF antes de emitir Consulta el censo de la AEAT y devuelve si el NIF existe y el nombre que consta en él. El prompt guiado la llama antes de emitir, para decidir entre factura completa y simplificada. beel\_validate\_nifissue-invoiceF1F2 ### Crear y emitir la factura Crea la factura bajo el NIF que indiques y la emite: número de su serie, hash encadenado, registro en la AEAT y PDF con el QR Verifactu. El estado vuelve en la misma respuesta. beel\_create\_company\_invoicebeel\_issue\_company\_invoice ### Rectificar o anular Una factura emitida no se borra. El agente la anula o emite la rectificativa (R1 a R5), con su propia serie y su propio registro Verifactu. beel\_create\_company\_corrective\_invoicebeel\_void\_company\_invoicefix-invoice ### PDF y envío al cliente Descarga el PDF, con tu logo y el QR de cotejo de la AEAT, y lo envía por correo desde tu cuenta. En Claude y otros clientes con MCP UI se ve dentro del chat. beel\_get\_company\_invoice\_pdfbeel\_send\_company\_invoice ### Idempotencia de serie La creación de facturas lleva una clave de idempotencia estable. Si el agente reintenta por un timeout, durante 24 horas la API devuelve la factura que ya existía en vez de emitir otra. Idempotency-Key24 h ### Varios NIF, y qué le falta a cada uno Da de alta un NIF nuevo, lista los que ya tienes y comprueba de una llamada qué le falta a cada uno para emitir en Live: serie por defecto, Verifactu activado, representación ante la AEAT. beel\_create\_companybeel\_get\_setup\_statusonboard-nif Todo empieza en sandbox: autorizas al agente en entorno Test, o le das una clave beel\_sk\_test\_, y trabaja contra un sandbox idéntico a producción: el registro va a la preproducción de la AEAT, sin efecto fiscal. Gratis, sin tarjeta y sin caducidad. [Crear cuenta gratis](https://app.beel.es/signup) Si cobras con Stripe, cada cobro sale facturado solo, sin que el agente tenga que pedirlo: el conector emite la factura Verifactu, la registra en la AEAT y te avisa por webhook. [Stripe y Verifactu](/integraciones/stripe-verifactu)[API REST y SDK](/api-verifactu) Permisos ## El agente solo hace lo que hayas marcado. OAuth 2.1 con registro dinámico de clientes: autorizas la cuenta, el entorno y los permisos uno a uno, y los revocas cuando quieras. Cada petición queda guardada con la clave que la hizo. [Cómo funciona la autenticación↗](https://docs.beel.es/auth) Accesos y peticiones Accesos de tu cuenta Claude · OAuth 2.1Live invoices:writewebhooks:read Cursor · OAuth 2.1Test invoices:write beel\_sk\_test\_…4c2Test invoices:writeaccounts:read Registro de peticiones PeticiónOrigenSalida POST /v1/invoicesClaudeF-2026-0042 POST /v1/invoicesClaudeR-2026-0007 GET /v1/customersCursor18 clientes Cada petición queda guardada con la clave que la hizo, así que siempre puedes ver qué pidió tu agente y qué le contestó la API. La autorización Claude quiere acceder a tu cuentamcp.beel.es · OAuth 2.1 Permisos - invoices:writeCrear y emitir facturas - webhooks:readLeer los eventos de tu cuenta - account:adminAdministrar la cuenta y la facturación CancelarAutorizar Para agentes ## Todo lo que tu agente necesita leer está publicado. Un agente que aterriza en beel.es no tiene que adivinar nada: qué hace BeeL., cómo conseguir credenciales y el contrato entero de la API, en ficheros estables y sin registrarse. ### llms.txt El índice de la web en texto plano, con la versión completa para quien quiera leerlo todo de una vez. [/llms.txt↗](/llms.txt)[/llms-full.txt↗](/llms-full.txt) ### agents.md y auth.md Cuándo usar BeeL., cómo empezar sin hablar con nadie y cómo conseguir credenciales de sandbox, escrito para que lo ejecute una máquina. [/agents.md↗](/agents.md)[/auth.md↗](/auth.md) ### Contrato OpenAPI 3.0 Operaciones, esquemas y el scope de OAuth que pide cada una. Es la misma fuente de la que salen el SDK, la CLI y el nodo de n8n. [/openapi.json↗](/openapi.json)[/openapi.yaml↗](/openapi.yaml) ### Servidor MCP La ficha del servidor y su metadata de OAuth, para que un cliente nuevo se registre solo y descubra las tools sin que nadie le pase nada. [Server card↗](/.well-known/mcp/server-card.json)[Documentación↗](https://docs.beel.es/mcp) Preguntas frecuentes ## Lo que se pregunta antes de conectar un agente. ### ¿Puedo facturar desde ChatGPT? Sí. Añades https://mcp.beel.es/mcp como conector personalizado en ChatGPT (Ajustes → Conectores → Añadir conector personalizado), inicias sesión con tu cuenta de BeeL. y le pides la factura hablando. ChatGPT llama a beel\_create\_company\_invoice y la factura sale numerada en tu serie, registrada en la AEAT como factura Verifactu, con su QR en el PDF y enviada al cliente si se lo pides. Con Claude, Cursor o cualquier cliente MCP es el mismo servidor y la misma URL. ### ¿Qué es un servidor MCP de facturación? MCP (Model Context Protocol) es el estándar con el que un asistente de IA usa herramientas externas. Un servidor MCP de facturación expone la API de facturación como tools que el agente puede llamar: crear una factura, validar un NIF, emitir una rectificativa, descargar el PDF. El de BeeL. es remoto, lo alojamos nosotros en mcp.beel.es/mcp, habla Streamable HTTP y cubre la API entera, con los mismos controles Verifactu que la API: no hay forma de saltarse un paso fiscal desde el chat. ### ¿Cómo doy permisos a un agente? Por OAuth 2.1. Al conectar, tu cliente MCP abre la pantalla de autorización de BeeL. y ahí eliges la cuenta, el entorno (Test o Live) y los scopes, uno a uno: por ejemplo invoices:write para emitir y accounts:read para leer. Los scopes que apruebas son el techo: el agente solo puede usar las tools que esos scopes cubren, cada petición queda guardada con la clave que la hizo y revocas el acceso cuando quieras sin tocar el resto de tu integración. Para un agente autónomo sin persona delante, pasas una API key como bearer token. ### ¿Puedo llevar varias empresas o NIF con una cuenta? Sí. Una cuenta de BeeL. gestiona varios NIF, cada uno con sus series, sus clientes y su registro Verifactu aislados. El agente puede dar de alta un NIF nuevo (beel\_create\_company), comprobar con beel\_get\_setup\_status qué le falta a cada NIF para emitir en Live y facturar bajo el que toque: el company\_id va en la ruta de cada llamada. Los permisos también se conceden NIF por NIF. El detalle está en la página de multi-NIF. ### ¿Valida el NIF del cliente antes de emitir? Sí. La tool beel\_validate\_nif consulta POST /v1/nif/validate y devuelve si el NIF existe en el censo y el nombre que consta en él, y el prompt guiado issue-invoice la invoca antes de emitir. Con eso el agente sabe si toca factura completa (F1) o simplificada (F2) y no emite una factura Verifactu a un NIF que no existe. ### ¿Y si el agente se equivoca en una factura? Se corrige como se corrige la de una persona: una factura emitida no se borra, se anula (beel\_void\_company\_invoice) o se rectifica con beel\_create\_company\_corrective\_invoice, y la rectificativa sale con su propia serie (R-2026-0007) y su propio registro Verifactu. Además, si tu agente repite la misma llamada por un timeout, la Idempotency-Key devuelve durante 24 horas la factura que ya existía, así que un reintento no acaba en dos facturas ante Hacienda. ### ¿Puedo probarlo sin emitir facturas de verdad? Sí, y es lo que recomendamos. Autorizas al agente en entorno Test, o le pasas una clave con prefijo beel\_sk\_test\_, y trabaja contra un sandbox idéntico a producción: el registro va al entorno de preproducción de la AEAT, sin efecto fiscal. Es gratis, no caduca y no pide tarjeta. Pasar a real es cambiar el entorno que autorizas en la pantalla de OAuth. ### ¿Tengo que instalar o desplegar algo? No. El servidor es remoto y lo aloja BeeL. en https://mcp.beel.es/mcp: no hay paquete que instalar, ni proceso local, ni servidor que actualizar. Apuntas tu cliente MCP a esa URL, autorizas y ya está. Las tools nuevas aparecen solas conforme crece la API. Si prefieres integrarlo en tu código, la misma API está disponible por REST y con el SDK de Node. ### ¿Sirve para un agente autónomo, sin una persona delante? Sí. Pasas una API key de BeeL. como bearer token en la cabecera Authorization: el servidor habla Streamable HTTP y funciona con cualquier SDK de MCP o con HTTP directo. No incrustes la clave en el código, pásala por variable de entorno o por un gestor de secretos, y trabaja con una clave de sandbox hasta que el flujo esté cerrado. ### ¿Cuánto cuesta conectar un agente? Conectarlo no cuesta nada: el servidor MCP, el plugin de Claude Code y el nodo de n8n van incluidos con tu cuenta, y el sandbox es gratis para siempre. Pagas la API por NIF en producción, con facturas incluidas cada mes; el precio está en la página de precios. ```json {"@context":"https://schema.org","@type":"Organization","@id":"https://beel.es/#organization","name":"BeeL.","alternateName":["BeeL","BeeL.es","Beel"],"legalName":"Honey Solutions, S.L.","url":"https://beel.es","logo":{"@type":"ImageObject","@id":"https://beel.es/#logo","url":"https://beel.es/brand/logos/beel-logo-blue.png","contentUrl":"https://beel.es/brand/logos/beel-logo-blue.png","width":2118,"height":487,"caption":"Logo de BeeL."},"image":"https://beel.es/brand/logos/beel-logo-blue.png","description":"Software de facturación para España listo para Verifactu, con API para desarrolladores e integración nativa con Stripe.","email":"hola@beel.es","telephone":"+34 711 21 23 00","contactPoint":[{"@type":"ContactPoint","contactType":"customer support","email":"hola@beel.es","telephone":"+34711212300","url":"https://beel.es/contacto","availableLanguage":["es","ca","en"],"areaServed":"ES"},{"@type":"ContactPoint","contactType":"sales","email":"hola@beel.es","telephone":"+34711212300","url":"https://beel.es/ventas","availableLanguage":["es","ca","en"],"areaServed":"ES"}],"foundingDate":"2026","address":{"@type":"PostalAddress","addressLocality":"Vila-seca","addressRegion":"Tarragona","addressCountry":"ES"},"sameAs":["https://www.linkedin.com/company/beel-es","https://www.instagram.com/beel.es","https://www.tiktok.com/@app.beel.es","https://www.youtube.com/@beel_es","https://x.com/beel_es","https://github.com/beel-es"],"subjectOf":{"@type":"WebPage","url":"https://beel.es/logo","name":"Logo de BeeL."}} {"@context":"https://schema.org","@type":"Service","@id":"https://beel.es/#service","name":"Facturación Verifactu completa por API — BeeL.","serviceType":"Facturación electrónica y Verifactu (AEAT) por API y por integración con Stripe","description":"Emite facturas legales en España desde tu producto o desde tus cobros de Stripe: numeración, PDF, envío, rectificativas, varios NIFs y el registro en la AEAT, sin escribir código fiscal.","provider":{"@id":"https://beel.es/#organization"},"areaServed":{"@type":"Country","name":"España"},"audience":{"@type":"BusinessAudience","audienceType":"SaaS, marketplaces, gestorías y negocios que cobran con Stripe"},"availableChannel":[{"@type":"ServiceChannel","serviceUrl":"https://app.beel.es/api/v1","name":"API REST"},{"@type":"ServiceChannel","serviceUrl":"https://mcp.beel.es/mcp","name":"Servidor MCP"},{"@type":"ServiceChannel","serviceUrl":"https://beel.es/integraciones/stripe-verifactu","name":"Stripe Connect"}],"termsOfService":"https://beel.es/terminos","offers":{"@id":"https://beel.es/precios#api"},"url":"https://beel.es/api-verifactu"} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://beel.es/agentes#faq","name":"Agentes de IA que facturan con BeeL.","url":"https://beel.es/agentes","mainEntity":[{"@type":"Question","name":"¿Puedo facturar desde ChatGPT?","acceptedAnswer":{"@type":"Answer","text":"Sí. Añades https://mcp.beel.es/mcp como conector personalizado en ChatGPT (Ajustes → Conectores → Añadir conector personalizado), inicias sesión con tu cuenta de BeeL. y le pides la factura hablando. ChatGPT llama a beel_create_company_invoice y la factura sale numerada en tu serie, registrada en la AEAT como factura Verifactu, con su QR en el PDF y enviada al cliente si se lo pides. Con Claude, Cursor o cualquier cliente MCP es el mismo servidor y la misma URL."}},{"@type":"Question","name":"¿Qué es un servidor MCP de facturación?","acceptedAnswer":{"@type":"Answer","text":"MCP (Model Context Protocol) es el estándar con el que un asistente de IA usa herramientas externas. Un servidor MCP de facturación expone la API de facturación como tools que el agente puede llamar: crear una factura, validar un NIF, emitir una rectificativa, descargar el PDF. El de BeeL. es remoto, lo alojamos nosotros en mcp.beel.es/mcp, habla Streamable HTTP y cubre la API entera, con los mismos controles Verifactu que la API: no hay forma de saltarse un paso fiscal desde el chat."}},{"@type":"Question","name":"¿Cómo doy permisos a un agente?","acceptedAnswer":{"@type":"Answer","text":"Por OAuth 2.1. Al conectar, tu cliente MCP abre la pantalla de autorización de BeeL. y ahí eliges la cuenta, el entorno (Test o Live) y los scopes, uno a uno: por ejemplo invoices:write para emitir y accounts:read para leer. Los scopes que apruebas son el techo: el agente solo puede usar las tools que esos scopes cubren, cada petición queda guardada con la clave que la hizo y revocas el acceso cuando quieras sin tocar el resto de tu integración. Para un agente autónomo sin persona delante, pasas una API key como bearer token."}},{"@type":"Question","name":"¿Puedo llevar varias empresas o NIF con una cuenta?","acceptedAnswer":{"@type":"Answer","text":"Sí. Una cuenta de BeeL. gestiona varios NIF, cada uno con sus series, sus clientes y su registro Verifactu aislados. El agente puede dar de alta un NIF nuevo (beel_create_company), comprobar con beel_get_setup_status qué le falta a cada NIF para emitir en Live y facturar bajo el que toque: el company_id va en la ruta de cada llamada. Los permisos también se conceden NIF por NIF. El detalle está en la página de multi-NIF."}},{"@type":"Question","name":"¿Valida el NIF del cliente antes de emitir?","acceptedAnswer":{"@type":"Answer","text":"Sí. La tool beel_validate_nif consulta POST /v1/nif/validate y devuelve si el NIF existe en el censo y el nombre que consta en él, y el prompt guiado issue-invoice la invoca antes de emitir. Con eso el agente sabe si toca factura completa (F1) o simplificada (F2) y no emite una factura Verifactu a un NIF que no existe."}},{"@type":"Question","name":"¿Y si el agente se equivoca en una factura?","acceptedAnswer":{"@type":"Answer","text":"Se corrige como se corrige la de una persona: una factura emitida no se borra, se anula (beel_void_company_invoice) o se rectifica con beel_create_company_corrective_invoice, y la rectificativa sale con su propia serie (R-2026-0007) y su propio registro Verifactu. Además, si tu agente repite la misma llamada por un timeout, la Idempotency-Key devuelve durante 24 horas la factura que ya existía, así que un reintento no acaba en dos facturas ante Hacienda."}},{"@type":"Question","name":"¿Puedo probarlo sin emitir facturas de verdad?","acceptedAnswer":{"@type":"Answer","text":"Sí, y es lo que recomendamos. Autorizas al agente en entorno Test, o le pasas una clave con prefijo beel_sk_test_, y trabaja contra un sandbox idéntico a producción: el registro va al entorno de preproducción de la AEAT, sin efecto fiscal. Es gratis, no caduca y no pide tarjeta. Pasar a real es cambiar el entorno que autorizas en la pantalla de OAuth."}},{"@type":"Question","name":"¿Tengo que instalar o desplegar algo?","acceptedAnswer":{"@type":"Answer","text":"No. El servidor es remoto y lo aloja BeeL. en https://mcp.beel.es/mcp: no hay paquete que instalar, ni proceso local, ni servidor que actualizar. Apuntas tu cliente MCP a esa URL, autorizas y ya está. Las tools nuevas aparecen solas conforme crece la API. Si prefieres integrarlo en tu código, la misma API está disponible por REST y con el SDK de Node."}},{"@type":"Question","name":"¿Sirve para un agente autónomo, sin una persona delante?","acceptedAnswer":{"@type":"Answer","text":"Sí. Pasas una API key de BeeL. como bearer token en la cabecera Authorization: el servidor habla Streamable HTTP y funciona con cualquier SDK de MCP o con HTTP directo. No incrustes la clave en el código, pásala por variable de entorno o por un gestor de secretos, y trabaja con una clave de sandbox hasta que el flujo esté cerrado."}},{"@type":"Question","name":"¿Cuánto cuesta conectar un agente?","acceptedAnswer":{"@type":"Answer","text":"Conectarlo no cuesta nada: el servidor MCP, el plugin de Claude Code y el nodo de n8n van incluidos con tu cuenta, y el sandbox es gratis para siempre. Pagas la API por NIF en producción, con facturas incluidas cada mes; el precio está en la página de precios."}}]} ```