Cómo conectar Invoice123 a Microsoft Copilot vía MCP

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

Invoice123 + Microsoft Copilot

Invoice123 (Saskaita123), facturación para Lituania y Letonia, de solo lectura: facturas de venta con pagos, enlaces de pago y PDF, compras, clientes, productos, proyectos, albaranes, tipos de IVA, series y cuentas bancarias.

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:

INVOICE123_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Invoice123 (Saskaita123 en Lituania) en la que puedas instalar integraciones.

1. En Invoice123 abre el menú de la cuenta (arriba a la derecha), luego Integrations (icono de puzle) o Account settings > Integrations, e instala la integración API.
2. Pulsa Generate your API key, ponle un nombre y marca los permisos que la IA puede usar: como mínimo invoice:index, y además expense:index, client:index, product:index, project:index y waybills:index para esas áreas. El PDF de las facturas comprueba invoice:store, y el de las ofertas commercial:store.
3. Pega solo la clave en INVOICE123_API_TOKEN, sin la palabra Bearer, espacios ni comillas. El conector la envía como Authorization: Bearer.
4. Instala el conector y ejecuta invoice123_get_company para comprobar el token.

Qué lee: facturas de venta con cliente, líneas, IVA, totales, moneda, pagos e indicador de pagada; los pagos de una factura, es decir, cómo y cuándo se pagó (transferencia, efectivo, tarjeta, ticket de caja); el enlace de pago online de una factura cuando la empresa tiene Montonio o Paysera activado; PDF de facturas y ofertas comerciales en lituano, inglés o letón; facturas de compra (gastos) con tipos de gasto, IVA y pagos; clientes (clientes y proveedores); el catálogo de productos con precios y stock por almacén; proyectos con presupuesto; albaranes; y los datos de referencia: series de documentos, tipos de IVA de ventas y compras, cuentas bancarias, unidades, actividades, cajas registradoras y plantillas de correo.

Cómo lo usa la IA: cuando necesita ids, lee primero los datos de referencia, en una sola llamada con invoice123_get_invoice_data (actividades, series, bancos, unidades, tipos de IVA y almacenes) o lista a lista. Para partidas abiertas filtra invoice123_list_invoices por status unpaid o late, por un periodo con range y por un cliente con client_id; después, invoice123_list_invoice_payments muestra cómo se liquidó una factura.

Solo lectura: las 21 herramientas solo leen. En Invoice123 no se emite, envía ni cambia nada, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Páginas, fechas e importes: las listas devuelven data.result y data.pagination (current_page, last_page, total); la IA pasa page (desde 1) y limit (20 por defecto) y se detiene en last_page. Un rango de fechas son dos fechas YYYY-MM-DD unidas por una coma. Los importes son cadenas en la moneda de la factura, normalmente EUR.

Límites: 60 peticiones por minuto en el plan Standard, 1.000 por hora en Business. Por encima, Invoice123 responde 429.

Errores comunes: 401 significa un token incorrecto o eliminado. 403 significa que al token le falta el permiso indicado en la descripción de la herramienta; las compras, los albaranes y las ofertas necesitan además su módulo activado en la cuenta.

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

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. 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.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Invoice123.
6. 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

Ejemplos de prompts

• "¿Qué facturas están vencidas, por qué importes y de qué clientes son?"
• "¿Cómo y cuándo se pagó la última factura a UAB Pavyzdys?"
• "Enumera las facturas de compra de este mes por tipo de gasto, con su IVA."
• "Dame el enlace de pago online de la factura abierta de UAB Pavyzdys."
• "Descarga el PDF de nuestra última factura en inglés."

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