Conectar Billbee MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

Deja que tu IA trabaje con Billbee: encuentra pedidos de todos tus marketplaces y tiendas, consulta artículos por SKU o EAN con precio y stock, revisa el historial de pedidos de un cliente y gestiona pedidos: cambia su estado, añade números de seguimiento, reserva etiquetas de envío con los transportistas conectados en Billbee, actualiza el stock, añade tags, cambia campos de pedidos y artículos y crea facturas. 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.

Lectura y escritura: 9 de las 17 herramientas solo leen pedidos, artículos, clientes, transportistas y almacenes. Las otras 8 cambian tu cuenta real de Billbee, y Billbee transmite la mayoría de los cambios a las tiendas y marketplaces conectados. Las 17 quedan activadas al instalar. Para un uso de solo lectura, desactiva las herramientas de escritura en la página del conector; también puedes desactivar herramientas de lectura sueltas, por ejemplo billbee_list_customers y billbee_get_customer_orders si la IA no debe ver datos de clientes.

Herramientas de escritura:

• billbee_set_order_state cambia el estado del pedido, por ejemplo 3 pagado, 4 enviado, 8 cancelado o 13 empaquetado. La tienda o el marketplace puede enviar un email al comprador.
• billbee_add_shipment_to_order guarda un número de seguimiento creado en otro sitio; no crea etiquetas ni cambia el estado. billbee_ship_order_with_label reserva una etiqueta real y de pago con un transportista conectado en Billbee (DHL, DPD, GLS, Deutsche Post y otros) con tu propio contrato; providerId y productId salen de billbee_list_shipping_providers, y la IA te pregunta antes de reservar.
• billbee_update_stock fija el stock absoluto de un artículo por SKU, no una diferencia; con varios almacenes necesita el stockId de billbee_list_stocks. Billbee envía el nuevo stock a tus tiendas y marketplaces.
• billbee_add_order_tags añade tags a un pedido. billbee_update_order y billbee_update_product cambian solo los campos que se pasan, con los nombres de campo que devuelven billbee_get_order y billbee_get_product, como SellerComment o Price.
• billbee_create_invoice crea la factura de un pedido con tu plantilla de factura, como máximo una vez por pedido cada 5 minutos, y puede devolver el PDF.

Las herramientas de escritura usan el id interno del pedido en Billbee, no el número de pedido de la tienda: billbee_get_order_by_extref encuentra el id a partir del número de pedido del marketplace.

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 borra pedidos, no crea ni cambia clientes y no crea ni borra 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 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 Billbee.
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é 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."
• "Marca el pedido de Amazon 302-1234567-1234567 como enviado y añade el número de seguimiento de DHL 00340434161234567890."
• "Crea con Billbee una etiqueta de DHL para el pedido de eBay 14-12688-90311 y después su factura."

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