QuickBooks Online a MCP: Pilota QuickBooks Online desde cualquier agente IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → QuickBooks Online, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

QuickBooks Online

Deja que tu IA trabaje con QuickBooks Online: consulta clientes, proveedores, productos y servicios, facturas, facturas de proveedores, pagos y cuentas, lee registros individuales, genera informes de pérdidas y ganancias, balance y antigüedad de cuentas por cobrar y por pagar, y crea clientes y facturas. Inicio de sesión con OAuth de Intuit, en una empresa de sandbox o de producción.

Configuración

1. Inicia sesión en developer.intuit.com, abre My Hub → App dashboard → Create an app, elige QuickBooks Online and Payments y selecciona el scope com.intuit.quickbooks.accounting.
2. En Settings → Redirect URIs, añade https://cloud.anythingmcp.com/api/mcp-oauth/callback para Development y, más adelante, para Production. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir exactamente.
3. Copia el Client ID y el Client Secret de Keys & credentials en QBO_CLIENT_ID y QBO_CLIENT_SECRET. Las claves de desarrollo solo funcionan con empresas de sandbox. Las claves de producción funcionan con empresas reales; Intuit las concede tras una breve evaluación de la app (un cuestionario en el panel de la app).
4. Busca el realm id de la empresa (Company ID): en QuickBooks, haz clic en el icono del engranaje, abre Account and settings → Billing & subscription y copia el Company ID sin espacios. Para una empresa de sandbox, está en el sitio para desarrolladores, en Sandboxes. Pégalo en QBO_REALM_ID.
5. Pon en QBO_API_URL el valor https://quickbooks.api.intuit.com para una empresa real o https://sandbox-quickbooks.api.intuit.com para una empresa de sandbox. Debe corresponder a las claves: claves de desarrollo con la URL de sandbox, claves de producción con la URL de producción.
6. Instala el conector, haz clic en Authorize with Provider en la página del conector, inicia sesión en Intuit y conecta esa misma empresa.
7. Empieza con qbo_get_company_info y comprueba el nombre de la empresa antes de que la IA lea o escriba nada. Un conector trabaja con una sola empresa; para una segunda empresa, vuelve a instalarlo.

Mantener la sesión iniciada: los access tokens duran una hora y se renuevan automáticamente. Un refresh token que no se usa durante 100 días caduca, y toda autorización termina como muy tarde a los 5 años. Después de eso, o si la app se desconecta en QuickBooks, vuelve a hacer clic en Authorize with Provider. No uses la misma app de Intuit en otra herramienta al mismo tiempo: Intuit sustituye el refresh token aproximadamente una vez al día, y una de las dos se quedaría con uno antiguo.

Permisos y solo lectura: el scope com.intuit.quickbooks.accounting da acceso de lectura y escritura a los datos contables, hasta donde lo permita el rol del usuario de QuickBooks que inicia sesión. Intuit no tiene un scope contable de solo lectura. Para una configuración de solo lectura, inicia sesión con un usuario cuyo rol no pueda crear transacciones y desactiva qbo_create_customer, qbo_update_customer y qbo_create_invoice.

Desactivadas al instalar: qbo_send_invoice, que envía por correo una factura al cliente en nombre de tu empresa, y qbo_delete_invoice. Actívalas solo si la IA debe enviar o eliminar facturas.

Las facturas se contabilizan al instante: QuickBooks no tiene facturas en borrador. Una factura que crea la IA aumenta el saldo del cliente y aparece en los informes de inmediato, pero no se envía por correo. Los clientes no se pueden eliminar, solo desactivar.

Nombres de clientes: el nombre para mostrar de un cliente debe ser único entre clientes, proveedores y empleados, y no puede contener dos puntos (QuickBooks usa los dos puntos para separar los subclientes), un tabulador ni un salto de línea.

Errores frecuentes: 401 AuthenticationFailed (3200) significa que la autorización caducó o se revocó, o que QBO_API_URL no corresponde a las claves: revisa la URL y vuelve a hacer clic en Authorize with Provider. 403 ApplicationAuthorizationFailed (3100) significa que el realm id pertenece a una empresa para la que no se concedió este inicio de sesión, o que el rol del usuario no tiene acceso. 400 QueryParserError significa un error de sintaxis en una consulta. 6240 Duplicate Name Exists Error significa que el nombre para mostrar ya está en uso; 2040 Invalid String significa que un nombre contiene dos puntos, un tabulador o un salto de línea; 5010 Stale Object Error significa que el registro cambió mientras tanto y hay que volver a leerlo. 429 significa que se alcanzó el límite de 500 solicitudes por minuto: espera un minuto.

El conector no gestiona PDF ni archivos adjuntos de facturas, el registro de pagos, los movimientos bancarios, las nóminas ni QuickBooks Desktop, y no elimina nada salvo facturas.

Requisitos previos: QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REALM_ID, QBO_API_URL

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige QuickBooks Online e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas están vencidas y cuánto debe cada cliente?"
• "Muéstrame la cuenta de pérdidas y ganancias de este ejercicio fiscal, mes a mes."
• "Crea una factura para Acme Ltd: 10 horas del servicio Consultoría, con vencimiento a 30 días."
• "¿Qué facturas de proveedores llevan más de 60 días vencidas?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT