Cómo conectar easybill a Meta Muse vía MCP

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

easybill + Meta Muse

Deja que tu IA trabaje con tu cuenta de easybill: buscar clientes y crear nuevos, listar facturas, notas de crédito, ofertas, recordatorios de pago y albaranes por cliente, fecha o estado de pago, leer líneas y totales, descargar documentos en PDF y consultar tu catálogo de artículos. Con una clave API de tu perfil de easybill.

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:

EASYBILL_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en easybill, haz clic en tu icono de usuario arriba a la derecha y elige Profil und Einstellungen (perfil y ajustes; la interfaz de easybill está en alemán).
2. En la ventana que se abre, ve a la sección de la clave API, haz clic en Neuen Schlüssel generieren (generar clave nueva) y luego en Speichern (guardar) arriba a la derecha. Si no ves ninguna sección de clave API, pide al soporte de easybill que active el acceso a la API para tu cuenta.
3. Copia la clave en EASYBILL_API_KEY. El conector la envía como token Bearer a https://api.easybill.de/rest/v1; no hay URL, ID de cuenta ni otro ajuste que rellenar.
4. Instala el conector. No hay paso Authorize with Provider: basta con la clave, y AnythingMCP la guarda cifrada.
5. Empieza con easybill_list_customers y un limit pequeño, por ejemplo 5, para comprobar que la clave llega a la cuenta de easybill correcta.

Una sola herramienta para todos los tipos de documento: facturas, notas de crédito, ofertas, recordatorios de pago y albaranes salen todos de easybill_list_documents, filtrados por type (INVOICE, CREDIT, OFFER, REMINDER, DELIVERY, varios separados por comas). También filtra por customer_id, por document_date (un único YYYY-MM-DD o un rango como 2026-01-01,2026-03-31) y por paid_at, donde el valor null devuelve solo los documentos sin pagar. easybill_get_document lee un documento con sus líneas, el IVA por línea (vat_percent), los totales y el estado de pago, y easybill_get_document_pdf devuelve el PDF final, codificado en base64 en el campo pdf.

IDs y números: easybill da a cada cliente y documento un id numérico además del número que ves en la interfaz (número de cliente, número de factura). easybill_get_customer, easybill_get_document, easybill_get_document_pdf y el filtro customer_id esperan el id, así que la IA lo busca primero con una herramienta de listado. easybill_list_customers busca por company_name, last_name, emails, number (número de cliente) y country (código ISO como DE).

Crear clientes: easybill_create_customer es la única herramienta que escribe. Necesita al menos un company_name o un last_name y admite también first_name, la dirección, emails y el NIF-IVA en vat_identifier. Pide a la IA que te muestre los datos antes de crear el cliente, así evitas duplicados.

Permisos y solo lectura: para una IA que solo lea, desactiva easybill_create_customer en la página del conector. Las otras seis herramientas solo leen clientes, documentos, PDF y tu catálogo de artículos (easybill_list_positions, con número de artículo, descripción, precio unitario y tipo de IVA).

Listas largas: las herramientas de listado devuelven 100 filas por página por defecto y hasta 1000 con limit. La respuesta incluye page, pages y total, y la IA avanza con page. Los importes están en la moneda de cada documento.

Errores frecuentes: 401 significa que falta la clave o es incorrecta: cópiala de nuevo desde Profil und Einstellungen, o genera allí una nueva y actualiza EASYBILL_API_KEY. 404 en un cliente o documento concreto suele significar que la IA pasó el número que se ve en easybill en lugar del id numérico.

El conector no crea, envía, modifica ni anula facturas, ofertas u otros documentos, no registra pagos, no envía recordatorios, no edita ni borra clientes y no cambia el catálogo de artículos.

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 Muse

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.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de easybill.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas siguen sin pagar y cuánto nos debe cada cliente en total?"
• "Busca a nuestro cliente Müller GmbH y consígueme el PDF de su última factura."
• "Lista todas las ofertas del primer trimestre de 2026 con cliente, fecha y total."
• "Crea un cliente nuevo: Schneider Holzbau GmbH, Hauptstraße 12, 79098 Freiburg, Alemania, NIF-IVA DE123456789, [email protected]. Enséñame antes los datos."

FAQ

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini