Cómo conectar Printful a Cursor 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 + Cursor

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Printful.

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse