Herramientas MCP

Las herramientas usan su rol de espacio de trabajo actual en cada llamada. Las conexiones de solo lectura siguen funcionando. Hacer cambios requiere el alcance adicional tradecatalog:write. Las acciones consecuentes muestran una tarjeta de Confirmar/Cancelar en clientes compatibles, con un enlace de revisión iniciado sesión como recurso de respaldo, y se ejecutan solo después de que usted apruebe. Los resultados son texto JSON; el formato original de las herramientas de búsqueda muestra precios, mientras que las herramientas de gestión usan unidades menores de moneda enteras y puntos básicos (100 = 1%).

La mayoría de las herramientas toman un workspace: la dirección del espacio de trabajo desde list_workspaces, como northgate. La aplicación de IA normalmente llama a list_workspaces primero por sí misma.

Cuando una herramienta no puede hacer algo, por ejemplo, si usted no es personal en ese espacio de trabajo o el cliente no existe, devuelve un mensaje de error que la aplicación de IA puede leer y actuar, como "No hay cliente "OAK99". Use list_customers para códigos de cuenta."

Cuando el catálogo de un proveedor solo tiene precios para el cliente seleccionado, set_basket_quantity, send_order y reorder devuelven ese error. get_basket, list_buyer_orders y get_buyer_order siguen funcionando, por lo que los pedidos existentes siguen siendo legibles. El proveedor lo configura en Configuración, y puede anularlo por cliente (ordering: follow, prices_only o can_order en update_customer).

Cuando el proveedor ha desactivado las descargas de listas de precios, download_my_price_list devuelve un error y el enlace CSV iniciado sesión responde con 403.

quote_configured_product lee el precio de línea del cuenta de comprador seleccionado para productId, qty y configuration opcionales, sin cambiar un carrito. set_configured_basket_line crea una línea separada o actualiza/elimina su lineId exacto (qty: 0 lo elimina). Proporcione la especificación completa en ediciones. Vuelva a leer get_basket después de los cambios y revise todas las selecciones, medidas y precios actuales antes de send_order. Un cambio en la especificación o versión de precios invalida la revisión anterior incluso si el total no cambia.

El personal puede usar save_product_family para metadatos de variantes compartidas y save_ordering_draft para un borrador revisado de precios avanzados. Lo último requiere Pro y permiso de precios globales; la publicación usa la revisión de cambio de precio existente. Las importaciones de productos aceptan definiciones opcionales de familia, incremento de orden y ordenación. Vea configuración de catálogo de comercio.

Configurar un espacio de trabajo de proveedorEnlace a esta sección#

create_workspace crea un espacio de trabajo de proveedor Free para la persona iniciada sesión y verificada, después de que confirme una tarjeta. Pida el nombre de la empresa, la moneda de producto, la zona horaria y el país. La persona se convierte en su propietario. No se crea ninguna suscripción o pago. Luego llame a list_workspaces nuevamente y use la dirección devuelta para la configuración de producto y cliente. Los inicios de sesión de revisor y invitado no pueden crear espacios de trabajo.

Free incluye hasta 100 productos y aplicaciones de IA conectadas. Cada SKU cuenta, incluidos productos ocultos e inactivos. Al alcanzar el límite, los productos existentes, ediciones y pedidos siguen funcionando; crear más productos no está disponible. Explique este derecho sin promover actualizaciones ni iniciar el proceso de suscripción en el complemento.

list_workspacesEnlace a esta sección#

Espacios de trabajo de proveedor en los que trabaja, y portales de comercio donde compra. Comience aquí.

¿Quién: cualquiera iniciado sesión. Entradas: ninguna.

{
  "supplierWorkspaces": [
    { "workspace": "northgate", "name": "Northgate Fixings", "role": "owner" }
  ],
  "tradePortals": [
    {
      "workspace": "hartley-timber",
      "supplier": "Hartley Timber",
      "yourAccount": "Northgate Fixings",
      "accountId": "example-account-id"
    }
  ]
}

search_productsEnlace a esta sección#

Buscar un catálogo por SKU, referencia del fabricante, nombre, marca o categoría. Devuelve hasta 25 productos.

¿Quién: personal y compradores.

