---
name: conectar-subastech-mcp
description: Cómo conectar un cliente MCP (Claude, ChatGPT, Cursor, Claude Code) al servidor MCP de Subastech con OAuth 2.1 o clave de API, y qué herramientas ofrece según el plan.
---
# Conectar con el servidor MCP de Subastech

- **Endpoint MCP (Streamable HTTP)**: `https://mcp.subastech.com/mcp`
- **Tarjeta del servidor**: https://mcp.subastech.com/.well-known/mcp/server-card.json
- **Metadatos de recurso protegido (RFC 9728)**: https://mcp.subastech.com/.well-known/oauth-protected-resource
- **Servidor de autorización (OAuth 2.1, PKCE S256, DCR, CIMD)**: https://app.subastech.com/.well-known/oauth-authorization-server
- **Registro de agentes (auth.md)**: https://app.subastech.com/auth.md
- **Agente A2A**: https://mcp.subastech.com/a2a · tarjeta: https://mcp.subastech.com/.well-known/agent-card.json
- **Guía humana**: https://app.subastech.com/agentes

## Pasos

1. Añade el conector con la URL `https://mcp.subastech.com/mcp` (Claude.ai → Ajustes → Conectores; ChatGPT → Conectores; Claude Code → `claude mcp add --transport http subastech https://mcp.subastech.com/mcp`).
2. Las herramientas públicas funcionan sin iniciar sesión. Al llamar a una herramienta que requiere cuenta, el servidor responde `401` con `WWW-Authenticate` y el cliente abre el consentimiento en app.subastech.com. Cualquier cuenta de Subastech sirve, incluido el plan Radar gratuito (alta en https://app.subastech.com/registro).
3. Alternativa sin OAuth: crea una clave de API en https://app.subastech.com/cuenta/integraciones y envíala como `Authorization: Bearer <clave>`. Las claves tienen scopes (por defecto solo lectura) y caducidad.

## Herramientas

- **Públicas (sin token)**: `buscar_subastas`, `subasta`, `buscar_por_codigo`, `resultados_recientes`, `estadisticas_publicas`, `explicar_concepto`, `planes`, y `search` / `fetch` (compatibles con la búsqueda profunda de ChatGPT).
- **Con cuenta** (scope entre paréntesis): `analisis_subasta`, `informe`, `similares`, `mercado` (`informes:read`); `recomendaciones`, `mi_cuenta` (`cuenta:read`); `alertas_listar`, `alertas_previsualizar` (`alertas:read`), `alertas_crear`, `alertas_editar`, `alertas_eliminar`, `alertas_activar` (`alertas:write`); `favoritos_listar` (`favoritos:read`), `favoritos_anadir`, `favoritos_quitar` (`favoritos:write`); `notas_simples_listar`, `nota_simple_estado` (`notas:read`), `nota_simple_pedir` (`notas:write`).
- Un token sin el scope necesario recibe `403` con `WWW-Authenticate: Bearer error="insufficient_scope"`: pide al usuario que vuelva a autorizar con ese scope.

## Qué devuelve cada herramienta según el plan

Las herramientas responden exactamente como la web: los datos del BOE siempre; el scoring, las cargas, el ROI y la valoración solo con plan Pro o superior; los intervinientes con Team o superior. Cuando algo está cerrado, la herramienta devuelve en lugar de datos un objeto `locked` legible por máquina con `feature` (clave de la función), `requiredPlan` (clave, nombre y precio mensual) y `upgradeUrl` (https://app.subastech.com/precios): explícaselo al usuario y enlaza `upgradeUrl`; no lo interpretes como error.

## Buenas prácticas

- Usa `search` / `fetch` o `buscar_subastas` / `subasta` para localizar y leer fichas; cita siempre la `url` canónica.
- Respeta los límites de uso (`429` con `Retry-After`) y no reintentes en bucle.
- Nunca pidas al usuario su contraseña: el flujo es OAuth o clave de API.
- Parte del análisis de los informes se genera con IA; transparencia en https://app.subastech.com/ia