Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Quaderno con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Gestiona impuestos y facturas de Quaderno desde tu IA: calcula sales tax, IVA y GST para cualquier ubicación, valida números de IVA, busca contactos, facturas, notas de crédito, presupuestos, gastos y productos, emite y envía facturas por correo y solicita informes fiscales.
Prueba a pedir
Prompts de ejemplo para Quaderno
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Quaderno, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Quaderno + ChatGPT
Gestiona impuestos y facturas de Quaderno desde tu IA: calcula sales tax, IVA y GST para cualquier ubicación, valida números de IVA, busca contactos, facturas, notas de crédito, presupuestos, gastos y productos, emite y envía facturas por correo y solicita informes fiscales.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
Paso 1 — Obtener credenciales
- Inicia sesión en
https://quadernoapp.comy abre Profile → API keys (https://quadernoapp.com/users/api-keys). - Copia la clave privada, que empieza por
sk_, enQUADERNO_API_KEY. La clave publicable (pk_) no sirve aquí. La clave se envía como nombre de usuario de HTTP Basic con la contraseña vacía, solo a tu cuenta de Quaderno. - La misma página muestra tu URL de API, por ejemplo
https://acme-1234.quadernoapp.com/api/. Pon la parte anterior a.quadernoapp.com(aquíacme-1234) enQUADERNO_ACCOUNT_NAMEe instala el conector. - Comprueba la configuración con
quaderno_ping: confirma la clave y muestra las peticiones que quedan en la ventana actual.
Las facturas se emiten y se envían solo tras tu sí: una factura emitida es un documento fiscal. Quaderno la numera de forma correlativa y no se puede borrar, solo anular o rectificar con una nota de crédito en la app de Quaderno. Antes de quaderno_create_invoice, la IA te muestra el cliente, las líneas, los precios y la moneda. Antes de quaderno_deliver_invoice, que envía la factura al cliente por correo al instante y no se puede deshacer, te dice qué factura va a qué dirección. quaderno_create_contact y quaderno_request_report también preguntan antes. Crear una factura no la envía. quaderno_delete_contact se instala desactivada.
Cálculo de impuestos: quaderno_calculate_tax devuelve el sales tax, el IVA o el GST de una venta a cualquier ubicación: nombre del impuesto, tipo, cuota, base y total, la jurisdicción hasta el nivel de ciudad y avisos como la inversión del sujeto pasivo para un número de IVA de la UE válido. Solo calcula y no registra nada. quaderno_validate_tax_id comprueba un número de IVA o de empresa en el registro oficial de su país (VIES de la UE, Reino Unido, Suiza, Quebec, Australia, Nueva Zelanda).
Qué lee: contactos, facturas, notas de crédito, presupuestos (Quaderno los llama proformas), gastos, productos, jurisdicciones fiscales y códigos fiscales. Los informes fiscales (impuestos recaudados por jurisdicción para tus declaraciones, una lista de facturas o una lista de notas de crédito) se generan en segundo plano: la IA solicita uno para un periodo, lo consulta hasta que está listo y te da el enlace de descarga.
Datos sensibles: las facturas y los contactos contienen nombres, direcciones y números fiscales de tus clientes, y son registros fiscales. Compártelos solo con quienes llevan la facturación.
Importes: los campos que terminan en _cents están en céntimos (12345 es 123,45); los precios y los resultados del cálculo de impuestos están en la unidad de la moneda.
Límite de peticiones: 100 llamadas cada 15 segundos. Un 429 significa esperar a que se reinicie la ventana.
Errores frecuentes: 401 Wrong API key or the user does not exist: la clave es incorrecta, es la clave pk_ o pertenece a otra cuenta distinta de QUADERNO_ACCOUNT_NAME. 406: un valor no válido, como un código fiscal desconocido. 422: el documento no se puede crear así, por ejemplo sin líneas.
No incluido: modificar, anular o marcar facturas como incobrables, registrar pagos, recibos, documentos recurrentes, transacciones, sesiones de checkout y cupones, evidencias, webhooks, el Sandbox y las cuentas de Quaderno Connect.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Quaderno. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
quaderno_ping | Check that the API key works and see the requests left in the current rate-limit window |
quaderno_list_contacts | List or search customers and suppliers (contacts) by name, email or tax id: id, kind (person or company), name, email, tax id and tax… |
quaderno_get_contact | Get one contact with full address, phone, website, language, default discount, notes and the link to their billing area |
quaderno_create_contact | Create a customer or supplier contact |
quaderno_delete_contact | Delete one contact for good |
quaderno_list_invoices | List or search invoices by number, customer name or PO number, issue date range, state or customer: id, number, dates, state (outstanding… |
quaderno_get_invoice | Get one invoice in full: customer and billing address, line items with their taxes, the tax breakdown, payments, deliveries, alerts, the… |
quaderno_create_invoice | Issue a new invoice |
quaderno_deliver_invoice | Email an invoice to its customer from Quaderno, with the PDF and the link to it |
quaderno_list_credit_notes | List or search credit notes (refunds and corrections of invoices) by number, customer name or PO number, issue date range or state: id… |
quaderno_get_credit_note | Get one credit note in full: customer, line items, tax breakdown, payments, deliveries, the related invoice, the public link and the PDF… |
quaderno_list_quotes | List or search quotes (Quaderno calls them proformas; they replaced estimates) by number, customer name or PO number, issue date range… |
quaderno_get_quote | Get one quote (proforma) in full: customer, line items, tax breakdown, validity, the public link and the PDF link |
quaderno_list_expenses | List or search expenses (purchase invoices from suppliers) by number, supplier name or PO number, issue date range, state or supplier: id… |
quaderno_list_products | List or search products (items) by name or code: id, code, name, description, unit cost, currency, kind (one-off or subscription), product… |
quaderno_calculate_tax | Calculate the sales tax, VAT or GST for a sale to a customer location: tax name, rate, taxable part, tax amount, subtotal and total, the… |
quaderno_validate_tax_id | Check a business tax id against the official registry of its country (EU VIES, UK, Switzerland, Quebec, Australia, New Zealand): returns… |
quaderno_list_tax_jurisdictions | List the tax jurisdictions Quaderno knows, optionally for one country or region: id, name, country and region |
quaderno_list_tax_codes | List the tax codes products can be classified with (e.g. eservice, saas, ebook, consulting, standard, reduced, exempt): id, name and what… |
quaderno_list_reports | List the reports requested so far: id, type (tax_summary, invoices_list, credits_list), state, period, when it completed and the download… |
quaderno_request_report | Ask Quaderno to build a report for a period: tax_summary (taxes collected per jurisdiction, for filing returns), invoices_list or… |
quaderno_get_report | Check one report request: state (pending, suceeded or failed), period, when it completed and the report_url to download it once ready |
Ejemplos de prompts
- "¿Qué IVA se aplica a una suscripción SaaS de 49 EUR vendida a un particular en Lyon, Francia? ¿Y a una empresa de allí con un número de IVA válido?"
- "¿Es válido el número de IVA DE123456789?"
- "¿Qué facturas siguen pendientes o vencidas y cuánto suman por moneda?"
- "Emite una factura a Northwind GmbH por 10 horas de consultoría a 120 EUR la hora. Enséñamelo todo antes de crearla y no la envíes todavía."
- "Solicita un informe de resumen fiscal del tercer trimestre y dame el enlace de descarga cuando esté listo."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
¿Te ha sido útil esta guía?
