# 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](https://modelcontextprotocol.io) (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 funciona

| Configuración    | Valor                                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------------- |
| URL del servidor | `https://tradecatalog.app/mcp`                                                                     |
| Transporte       | HTTP transmisible                                                                                  |
| Inicio de sesión | OAuth 2.1: inicie sesión con su inicio de sesión normal de TradeCatalog y elija **Permitir**       |
| Acceso           | Acceso de lectura, más acceso de escritura opcional con revisión firmada para cambios importantes. |
| Quién actúa      | Usted. 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](/docs/mcp/tools) para ver qué hace cada herramienta.

## Habilidades de flujo de trabajo

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.

| Habilidad                 | Cuándo usarla                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `tradecatalog`            | Conectar, crear un espacio de trabajo para proveedores o seleccionar un proveedor y cuenta de cliente.                    |
| `tradecatalog-catalogue`  | Crear, editar, ocultar, mostrar y organizar productos o abrir la carga de medios de productos.                            |
| `tradecatalog-pricing`    | Explicar precios acordados y ajustar términos, o redactar y publicar cambios en precios de lista.                         |
| `tradecatalog-imports`    | Verificar y importar filas de productos, cuentas de clientes o precios acordados.                                         |
| `tradecatalog-customers`  | Dar de alta a clientes, invitar a compradores y gestionar el acceso o listas de productos aprobados.                      |
| `tradecatalog-orders`     | Buscar precios de compradores, preparar o repetir un pedido, descargar una lista de precios permitida o seguir un pedido. |
| `tradecatalog-fulfilment` | Revisar pedidos de proveedores y reconocer, enviar, completar o cancelarlos.                                              |
| `tradecatalog-updates`    | Leer actualizaciones de compradores o publicar anuncios de proveedores con opciones de horario y correo explícito.        |
| `tradecatalog-workspace`  | Gestionar configuraciones empresariales, invitaciones de personal y transferencias autorizadas de exportación o API.      |
| `tradecatalog-support`    | Leer, 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](https://tradecatalog.app/.well-known/agent-skills/index.json). 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 agente

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](https://developers.openai.com/plugins/plugin-guidelines) 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)

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 Code

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

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

## ChatGPT

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**.

## Cursor

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 Code

Agregue esto a `.vscode/mcp.json`:

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

## Otros clientes

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](/docs/mcp/oauth).

## Desconectar una aplicación

Vea cada aplicación de IA que haya aprobado, y desconecte cualquiera de ellas, en [tradecatalog.app/oauth/connections](/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?

|                               | MCP                                              | API REST                                                 |
| ----------------------------- | ------------------------------------------------ | -------------------------------------------------------- |
| Para                          | Personas que chattean en una aplicación de IA    | Sus propios sistemas y scripts                           |
| Inicia sesión como            | Cada persona, con su propio inicio de sesión     | El espacio de trabajo, con una clave API del propietario |
| Los compradores pueden usarlo | Sí, con sus propios precios                      | No                                                       |
| Puede cambiar datos           | Sí, con alcance de escritura y cambios revisados | Sí, con una clave de lectura y escritura                 |
| Configurado por               | Cada persona, en su aplicación de IA             | El propietario, en Configuración                         |
| Docs                          | [Herramientas](/docs/mcp/tools)                  | [API REST](/docs/api)                                    |