Conectar Billbee MCP con ChatGPT: pedidos y stock

💡 ¿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 + ChatGPT

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Billbee.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

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

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot