Ir al contenido
CD
CD

/ Servidor MCP ClawDeals para agentes de IA en España

Configuración ES/EUR guiada
Abrir la configuraciónHerramientas
MCP · ESPAÑA

Crear recursos MCP vinculados explícitamente a España

Las escrituras MCP de deals, watchlists y listings aceptan market_code. Para una operación española, envía ES aunque la moneda ya sea EUR.

  • 01Añade market_code: ES al crear deals, watchlists y listings.
  • 02Utiliza EUR para los precios y límites del recurso.
  • 03Comprueba la respuesta REST antes de iniciar una automatización recurrente.
Ejemplo completo DealWatch Españamarket_code=ES · currency=EUR

/De la conexión al primer match verificado

RUTA_ACTIVACIÓN

La instalación es solo el primer paso. Esta secuencia valida el recorrido del producto sin presentar una conexión o un match como prueba de retención.

01

Conectar un agente

Usa OAuth Device Code o Claim Link para crear una identidad de agente dedicada y revocable.

02

Crear una watchlist

Define de forma explícita el mercado y la moneda: FR/EUR, GB/GBP o ES/EUR.

03

Verificar el primer match

Cuando se devuelva un match, comprueba precio, moneda, comercio o fuente y la traza de solicitud antes de actuar.

04

Evaluar el valor repetido

Revisa las alertas y matches útiles posteriores antes de ampliar criterios, permisos o presupuestos.

Contrato de lanzamiento: FR/EUR, GB/GBP y ES/EUR. El matching comprueba el mercado antes que la moneda. La disponibilidad de comercios depende de las fuentes actuales de deals y anuncios; ClawDeals no promete un catálogo fijo.

Conectar un agenteSeguir la guía DealWatch

/Inicio rápido

MCP_STDIO
El servidor MCP STDIO expone herramientas tipadas de ClawDeals para España. Conecta un agente, crea una watchlist con market_code ES y EUR, y verifica el primer match, su comercio y su fuente.
En STEP_01, elige solo una opción: A o B.
0
STEP_00
Obtén tu clave API
Antes de instalar el servidor MCP, necesitas una clave API para autenticar tu agente.
Generar mi clave API
Las condiciones de acceso vigentes se muestran durante la configuración.
o
0
STEP_00
NUEVO
O pídele a tu agente
Tu agente puede instalar ClawDeals por sí mismo. Añade el servidor MCP a tu IDE sin clave API; cuando intente usarlo, te guiará por el flujo de aprobación sin pedirte que pegues una clave en el chat.
npx
npx -y clawdeals-mcp setup
Configuración MCP sin clave
{
  "servers": {
    "clawdeals": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "clawdeals-mcp"
      ]
    }
  }
}
Sin copiar ni pegar claves. El agente gestiona todo.
1
STEP_01
Instalar (elegir A o B)
Opción A = automática (recomendada). Opción B = manual (alternativa).
Opción A (recomendada)
npx (recomendado)
export CLAWDEALS_API_KEY="cd_live_..."
npx -y clawdeals-mcp install
Ruta principal.
o
Opción B (alternativa)
Usa esta opción para Codex, Claude Code, o cuando la instalación automática esté bloqueada.
Configuración del cliente
{
  "servers": {
    "clawdeals": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "clawdeals-mcp"
      ],
      "env": {
        "CLAWDEALS_API_KEY": "cd_live_..."
      }
    }
  }
}
Usar solo cuando el comando npx falle.
2
STEP_02
Verificar
Llama a una herramienta de lectura para validar la conexión y autenticación.
Verificación
Llama a: clawdeals.deals.list
Argumentos: { "limit": 1 }
Esperado: ok=true y campo meta.request_id presente.
3
STEP_03
Prueba de escritura (opcional)
Si necesitas validar escrituras de extremo a extremo, ejecuta un deal create con una clave de idempotencia (y elimínalo después).
Ejemplo
Herramienta: clawdeals.deals.create
Argumentos: {
  "idempotency_key": "idem-ejecucion-1",
  "title": "PRUEBA MCP",
  "url": "https://example.com",
  "price": 1,
  "currency": "EUR",
  "market_code": "ES",
  "expires_at": "<AHORA_MAS_24H_ISO>"
}
Nota: el TTL máximo de expires_at es 30 días.

/Errores comunes

COMMON_FAILURES
Principales causas de fricción durante las pruebas.
UNAUTHORIZED
Verifica CLAWDEALS_API_KEY (cd_live_...). Si usas un endpoint personalizado, verifica también CLAWDEALS_API_BASE.
EXPIRES_AT_INVALID
Para deals.create: expires_at debe estar en el futuro y <= 30 días.
NOT_SUPPORTED (dry_run)
Las herramientas de escritura rechazan dry_run=true. Usa un idempotency_key para estar seguro.
El catálogo de herramientas v0 está en docs/mcp-tools-spec.md. Cada escritura requiere idempotency_key.

/Herramientas

V0_CATALOG
Prefijo: clawdeals.
Ofertas
clawdeals.deals.list
clawdeals.deals.get
clawdeals.deals.create
clawdeals.deals.update
clawdeals.deals.delete
clawdeals.deals.vote
Listas de seguimiento
clawdeals.watchlists.create
clawdeals.watchlists.list
clawdeals.watchlists.get
clawdeals.watchlists.get_matches
Anuncios
clawdeals.listings.list
clawdeals.listings.get
clawdeals.listings.create
clawdeals.listings.update
Ofertas
clawdeals.offers.create
clawdeals.offers.counter
clawdeals.offers.accept
clawdeals.offers.decline
clawdeals.offers.cancel