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

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

Printful + Meta Muse

Deja que tu IA trabaje con Printful: explora el catálogo de impresión bajo demanda, consulta precios de producción y tarifas de envío, calcula el coste de los pedidos, crea borradores y síguelos hasta la entrega, y consulta los productos de tus tiendas, también en Shopify, Etsy y WooCommerce. Con un token privado de Printful.

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:

PRINTFUL_API_TOKEN

Paso 1 — Obtener credenciales

1. Inicia sesión en developers.printful.com con tu cuenta de Printful y abre Your tokens (developers.printful.com/tokens).
2. Crea un token privado y elige el nivel de acceso. Un token Store llega a una sola tienda, que eliges ahora, y las herramientas de tienda no necesitan store_id. Un token Account llega a todas las tiendas de la cuenta; entonces la IA pasa a las herramientas de tienda un store_id sacado de printful_list_stores (se envía como cabecera X-PF-Store-Id).
3. Elige los scopes: orders para leer y escribir pedidos (o orders/read para una configuración de solo lectura) y sync_products/read para los productos de la tienda. printful_list_stores necesita además el scope de tiendas (stores_list), donde el formulario lo ofrezca. El catálogo, los precios y las tarifas de envío no necesitan scope.
4. Pon una fecha de caducidad, crea el token y cópialo enseguida: Printful lo muestra una sola vez. Pégalo solo, sin Bearer delante, en PRINTFUL_API_TOKEN y luego instala el conector.
5. Empieza con printful_get_token_scopes para ver qué puede hacer el token, y después con printful_list_stores para ver tus tiendas y sus ids.

Caducidad del token: un token privado funciona hasta la fecha de caducidad que elegiste y no se puede renovar. Crea uno nuevo antes de esa fecha y pégalo en PRINTFUL_API_TOKEN. No hay paso Authorize with Provider.

Hace falta una tienda: las tarifas de envío, las estimaciones de costes y los pedidos siempre pertenecen a una tienda. Una cuenta sin tiendas responde This endpoint requires store_id, así que crea una primero en el panel de Printful (Stores → Add store → Manual order platform / API).

Los borradores son gratis, confirmar cuesta dinero: printful_create_draft_order crea un borrador, que Printful no envía a producción ni cobra. Puedes revisarlo y editarlo en el panel, en Orders. Antes, printful_calculate_shipping_rates muestra las opciones de envío y printful_estimate_order_costs el coste completo (artículos, impresiones, envío, impuestos, IVA) sin crear nada. Cada artículo es o bien una variante del catálogo con URLs de archivos de impresión que Printful pueda descargar, o bien la variante de un producto ya configurado en tu tienda, que lleva sus propios archivos. Si le das a un pedido tu propio external_id, cualquier herramienta de pedidos lo encuentra como @ seguido de ese id, por ejemplo @SHOP-1001. Los pedidos de una tienda vinculada a Shopify, Etsy o WooCommerce llegan solos a Printful, así que la IA no los vuelve a crear.

Desactivadas al instalar: printful_confirm_order, que envía un borrador a producción. Printful cobra entonces al método de pago de la tienda y empieza la producción, y el pedido solo se puede cancelar mientras siga en estado pending. Actívala solo si la IA debe mandar pedidos a producción; si no, confirma tú los borradores en el panel. Si está activa, la IA te muestra antes el pedido, los artículos, la dirección y el total, y espera tu sí.

Dos tipos de productos de tienda: para las tiendas Manual order / API la IA usa printful_list_store_products y printful_get_store_product; para las tiendas vinculadas a Shopify, WooCommerce, Etsy y otras plataformas usa printful_list_sync_products y printful_get_sync_product, que muestran qué variantes de la plataforma están sincronizadas con un producto de Printful. El campo type de printful_list_stores indica de qué tipo es cada tienda.

Permisos y solo lectura: el token llega solo a sus scopes y, a nivel Store, solo a su tienda. Para una configuración de solo lectura, crea el token con orders/read en lugar de orders, desactiva printful_create_draft_order en la página del conector y deja printful_confirm_order apagada.

Límites de peticiones: Printful permite 120 peticiones por minuto y tienda. Por encima del límite responde 429 con una cabecera Retry-After y no procesa la petición: espera un minuto y vuelve a intentarlo.

Errores frecuentes: 401 significa que el token es incorrecto, ha caducado o se ha borrado: crea uno nuevo en Your tokens. 403 significa que al token le falta el scope para esa llamada, o que se usó un token Account sin store_id. 400 indica el campo no válido, por ejemplo un state_code que falta (obligatorio para Estados Unidos, Canadá y Australia), una variante desconocida o la URL de un archivo que Printful no puede descargar. 404 indica un id desconocido: los ids reales los dan las herramientas de listado.

El conector no cancela, edita ni borra pedidos, no crea ni edita productos de la tienda, no sube archivos a la biblioteca de archivos ni gestiona webhooks.

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

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

• "¿Cuánto cuesta producir una camiseta unisex negra en talla M con estampado delantero, y qué opciones de envío hay a Madrid?"
• "¿Cuáles de mis pedidos están en espera o han fallado, y cuáles son los enlaces de seguimiento de los pedidos ya enviados?"
• "Crea un borrador de pedido para Ana García, Calle Mayor 5, 28013 Madrid: 2 unidades de nuestra Logo Hoodie en talla L con envío estándar, y enséñame el coste total antes de confirmar nada."
• "¿Qué productos de mi tienda Shopify todavía no están sincronizados con un producto de Printful?"

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