• Compradores siempre ven los precios de su propia cuenta y solo productos activos que pueden ver.
• Personal ven precios de lista y todos los productos, o la vista de un cliente nombrado.

{
  "supplier": "Northgate Fixings",
  "pricesFor": "Oakfield Joinery",
  "taxNote": "ex VAT",
  "products": [
    {
      "sku": "HX-8510",
      "name": "Hex bolt M10 x 50 zinc",
      "unit": "Box of 100",
      "availability": "in_stock",
      "price": "£15.73",
      "listPrice": "£18.50",
      "why": "Brand discount −15%"
    }
  ]
}

Cuando el proveedor ha desactivado Mostrar al cliente el precio estándar junto a su propio precio, los resultados de un comprador omiten listPrice y why, y get_buyer_product, get_basket y get_buyer_order no llevan precio de lista o razón del precio tampoco.

Pruebe: "Buscar Northgate para tornillos hexagonales M10 a los precios de Oakfield."

download_products_csv y download_my_price_listEnlace a esta sección#

Estas herramientas devuelven un enlace a una descarga CSV existente en TradeCatalog. Ábralo mientras está iniciado sesión; devolver un enlace no descarga ni envía el archivo al chat.

• download_products_csv: el personal elige workspace para descargar la lista de productos de ese proveedor.
• download_my_price_list: los compradores eligen workspace y el código exacto accountId de list_workspaces para descargar solo los precios acordados de esa cuenta.
• download_my_price_list_pdf: la misma cuenta, como PDF con marca de agua (Pro). Ambas herramientas están bloqueadas cuando el proveedor ha desactivado las descargas de listas de precios.

check_priceEnlace a esta sección#

Cuánto paga un cliente por un SKU en una cantidad, y qué conjunto de reglas estableció el precio.

Quién: solo personal.

{
  "customer": "Oakfield Joinery",
  "sku": "HX-8510",
  "name": "Hex bolt M10 x 50 zinc",
  "qty": 20,
  "unitPrice": "£15.73",
  "lineTotal": "£314.60",
  "listPrice": "£18.50",
  "why": "Brand discount −15%",
  "taxNote": "ex VAT"
}

Prueba: «¿Qué paga OAK01 por 20 de HX-8510 y por qué?»

list_customersEnlace a esta sección#

Clientes comerciales con códigos de cuenta, correos electrónicos de contacto, estado activo y descuento de cuenta.

Quién: solo personal. Entradas: workspace.

[
  {
    "accountCode": "OAK01",
    "name": "Oakfield Joinery",
    "email": "accounts@oakfieldjoinery.co.uk",
    "active": true,
    "discount": "5%"
  }
]

Prueba: «¿Qué clientes no tienen descuento establecido?»

list_ordersEnlace a esta sección#

Últimas órdenes, en orden descendente, hasta 50.

¿Quién: el personal puede ver todas las órdenes de los clientes; los compradores solo ven las de su cuenta.

[
  {
    "reference": "SO-000142",
    "customer": "Oakfield Joinery",
    "status": "new",
    "total": "£314.60",
    "poNumber": "PO-88231",
    "placed": "2026-09-27T07:48:12.000Z"
  }
]

Pruebe: «¿Hay nuevos pedidos desde ayer? Totalícelos por cliente.»

recent_activityEnlace a esta sección#

El registro de actividades de cambios en clientes, descuentos y precios, más recientes primero, hasta 50 entradas. Opcionalmente, el historial de un cliente.

Quién: solo personal de staff. Los propietarios y administradores ven todo el registro; el resto del personal ve solo los cambios relacionados con clientes que pueden ver.

[
  {
    "when": "2026-09-26T14:21:03.000Z",
    "who": "Jo Hartley",
    "customer": "Oakfield Joinery",
    "what": "Set Northgate brand discount to 15% (was 12.5%)"
  }
]

Pruebe: «¿Quién cambió los precios de Oakfield este mes?»

NotasEnlace a esta sección#

• Los nombres de los clientes y los códigos de cuenta se coinciden sin tener en cuenta mayúsculas y minúsculas. Es más seguro utilizar un código de cuenta exacto.
• list_workspaces devuelve los valores del comprador accountId. Proporcione el correspondiente a search_products y a cada acción del comprador. Nunca adivine entre cuentas.
• Busque productos en la página con offset y el nextOffset devuelto. Utilice list_buyer_orders para una cuenta de comprador seleccionada explícitamente.

