Printful a MCP: Pilota Printful desde cualquier agente IA

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

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.

Configuración

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.

Requisitos previos: PRINTFUL_API_TOKEN

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Printful e introduce las variables listadas en los Requisitos previos.

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?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT