Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Falco 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
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.
Prueba a pedir
Prompts de ejemplo para Falco
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 → Falco, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Falco + Microsoft Copilot
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.
- 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:readeinvoices:read, y la marca como Public. Su Application Secret de producción (as_live_...) va enFALCO_APP_SECRET. - 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 enFALCO_API_KEY. - Instala el conector y ejecuta
falco_get_organizationpara 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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Falco. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
falco_get_organization | Get the Falco organization the API key belongs to: name, VAT number, Peppol identifier, address, IBANs, profiles, plan (expert_essential or… |
falco_list_purchase_documents | List purchase documents (supplier invoices and credit notes) in Falco, newest first: id, number, invoice and due date, currency, amount… |
falco_get_purchase_document | Get one purchase document by id: number, dates, amount, supplier, payment and Peppol status, its event history and the list of attached… |
falco_download_purchase_document_file | Download a file of a purchase document: the main file (usually the PDF), the UBL XML, or one attached file |
falco_list_sale_documents | List sale documents (sales invoices and credit notes, including those imported as PDF or UBL), newest first: id, number, dates, currency… |
falco_get_sale_document | Get one sale document by id: number, dates, amount, customer, payment status, Peppol send status, event history and attached files |
falco_list_peppol_inbound | List documents received over Peppol (incoming e-invoices and credit notes), newest first: id, received date, invoice and due date, amount… |
falco_get_peppol_inbound_document | Get one document received over Peppol by id: sender, amounts, dates, payment reference, bank account, invoice reference and payment status |
falco_download_peppol_inbound_document | Download the file of a document received over Peppol (the UBL XML as received) |
falco_find_peppol_participant | Look up the Peppol participant identifier registered for a VAT number, to see whether a company can receive e-invoices over Peppol |
falco_check_peppol_participant | Check whether a Peppol participant identifier (e.g. 0208:0123456789) is registered to receive invoices or credit notes |
falco_list_customers | List customers of the Falco invoicing module: id, name, VAT and company number, language, e-mails, phone, contact, address and Peppol… |
falco_get_customer | Get one customer of the invoicing module by id with full address, contacts and Peppol identifier |
falco_list_articles | List articles (products and services) of the invoicing module: id, descriptions, unit price excluding and including VAT, unit, category… |
falco_list_invoices | List sales invoices and credit notes created in the Falco invoicing module: id, number, type, status (draft, sent, locked), document and… |
falco_get_invoice | Get one invoice or credit note of the invoicing module with its lines (article, quantity, unit price, VAT rate, amounts), VAT subtotals… |
falco_download_invoice_pdf | Download the PDF of an invoice or credit note of the invoicing module |
falco_set_purchase_payment_status | Set the payment status of a purchase document to not_paid, partially_paid or paid, e.g. after paying a supplier |
falco_send_invoice_response | Send a Peppol invoice response for a received document to its sender: acknowledged, in_process, under_query, conditionally_accepted… |
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?