Cambios y confirmacionesEnlace a esta sección#

Ediciones del carrito del comprador, marcar actualizaciones como leídas y crear borradores de precios no publicados se ejecutan inmediatamente al autorizarlos. Otros escritos devuelven awaiting_confirmation, un actionId y un reviewUrl. Los clientes de ChatGPT y compatibles muestran una tarjeta con el espacio de trabajo exacto y el cambio propuesto: elija Confirmar o Cancelar sin salir de la conversación. Los clientes sin tarjetas utilizan el enlace de revisión iniciado sesión. Las revisiones caducan después de 15 minutos y se ejecutan como máximo una vez. Desconectar la aplicación o eliminar el acceso requerido al espacio de trabajo invalida las revisiones pendientes. Los carritos de pedidos modificados y las previas de cambios de precio requieren una nueva revisión. Use get_action_status para leer el resultado; una solicitud pendiente no es una acción completada.

El asistente decide_action está disponible solo para la interfaz de tarjeta. Su capacidad de confirmación de corta duración está oculta de la salida del modelo y está vinculada a la persona solicitante, la conexión OAuth y la propuesta. Un mensaje de modelo o un ID de acción no pueden aprobar un cambio. Las mismas comprobaciones de rol, instantánea, caducidad y uso único se aplican a las aprobaciones de tarjeta y navegador.

Cada acción del comprador requiere su exacto accountId. Para send_order, copie el fingerprint del carrito en expectedBasket, junto con expectedTotal. Los precios, cantidades y cuenta se verifican nuevamente antes de enviarlos.

Use las herramientas de transmisión separadas para el trabajo que finaliza en la aplicación iniciada sesión: los propietarios usan open_api_key_settings, download_workspace_export y open_logo_settings; el personal usa open_import_page, open_product_image_upload y open_product_file_manager. Las dos transmisiones de producto requieren un productId verificado por el inquilino. Los enlaces de archivo de get_product y get_buyer_product requieren su navegador iniciado sesión; devolver un enlace no ha leído el documento o completado una carga, eliminación, exportación o creación de credenciales. La administración de la plataforma nunca se delega a través de OAuth.

Lista de clientes aprobadosEnlace a esta sección#

El personal usa get_customer para leer el alcance del catálogo del cliente y los productos aprobados. set_catalogue_scope cambia entre all y approved. approve_products agrega productos explícitos o una categoría; unapprove_product elimina un producto. Estos cambios requieren revisión del cliente exacto, lista actual y productos afectados. La membresía en categorías se vuelve a verificar en la confirmación. Los compradores permanecen limitados a su cuenta seleccionada y productos visibles para esa cuenta.

Herramientas para proveedores y compradoresEnlace a esta sección#

create_workspace está disponible incluso cuando list_workspaces está vacío. Crea un espacio de trabajo de proveedor Free y membresía del propietario solo después de la confirmación. La conexión /mcp/account opcional también ofrece open_billing: los propietarios pueden abrir facturación segura de suscripción y confirmar el pago en Stripe, luego revisar get_settings para el estado resultante. Los enlaces de facturación no completan pagos. La conexión estándar /mcp usada por el complemento de ChatGPT no expone open_billing. Vea registro y facturación.

MCP 3.0.0 expone cada operación llamable por modelo de forma anticipada con su propio nombre, descripción, esquema de entrada y anotaciones. Las herramientas anteriores bulk_products y open_workspace_action se han reemplazado por las operaciones individuales que se muestran a continuación; actualice las definiciones de herramientas de su cliente después de actualizar. La respuesta del MCP tools/list es el esquema de entrada autoritativo. Las siguientes herramientas complementan a las herramientas de búsqueda anteriores:

La entrada de pedidos del personal usa preview_customer_order luego create_customer_order revisado con precios exactos y un UUID de reintento. El procesamiento usa set_order_status con note público, internalNote/correctionReason privado y expectedRevision. set_order_delivery revisado registra un método de entrega visible para el cliente y un transportista opcional, referencia y enlace HTTPS. Estas herramientas siguen los permisos y alcance actual de los miembros. Vea Pedidos para los campos y comportamiento.