Resumen
Gestiona tu tienda en el marketplace de The Knot desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en Estados Unidos; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de The Knot.
Configuración guiada
Conecta The Knot Marketplace a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta The Knot Marketplace con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para The Knot Marketplace
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Connectors → The Knot Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
The Knot Marketplace + Microsoft Copilot
Gestiona tu tienda en el marketplace de The Knot desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en Estados Unidos; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de The Knot.
Prerrequisitos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
THE_KNOT_API_KEY
Paso 1 — Obtén credenciales
Países: Estados Unidos.
Quién puede vender: The Knot elige las marcas que vende en su tienda de registro; no se encontró ninguna página pública de solicitud, así que pregunta a The Knot o a tu integrador para una presentación. Los vendedores envían desde Estados Unidos. El conector necesita una cuenta de vendedor que The Knot ya haya abierto.
La dirección del vendedor de este conector es la que la plataforma asigna a este minorista; ninguna guía de vendedor la nombra aún. Si tu oficina de vendedor se abre en una dirección diferente, háznoslo saber en el chat para que podamos corregirlo.
La configuración tarda unos 5 minutos.
- Inicia sesión en la oficina de vendedor de The Knot:
https://knot-prod.mirakl.net/login. - En la oficina, abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en
THE_KNOT_API_KEY. La clave se envía tal cual en el encabezadoAuthorization, sinBearer. Generar una nueva clave invalida la anterior, por lo que cualquier otra herramienta que la use dejará de funcionar. - Deja
THE_KNOT_SHOP_IDvacío. Solo si tu usuario gestiona varias tiendas en The Knot, estableceTHE_KNOT_SHOP_IDal id numérico de la tienda en la que este conector debería trabajar (mostrado en el panel de la oficina junto a Identifier o Shop ID, y devuelto comoshop_idporthe_knot_get_account). Sin ello, se usará tu tienda predeterminada. - Instala y ejecuta
the_knot_get_account: devuelve la tienda a la que pertenece la clave.
Dónde empezar: the_knot_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario, usa the_knot_list_orders con order_state_codes=WAITING_ACCEPTANCE, the_knot_list_offers para precios y stock y the_knot_list_threads para mensajes que esperan respuesta.
Productos y ofertas competidoras: the_knot_get_products busca productos en el catálogo de The Knot por EAN u otra referencia y devuelve el SKU del producto en el marketplace; the_knot_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a aproximadamente 5 llamadas por minuto.
Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. the_knot_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego, the_knot_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de the_knot_list_carriers) y the_knot_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Usa the_knot_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diaria y has_incident=true para incidentes abiertos; the_knot_resolve_incident cierra un incidente en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (albaranes, etiquetas, facturas de clientes) se listan mediante the_knot_list_order_documents.
Escrituras: confirma primero. the_knot_accept_order, the_knot_update_tracking, the_knot_ship_order, the_knot_resolve_incident, the_knot_accept_return, the_knot_receive_return, the_knot_update_offers, the_knot_reply_thread, the_knot_create_order_thread y the_knot_import_products actúan en el marketplace en vivo. Antes de cada llamada, muestra al usuario lo que cambiará (id y líneas del pedido, número de seguimiento, SKU de la oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela de forma definitiva. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; haz eso en la oficina de vendedor. the_knot_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.
Actualización de ofertas (precios y stock): the_knot_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (the_knot_get_offer o the_knot_list_offers con sku) y envíala de vuelta completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (lee como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con the_knot_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de the_knot_list_offer_conditions, los códigos de clase logística de the_knot_list_logistic_classes.
Importaciones de archivos: the_knot_import_products (P41) y the_knot_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que The Knot solicita; el conector lo descarga y lo sube a The Knot. Haz seguimiento con the_knot_list_product_imports / the_knot_get_product_import y the_knot_list_offer_imports / the_knot_get_offer_import.
Devoluciones: the_knot_list_returns (RT11) lista las solicitudes de devolución. Donde The Knot permite que la tienda decida, the_knot_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y the_knot_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina de vendedor.
Mensajes: the_knot_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), the_knot_get_thread lee uno con sus mensajes, the_knot_reply_thread responde (destinatario CUSTOMER o OPERATOR, que es The Knot) y the_knot_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para los temas provienen de the_knot_list_reasons; deja su locale vacío a menos que sepas que el marketplace tiene ese idioma (un locale inactivo responde 400).
Dinero: the_knot_list_invoices (IV01) lista los documentos contables que The Knot emite a la tienda y the_knot_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si The Knot utiliza la Facturación Mejorada para Vendedores, IV01 no devuelve nuevos documentos; usa the_knot_list_document_requests (DR11) y las transacciones entonces.
Catálogo completo: para leer cada oferta (una verificación de stock o precio en todo el catálogo, contando ofertas), inicia una exportación con the_knot_export_offers, consulta the_knot_get_offer_export_status aproximadamente una vez por minuto hasta que esté COMPLETED, y lee los archivos uno por uno con the_knot_get_offer_export_file; include_fields mantiene solo las columnas que necesitas. Se permite una exportación completa una vez al día; para lo que ha cambiado desde entonces, pasa last_request_date (una exportación diferencial, como máximo una vez por minuto). No pagines a través de cada oferta con the_knot_list_offers: está destinado a unas pocas ofertas a la vez y responde 429 cuando se pagine a través de un catálogo grande.
Varias tiendas: cada herramienta toma un shop_id opcional. Un usuario que gestiona varias tiendas en este marketplace (una agencia, o una tienda por país) puede trabajar en todas ellas con una sola instalación: pasa el id de la tienda en cada llamada y verifica cuál es la tienda con the_knot_get_account y el mismo shop_id. Sin shop_id, una llamada usa THE_KNOT_SHOP_ID, o la tienda predeterminada del usuario cuando está vacía. Pregunta al usuario por los ids de sus tiendas; la oficina de vendedor los muestra.
Listas de referencia: the_knot_list_channels (sitios de países), the_knot_list_carriers, the_knot_list_shipping_zones, the_knot_list_shipping_methods y the_knot_list_logistic_classes cambian raramente; léelos una vez por conversación.
Paginación: pedidos, ofertas, facturas e importaciones de productos se paginan con max (como máximo 100) y offset. Hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran entonces) hasta que falte.
Fechas son ISO 8601, p. ej. 2026-10-01T00:00:00Z; las respuestas están en UTC.
Límites de tasa: Cada API tiene su propio límite y The Knot puede endurecerlos. Listar ofertas y pedidos está destinado a uso interactivo, importaciones de productos y ofertas como máximo cada 15 minutos, the_knot_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.
Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario no tiene el derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda o que el marketplace no utiliza esa función, como devoluciones, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, p. ej. ORDER_INVALID_STATE).
Paso 2 — Instala el adaptador
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 — Agrega 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 muestraYOUR_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.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - 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.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
The Knot Marketplace. - 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
| Herramienta | Qué hace |
|---|---|
the_knot_get_account | Lee la tienda detrás de la clave API en este marketplace (A01): id y nombre de la tienda, estado, canales, moneda, grado y tasa de aprobación, contacto… |
the_knot_list_orders | Lista los pedidos (OR11) con sus líneas, cliente, dirección de envío, precios, estado e incidentes. Filtra por estado (p. ej. WAITING_ACCEPTANCE para… |
the_knot_list_offers | Lista las ofertas de la tienda (OF21): SKU, producto, precio y descuento, todos los precios de canal, cantidad en stock, condición, tiempo de entrega y si… |
the_knot_get_offer | Lee una oferta completa por su id de oferta (OF22): cada campo de precio, descuento, cantidad, condición, clase logística, tiempo de entrega y campos personalizados… |
the_knot_list_offer_conditions | Lista las condiciones de oferta (OF61) que el marketplace acepta, p. ej. nuevo o usado, con el código para poner en state_code al actualizar ofertas |
the_knot_list_offer_imports | Lista importaciones y actualizaciones de ofertas (OF04), desde archivos y desde the_knot_update_offers: estado (WAITING, RUNNING, COMPLETE, FAILED), líneas leídas… |
the_knot_get_offer_import | Lee el estado de una importación de oferta o actualización de oferta (OF02) por su import_id, como lo devuelve the_knot_update_offers o… |
the_knot_export_offers | Inicia una exportación de todas las ofertas de la tienda como archivos (OF52), la forma de leer todo el catálogo (cada SKU con precio y stock) en lugar de… |
the_knot_get_offer_export_status | Estado de una exportación de oferta iniciada con the_knot_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code y error.detail), y… |
the_knot_get_offer_export_file | Lee un archivo de una exportación de oferta completada (OF54): las ofertas con su SKU, producto, cantidad, precios y otros campos exportados, como… |
the_knot_list_product_imports | Lista importaciones de productos (P51) con su estado (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), los recuentos de transformación y el… |
the_knot_get_product_import | Lee el estado de una importación de producto (P42) por su import_id: estado de importación, razón, recuentos de transformación y los detalles de integración… |
the_knot_get_products | Busca productos en el catálogo del marketplace por sus identificadores (P31), p. ej. EAN, y obtiene el SKU del producto en el marketplace, título y categoría.… |
the_knot_list_product_offers | Lista las ofertas de cada tienda para productos dados (P11), ordenadas por mejor precio, para comparar tu precio con la competencia. Proporciona product_ids… |
the_knot_list_threads | Lista hilos de mensajes (M11) con clientes y The Knot: tema, pedido o oferta vinculada, participantes, fecha del último mensaje y desde cuándo una tienda… |
the_knot_get_thread | Lee un hilo de mensaje (M10) con todos sus mensajes, remitentes, destinatarios, adjuntos y el pedido o la oferta vinculada |
the_knot_list_returns | Lista solicitudes de devolución (RT11) con su estado, líneas de devolución, razón, RMA, seguimiento y el pedido vinculado. Filtra por estado, pedido o fecha.… |
the_knot_list_reasons | Lista los códigos de razón del marketplace (RE01): incidentes, cancelaciones, reembolsos y razones de mensajes, con sus etiquetas y si la tienda puede… |
the_knot_list_carriers | Lista los transportistas que conoce el marketplace (SH21) con su código, etiqueta y URL de seguimiento. Usa el código como carrier_code en… |
the_knot_list_invoices | Lista los documentos contables que The Knot emite a la tienda (IV01): facturas y notas de crédito con periodo, totales con y sin impuestos… |
the_knot_list_transactions | Lista las líneas de transacción de la tienda (TL02): montos de pedidos, envío, comisiones, reembolsos, créditos manuales y pagos, con monto, tipo… |
the_knot_list_document_requests | Lista solicitudes de documentos contables (DR11), utilizadas cuando The Knot ejecuta la Facturación Mejorada para Vendedores: facturas y notas de crédito que The Knot o el… |
the_knot_list_order_documents | Lista los documentos adjuntos a uno o más pedidos (OR72): albaranes, etiquetas de envío, facturas de clientes y otros archivos, con id, archivo… |
the_knot_list_channels | Lista los canales de venta del marketplace (CH11), generalmente uno por sitio de país, con código y etiqueta. Usa los códigos como channel_codes en… |
the_knot_list_shipping_zones | Lista las zonas de envío activas del marketplace (SH11) con código y etiqueta, p. ej. Francia continental o Córcega. Cambios raramente: llámalo… |
the_knot_list_shipping_methods | Lista los métodos de envío activos del marketplace (SH12), p. ej. estándar, exprés o recogida, con código, etiqueta, si un número de seguimiento… |
the_knot_list_logistic_classes | Lista las clases logísticas del marketplace (SH31), los tamaños o bandas de peso que deciden los precios de envío, con código y etiqueta. Usa el código como… |
the_knot_accept_order | Acepta o rechaza las líneas de un pedido que espera aceptación (OR21). Cada línea del pedido debe estar listada. Rechazar una línea la cancela… |
the_knot_update_tracking | Establece el transportista y el número de seguimiento de un pedido (OR23). Proporciona carrier_code de the_knot_list_carriers, o carrier_name con carrier_url para… |
the_knot_ship_order | Confirma que un pedido en SHIPPING ha sido enviado (OR24); pasa a SHIPPED y se notifica al cliente. Establece el seguimiento primero con… |
the_knot_update_offers | Crea o actualiza ofertas, incluyendo precio y stock (OF24). Reemplaza cada oferta completamente: cada campo que se deja fuera se restablece (una falta de… |
the_knot_reply_thread | Responde en un hilo de mensaje (M12) al cliente o a The Knot. El mensaje se entrega de inmediato y no puede ser retirado: muestra al usuario el… |
the_knot_create_order_thread | Inicia un nuevo hilo de mensaje sobre un pedido (OR43) con el cliente, The Knot o ambos. El mensaje se entrega de inmediato: muestra al usuario el… |
the_knot_resolve_incident | Marca el incidente abierto en una línea de pedido como resuelto (OR64), una vez que se soluciona el problema del cliente. reason_code debe ser un INCIDENT_CLOSE… |
the_knot_accept_return | Acepta o rechaza una solicitud de devolución en WAITING_ACCEPTANCE (RT21). Solo cuando The Knot maneja devoluciones en la oficina de vendedor y deja el… |
the_knot_receive_return | Confirma que los bienes de una devolución aceptada han llegado a tu almacén (RT25). La devolución pasa a RECEIVED. Actúa en el marketplace en vivo… |
the_knot_import_products | Envía un archivo de producto al marketplace (P41) para crear o enriquecer productos en su catálogo. file_url es la dirección de un CSV, XLSX o XML… |
the_knot_import_offers | Importa un archivo de oferta (OF01) para crear, actualizar o eliminar ofertas en masa. El modo REPLACE elimina cada oferta que no está en el archivo, y… |
Ejemplos de mensajes
- "¿Qué pedidos de The Knot están esperando mi aceptación y cuánto valen en USD?"
- "Establece el stock de mi camino de mesa de lino SKU TK-RUN-90 a 35 y mantén el precio."
- "Agrega el seguimiento de UPS 1Z999AA10123456825 al pedido 2201234-A y confirma el envío."
- "¿Qué mensajes de clientes aún necesitan respuesta?"
- "Exporta mi catálogo y lista cada oferta con menos de 5 unidades en stock."
Preguntas frecuentes
¿Dónde obtengo la clave API de The Knot, y qué pasa si gestiono varias tiendas? En la oficina de vendedor de The Knot: tu nombre de usuario (arriba a la derecha), Mis configuraciones de usuario, clave API, luego Generar una nueva clave (o copia la clave existente). Generar una nueva clave invalida la anterior. La clave pertenece a tu usuario, no a una tienda: con varias tiendas en The Knot, establece THE_KNOT_SHOP_ID a la tienda que el conector debería usar por defecto, o pide a la IA que pase shop_id en cada llamada y trabaje en todas tus tiendas con una sola instalación. Sin ninguna de las dos, se usará tu tienda predeterminada.
¿Quién puede vender en The Knot y qué países cubre? The Knot elige las marcas que vende en su tienda de registro; no se encontró ninguna página pública de solicitud, así que pregunta a The Knot o a tu integrador para una presentación. Los vendedores envían desde Estados Unidos. El conector cubre Estados Unidos. La dirección del vendedor de este conector es la que la plataforma asigna a este minorista; ninguna guía de vendedor la nombra aún. Si tu oficina de vendedor se abre en una dirección diferente, háznoslo saber en el chat para que podamos corregirlo.
¿Puede revisar todo mi catálogo y puede cancelar pedidos, reembolsar o eliminar ofertas? Sí al catálogo: para una verificación de stock o precio en cada oferta, la IA inicia una exportación con the_knot_export_offers, espera hasta que the_knot_get_offer_export_status informe que está completa y lee los archivos con the_knot_get_offer_export_file (una exportación completa una vez al día, cambios desde una fecha una vez por minuto). Ninguna herramienta reembolsa o cancela un pedido; haz eso en la oficina de vendedor de The Knot. Rechazar una línea al aceptar un pedido la cancela de forma definitiva, por lo que la IA te muestra cada escritura y espera un sí. the_knot_import_offers se instala apagado, porque su modo REPLACE elimina cada oferta que falta en el archivo; actívalo en la página del conector solo si la IA debería usarlo.
¿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.
Próximos pasos
¿Te ha sido útil esta guía?