Cómo conectar Falco a Cursor vía MCP

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

Falco + Cursor

Falco, contabilidad belga y facturación electrónica Peppol: documentos de compra y de venta con sus archivos, facturas recibidas por Peppol, consultas de participantes Peppol y los clientes, artículos y facturas del módulo de facturación de Falco. Casi todo de solo lectura; cambiar el estado de pago de una compra y enviar respuestas Peppol a facturas vienen desactivados al instalar.

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:

FALCO_APP_SECRET, FALCO_API_KEY

Paso 1 — Obtener credenciales

El conector necesita dos claves, y las dos son obligatorias: un application secret del integrador y una clave de API del cliente de Falco.

1. El integrador crea una aplicación en el portal de desarrolladores de Falco (dev.falco-app.be), solicita los scopes que necesita, por ejemplo documents:purchases:read, documents:sales:read, peppol:inbound:read, peppol:participants:read, customers:read, articles:read e invoices:read, y la marca como Public. Su Application Secret de producción (as_live_...) va en FALCO_APP_SECRET.
2. El cliente de Falco, un administrador de la organización con plan Expert Essential o Expert Premium, abre API access bajo sus iniciales en la aplicación de escritorio de Falco, elige esa aplicación por su id (app_...) y genera una API key (sk_live_...) para su organización. Va en FALCO_API_KEY.
3. Instala el conector y ejecuta falco_get_organization para comprobar las dos claves. El conector llama a la API de producción, https://api.falco-app.be/v1; las claves de sandbox (as_test_, sk_test_) solo funcionan en el host de sandbox y aquí se rechazan.

Qué lee: la organización de la clave (nombre, número de IVA, identificador Peppol, dirección, IBAN, plan); documentos de compra (facturas y abonos de proveedores) con estado de pago y de Peppol, historial de eventos y archivos adjuntos; documentos de venta, también los importados como PDF o UBL; documentos recibidos por Peppol con remitente, importes, vencimiento, referencia de pago y cuenta bancaria; y los clientes, artículos y facturas del módulo de facturación de Falco, con líneas, subtotales de IVA y estado de Peppol. También descarga archivos: el archivo principal, el XML UBL o un adjunto de un documento de compra, el UBL de un documento recibido por Peppol y el PDF de una factura del módulo de facturación.

Cómo lo usa la IA: para facturas de proveedores empieza con falco_list_peppol_inbound (lo que llegó por Peppol) y falco_list_purchase_documents (todos los documentos de compra con sus archivos); para ventas con falco_list_sale_documents o, para documentos creados en el módulo de facturación, falco_list_invoices. Para saber si una empresa puede recibir facturas electrónicas usa falco_find_peppol_participant con el número de IVA, o falco_check_peppol_participant con un id de participante como 0208:0123456789.

Desactivadas al instalar: falco_set_purchase_payment_status y falco_send_invoice_response. La primera sustituye el estado de pago de un documento de compra por not_paid, partially_paid o paid, por ejemplo después de pagar a un proveedor. La segunda envía al remitente de un documento recibido una respuesta a la factura por Peppol (acknowledged, in_process, under_query, conditionally_accepted, rejected, accepted o paid); el proveedor la recibe al instante y no se puede retirar. Un administrador las activa de forma deliberada. Aun así, la IA te muestra el documento y el nuevo estado o la respuesta y espera tu sí.

Fechas e importes: los filtros aceptan YYYY-MM-DD. Los importes son cadenas en la moneda del documento, normalmente EUR. Las listas se paginan con page (desde 0) y page_size (de 20 a 200, facturas hasta 100), y la IA pide la página siguiente mientras una página vuelva llena.

Límites: 60 peticiones por minuto por application secret. Por encima, Falco responde 429, y la IA espera y vuelve a intentarlo.

Errores comunes: los errores siguen la RFC 9457 con title, detail y code. 401 significa un application secret o una clave de API incorrectos, o una clave de sandbox en producción. 403 significa que a la clave le falta el scope de esa área; el cliente concede los scopes al crear la clave. 404 en la consulta de un participante significa que la empresa no es accesible por Peppol.

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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Falco.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas de proveedores recibidas por Peppol este mes siguen sin pagar, y cuándo vencen?"
• "Muéstrame los documentos de compra de los últimos 30 días con proveedor, importe y estado de pago."
• "¿Puede la empresa con número de IVA BE0123456789 recibir facturas electrónicas por Peppol?"
• "Enumera las facturas del módulo de facturación enviadas pero aún no pagadas, con sus importes con IVA."
• "Descarga el PDF de la factura 2026-0142 del módulo de facturación."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot