Saltar al contenido
Menú de documentos

MCP

Conectar una aplicación de IA

Conecte Claude, ChatGPT, Cursor, VS Code o cualquier cliente MCP a TradeCatalog con su propio inicio de sesión.

TradeCatalog ejecuta un servidor remoto Model Context Protocol (MCP). Conéctelo a su aplicación de IA y pregunte cosas como:

  • “¿Cuánto paga Oakfield Joinery por 20 cajas de HX-8510?”
  • “¿Hay nuevos pedidos hoy?”
  • “¿Quién cambió el descuento de Brookside y cuándo?”
  • “Encuéntrame un tornillo hexagonal de zinc, M10, y mi precio para él.” (como comprador)

Cómo funcionaEnlace a esta sección#

ConfiguraciónValor
URL del servidorhttps://tradecatalog.app/mcp
TransporteHTTP transmisible
Inicio de sesiónOAuth 2.1: inicie sesión con su inicio de sesión normal de TradeCatalog y elija Permitir
AccesoAcceso de lectura, más acceso de escritura opcional con revisión firmada para cambios importantes.
Quién actúaUsted. Ve exactamente lo que puede ver en TradeCatalog.
  • Personal ven los datos permitidos por su rol y alcance de cliente. El personal de ventas puede cubrir solo clientes o regiones asignados; los cambios en el catálogo, precios, pedidos y equipo requieren la permisión correspondiente.
  • Compradores ven los proveedores de los que compran, con sus propios precios y sus propios pedidos solo.

Las invitaciones al equipo, la configuración del espacio de trabajo y el acceso a la API siguen las permisos actuales del personal del proveedor. La eliminación del espacio de trabajo permanece solo para el propietario. Los compradores seleccionan su propia cuenta de cliente para cada pedido. Las conexiones existentes permanecen de solo lectura hasta que se reautorizan.

Cada llamada a herramienta se revisa con las mismas reglas que la aplicación. Vea herramientas MCP para ver qué hace cada herramienta.

Habilidades de flujo de trabajoEnlace a esta sección#

El complemento de TradeCatalog incluye diez habilidades enfocadas con su conexión MCP. Cada descripción de habilidad indica al app de IA cuándo se aplica el flujo de trabajo; sus instrucciones explican qué herramientas usar, qué leer primero y cómo manejar confirmaciones y resultados incompletos.

HabilidadCuándo usarla
tradecatalogConectar, crear un espacio de trabajo para proveedores o seleccionar un proveedor y cuenta de cliente.
tradecatalog-catalogueCrear, editar, ocultar, mostrar y organizar productos o abrir la carga de medios de productos.
tradecatalog-pricingExplicar precios acordados y ajustar términos, o redactar y publicar cambios en precios de lista.
tradecatalog-importsVerificar y importar filas de productos, cuentas de clientes o precios acordados.
tradecatalog-customersDar de alta a clientes, invitar a compradores y gestionar el acceso o listas de productos aprobados.
tradecatalog-ordersBuscar precios de compradores, preparar o repetir un pedido, descargar una lista de precios permitida o seguir un pedido.
tradecatalog-fulfilmentRevisar pedidos de proveedores y reconocer, enviar, completar o cancelarlos.
tradecatalog-updatesLeer actualizaciones de compradores o publicar anuncios de proveedores con opciones de horario y correo explícito.
tradecatalog-workspaceGestionar configuraciones empresariales, invitaciones de personal y transferencias autorizadas de exportación o API.
tradecatalog-supportLeer, preparar o enviar una solicitud de soporte de proveedor o seguimiento a Happy Webs.

Otros agentes pueden descubrir las mismas guías desde el índice de habilidades público. Las habilidades guían el flujo de trabajo; el servidor aún comprueba el acceso de cuenta y requiere confirmación firmada para cambios importantes.

Regístrese y pague con un agenteEnlace a esta sección#

Puede conectar antes de tener un espacio de trabajo. La conexión abre la página de inicio de sesión de TradeCatalog, donde una nueva dirección de correo electrónico crea su inicio de sesión después de que la verifique. Complete la verificación allí, luego regrese a su app de IA. Nunca comparta códigos de inicio de sesión o detalles de pago en chat.

