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.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
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 + Claude
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 Claude
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.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Quaderno, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
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 con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
¿Te ha sido útil esta guía?
