El MCP de CrossUp

El MCP de CrossUp le da a tu agente las dos lecturas del SDK: leer un ítem del catálogo y pedir una recomendación. Corre en tu máquina, sobre stdio, con la clave de storefront en una variable de entorno. No escribe: un MCP lo maneja un modelo, y una escritura disparada por una alucinación no tiene vuelta atrás.

Las herramientas

Tool	Qué hace	Entrada
`get_catalog_item`	El agregado canónico de un ítem: ítem, variantes, disponibilidad	`{ item_id }`
`get_recommendations`	Una recomendación para un momento, con cada resultado ya proyectado al catálogo	`{ connection_id, surface, placement_key, context_item_id?, cart_items? }`

Las dos devuelven lo mismo que la API, con los mismos errores tipados. Un results: [] viene con su reason_codes.

Conectarlo

El servidor se llama crossup-salespilot. Necesita CROSSUP_API_TOKEN (la clave spk_…) y, si no es la URL pública, CROSSUP_BASE_URL.

Claude Code
Claude Desktop
Cursor

claude mcp add crossup-salespilot \
  -e CROSSUP_API_TOKEN=spk_… \
  -e CROSSUP_BASE_URL=https://salespilot.crossup.ai \
  -- bun run <ruta-al-repo>/apps/mcp-server/src/index.ts

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "crossup-salespilot": {
      "command": "bun",
      "args": ["run", "<ruta-al-repo>/apps/mcp-server/src/index.ts"],
      "env": {
        "CROSSUP_API_TOKEN": "spk_…",
        "CROSSUP_BASE_URL": "https://salespilot.crossup.ai"
      }
    }
  }
}

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "crossup-salespilot": {
      "command": "bun",
      "args": ["run", "<ruta-al-repo>/apps/mcp-server/src/index.ts"],
      "env": {
        "CROSSUP_API_TOKEN": "spk_…",
        "CROSSUP_BASE_URL": "https://salespilot.crossup.ai"
      }
    }
  }
}

Hoy se corre desde el repositorio, con bun. Un paquete instalable y un servidor remoto con tu cuenta de CrossUp, sin pegar una clave, vienen después: ver abajo.

Sin clave el servidor arranca igual y las dos herramientas responden configuration_error: CROSSUP_API_TOKEN is not set: el agente ve por qué falla.

El MCP de esta documentación

Esta documentación tiene su propio servidor MCP en /mcp: un agente busca y lee cualquier página sin que se la pegues. Es otro servidor: uno lee la doc, el otro habla con la API.

claude mcp add --transport http crossup-docs https://docs.crossup.ai/mcp

Qué sigue

Escalón	Qué agrega	Qué necesita
Señales y `doctor`	`record_storefront_signals`, y un `doctor` que pruebe clave, cuota y una recomendación	La misma clave
Contexto	Recursos con la doc completa y prompts de integración	Nada: esta doc
Operar	Analíticas, activar momentos, rotar claves	Una credencial de administración
Instalable desde Claude	Un servidor remoto con OAuth y tu cuenta	Lo anterior

Qué vas a ver

En tu agente, dos herramientas nuevas bajo crossup-salespilot. Pedile «traé el ítem itm_… del catálogo» y tiene que devolver el agregado con variantes y disponibilidad.

Si no lo ves

Lo que pasa	Qué hacer
`configuration_error`	Falta `CROSSUP_API_TOKEN` en el `env` del servidor, o quedó vacío
`401` en cada tool	La clave está revocada o mal copiada
El servidor aparece «caído» en la UI	Falta `bun`, o la ruta al repo no es la correcta. Corré el comando a mano en una terminal

llms.txt

Toda la documentación en un archivo.

La CLI

Las mismas dos lecturas, para una persona.

​Las herramientas

​Conectarlo

​El MCP de esta documentación

​Qué sigue

​Qué vas a ver

​Si no lo ves

llms.txt

La CLI

Las herramientas

Conectarlo

El MCP de esta documentación

Qué sigue

Qué vas a ver

Si no lo ves