Pida al agente que cree su espacio de trabajo para proveedores. Pide su nombre de empresa, moneda de productos, zona horaria y país, luego usa create_workspace para su confirmación. Su espacio de trabajo comienza con una prueba Pro de 14 días sin tarjeta. No es una suscripción pagada. Cuando termine la prueba, regresa a Free, hasta 100 productos, a menos que se actualice.

Para agentes cuyo host permite facturación por suscripción de software, conéctese a https://tradecatalog.app/mcp/account. Utiliza el mismo inicio de sesión de TradeCatalog, los ámbitos de OAuth y las membresías de espacio de trabajo, con todas las herramientas ordinarias más open_billing. Cuando solicite pagar o gestionar su suscripción, esta herramienta exclusiva del propietario abre la página de facturación segura del espacio de trabajo. Elija facturación mensual o anual y confirme el pago en Stripe. Los suscriptores existentes pueden gestionar su suscripción allí. El agente puede revisar get_settings después; abrir un enlace no es prueba de que el pago se haya completado.

Los complementos de ChatGPT usan https://tradecatalog.app/mcp, que no expone herramientas de facturación. Las directrices para complementos de OpenAI actualmente excluyen la venta de suscripciones de software y la promoción de actualizaciones. El registro gratuito y la creación de espacios de trabajo están disponibles a través de esa conexión. Los agentes pueden preparar solicitudes de órdenes comerciales. Los pagos opcionales de clientes requieren que el comprador abra la página de ordenes iniciada sesión, apruebe el cargo confirmado por el proveedor y complete Stripe Checkout. La aprobación de un agente de una orden nunca es aprobación de pago.

Claude (web, escritorio y móvil)Enlace a esta sección#

  1. Abra Configuración, luego Conectores y elija Agregar conector personalizado.
  2. Nómbralo "TradeCatalog" y pega https://tradecatalog.app/mcp.
  3. Elija Conectar. Inicie sesión en TradeCatalog con su código de correo electrónico y elija Permitir.

Los conectores que agregue en la web también aparecen en Claude Desktop y las aplicaciones móviles. En planes de Equipo y Empresa, es posible que un propietario deba agregar el conector primero para la organización.

Claude CodeEnlace a esta sección#

bash
claude mcp add --transport http tradecatalog https://tradecatalog.app/mcp

Luego ejecute /mcp en Claude Code y elija tradecatalog para iniciar sesión.

ChatGPTEnlace a esta sección#

  1. Abra Configuración, luego Apps & Conectores. Si su plan lo requiere, active Modo de desarrollador bajo Avanzado.
  2. Cree un conector con la URL https://tradecatalog.app/mcp y autenticación OAuth.
  3. Inicie sesión en TradeCatalog y elija Permitir.

CursorEnlace a esta sección#

Agregue esto a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

json
{
  "mcpServers": {
    "tradecatalog": { "url": "https://tradecatalog.app/mcp" }
  }
}

Cursor abre la página de inicio de sesión de TradeCatalog la primera vez que lo use.

VS CodeEnlace a esta sección#

Agregue esto a .vscode/mcp.json:

json
{
  "servers": {
    "tradecatalog": { "type": "http", "url": "https://tradecatalog.app/mcp" }
  }
}

Otros clientesEnlace a esta sección#

Cualquier cliente que admita MCP remoto a través de HTTP con OAuth funciona. Para clientes que solo ejecutan servidores locales (stdio), use el puente mcp-remote:

json
{
  "mcpServers": {
    "tradecatalog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tradecatalog.app/mcp"]
    }
  }
}

¿Construyendo su propio cliente? Consulte OAuth para clientes MCP.

Desconectar una aplicaciónEnlace a esta sección#

Vea cada aplicación de IA que haya aprobado, y desconecte cualquiera de ellas, en tradecatalog.app/oauth/connections. Eliminar el conector en su aplicación de IA detiene que esa aplicación lo use. Desconectar aquí también revoca su acceso en nuestro lado, de inmediato.

MCP o la API REST?Enlace a esta sección#

MCPAPI REST
ParaPersonas que chattean en una aplicación de IASus propios sistemas y scripts
Inicia sesión comoCada persona, con su propio inicio de sesiónEl espacio de trabajo, con una clave API del propietario
Los compradores pueden usarloSí, con sus propios preciosNo
Puede cambiar datosSí, con alcance de escritura y cambios revisadosSí, con una clave de lectura y escritura
Configurado porCada persona, en su aplicación de IAEl propietario, en Configuración
DocsHerramientasAPI REST