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

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

Billbee + Meta Muse

Deja que tu IA trabaje con Billbee: encuentra pedidos de todos tus marketplaces y tiendas por fecha o número de pedido del marketplace, consulta artículos por SKU o EAN con precio y stock, revisa el historial de pedidos de un cliente y lista tus transportistas. Solo lectura, con API key, email de acceso y contraseña de API.

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:

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

Paso 1 — Obtener credenciales

1. Inicia sesión en Billbee y abre Einstellungen (Settings) → Billbee API. En los ajustes generales de esa página, activa el acceso a la API y define una contraseña de API. Es una contraseña aparte, solo para la API, no la que usas para entrar.
2. Pide una API key a Billbee: usa su formulario de solicitud de API o escribe a [email protected] explicando brevemente qué quieres conectar (aquí: tu IA leyendo pedidos a través de AnythingMCP). Billbee te envía la clave.
3. Pon la clave en BILLBEE_API_KEY, el email con el que entras en Billbee en BILLBEE_LOGIN_EMAIL y la contraseña de API del paso 1 en BILLBEE_API_PASSWORD.
4. Instala el conector. No hay paso Authorize with Provider: cada llamada envía la API key en la cabecera X-Billbee-Api-Key, además de tu email y la contraseña de API como HTTP Basic auth.
5. Empieza con billbee_list_shipping_providers: no necesita parámetros y lista los transportistas configurados en tu cuenta. Si responde, los tres valores funcionan.

Tres valores, todos obligatorios: Billbee rechaza una llamada que lleve solo la API key, o solo el email y la contraseña de API. Los tres tienen que estar configurados en el conector.

Mantener la sesión iniciada: no hay tokens que renovar, el conector envía los tres valores en cada llamada. Si cambias la contraseña de API en Billbee o recibes una API key nueva, actualiza BILLBEE_API_PASSWORD o BILLBEE_API_KEY en la página del conector.

Solo lectura: las 8 herramientas solo leen pedidos, artículos, clientes y transportistas. El conector no puede crear ni cambiar nada en Billbee, así que para un uso de solo lectura no hay nada que desactivar. Aun así puedes desactivar herramientas sueltas en la página del conector, por ejemplo billbee_list_customers y billbee_get_customer_orders si la IA no debe ver datos de clientes.

Pedidos: billbee_list_orders filtra por fecha del pedido (minOrderDate, maxOrderDate) y por última modificación (modifiedAtMin, modifiedAtMax), con fechas en ISO 8601 como 2026-01-01. billbee_get_order devuelve el pedido completo con líneas, direcciones, datos de pago y de envío a partir del id de Billbee. billbee_get_order_by_extref encuentra un pedido por el número de pedido del marketplace o de la tienda, por ejemplo un número de pedido de Amazon o eBay. Los estados de los pedidos llegan como números.

Artículos y clientes: billbee_get_product busca un artículo por su id de Billbee, o por SKU o EAN cuando lookupBy es sku o ean, y devuelve precios y stock. billbee_list_products se puede limitar a los artículos creados después de una fecha (minCreatedAt). billbee_list_customers no tiene búsqueda, así que encontrar un cliente por nombre supone recorrer la lista página a página; con el id del cliente, billbee_get_customer_orders lista sus pedidos.

Páginas y límites de frecuencia: las herramientas de listado devuelven hasta 250 filas por página (pageSize), con Page, TotalPages y TotalRows en la respuesta, y la IA pide la siguiente page hasta llegar a la última. Billbee permite 2 peticiones por segundo por API key y usuario y por encima responde 429: espera un momento y vuelve a intentarlo. Billbee cobra el uso de la API por encima de un cupo gratuito, así que es mejor usar rangos de fechas acotados y modifiedAtMin que listarlo todo una y otra vez.

Errores frecuentes: si Billbee rechaza las credenciales, comprueba que las tres variables estén configuradas, que el acceso a la API esté activado en Einstellungen → Billbee API y que BILLBEE_API_PASSWORD contenga la contraseña de API y no la de acceso. 429 significa que se superó el límite de 2 peticiones por segundo.

El conector no crea ni edita pedidos, no cambia estados de pedidos, no actualiza el stock, no crea envíos ni etiquetas y no crea facturas ni otros documentos.

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 Billbee.

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é pedidos han entrado en los últimos 7 días y cuáles de ellos todavía no se han enviado?"
• "Busca el pedido con el número de pedido del marketplace 302-1234567-1234567 y enséñame las líneas, la dirección de entrega y los datos de pago."
• "¿Cuántas unidades del SKU ABC-123 tenemos en stock y cuál es el precio de venta?"
• "Enumera todos los pedidos del cliente de Billbee 4567 con fecha e importe total, del más reciente al más antiguo."

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