---
title: "Conecta tu IA a Subastech"
description: "Cómo conectar Claude, ChatGPT, Claude Code u otro cliente MCP y agentes A2A a Subastech: endpoints, autenticación OAuth 2.1 o clave de API, herramientas públicas y por plan."
canonical: "https://app.subastech.com/agentes"
---

# Conecta tu IA a Subastech

> Fuente: BOE · Subastech · Canónica: https://app.subastech.com/agentes

Subastech ofrece a cualquier asistente de IA (Claude, ChatGPT, Claude Code, Cursor u otros clientes MCP) y a agentes A2A acceso a las subastas judiciales de inmuebles del BOE en España. Los datos públicos del BOE (dirección, valores, fechas, resultado oficial y la URL de la ficha) no requieren cuenta; el scoring, el veredicto, las cargas, la rentabilidad, la valoración y los informes responden según el plan de tu cuenta, igual que en la web.

## Endpoints

| Canal | URL | Para qué |
| --- | --- | --- |
| Servidor MCP (Streamable HTTP) | https://mcp.subastech.com/mcp | Herramientas para Claude, ChatGPT, Claude Code, Cursor… |
| Server card MCP | https://mcp.subastech.com/.well-known/mcp/server-card.json | Descripción del servidor y sus herramientas |
| Agente A2A (JSON-RPC) | https://mcp.subastech.com/a2a | Agentes que hablan Agent-to-Agent |
| Agent card A2A | https://mcp.subastech.com/.well-known/agent-card.json | Skills, esquemas de seguridad y modos |
| API pública v1 (JSON) | https://app.subastech.com/v1/subastas | Datos del BOE sin autenticación, CORS abierto |
| OpenAPI 3.1 | https://app.subastech.com/openapi.json | Contrato de la API v1 |
| Catálogo de APIs (RFC 9727) | https://app.subastech.com/.well-known/api-catalog | Descubrimiento |
| Skills para agentes | https://app.subastech.com/.well-known/agent-skills/index.json | Guías paso a paso (SKILL.md) |
| auth.md | https://app.subastech.com/auth.md | Cómo autenticarse: OAuth 2.1, claves de API, registro de agentes |
| Metadatos OAuth | https://app.subastech.com/.well-known/oauth-authorization-server | Servidor de autorización |
| Recurso protegido (PRM) | https://mcp.subastech.com/.well-known/oauth-protected-resource | Metadatos del recurso MCP |
| Guía para modelos | https://app.subastech.com/llms.txt · https://app.subastech.com/llms-full.txt | llms.txt |

Cualquier página pública de la web también existe en Markdown: pide la misma URL con la cabecera `Accept: text/markdown`.

## Conectar tu IA

### Instalación en un clic

- **Claude** (claude.ai, escritorio y móvil): https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Subastech&connectorUrl=https%3A%2F%2Fmcp.subastech.com%2Fmcp — abre el diálogo «Add custom connector» con el nombre y la URL ya rellenados; tú revisas y confirmas (el enlace no instala nada por su cuenta ni concede ningún permiso).
- **Cursor**: cursor://anysphere.cursor-deeplink/mcp/install?name=subastech&config=eyJ1cmwiOiJodHRwczovL21jcC5zdWJhc3RlY2guY29tL21jcCJ9
- **VS Code**: `code --add-mcp "{\"name\":\"subastech\",\"type\":\"http\",\"url\":\"https://mcp.subastech.com/mcp\"}"`

### Claude (claude.ai, escritorio y móvil)

1. Con el enlace de arriba, o a mano: **Customize → Connectors** (https://claude.ai/customize/connectors) → «+» → **Add custom connector**.
2. URL del servidor: `https://mcp.subastech.com/mcp`.
3. En **Team** y **Enterprise** el conector lo añade primero un propietario o administrador en **Organization settings → Connectors** (https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Subastech&connectorUrl=https%3A%2F%2Fmcp.subastech.com%2Fmcp abre ese diálogo ya relleno); después cada persona pulsa «Connect» desde Customize → Connectors.
4. Al usar una herramienta que requiera cuenta, Claude te pedirá autorizar el acceso en https://app.subastech.com/oauth/authorize con tu sesión de Subastech (OAuth 2.1 con PKCE; no compartas nunca tu contraseña con el asistente).

Los conectores personalizados funcionan en los planes Free, Pro, Max, Team y Enterprise (en Free, uno solo).

### ChatGPT

1. Activa el **modo desarrollador**: Ajustes (Settings) → **Security and login** → **Developer mode**. Está disponible en Plus, Pro, Business, Enterprise y Edu en la web; dentro de un espacio de trabajo, la política del administrador puede desactivarlo.
2. Ve a https://chatgpt.com/plugins, pulsa «+», pon un nombre y una descripción y, en **Connection**, indica la URL con la ruta `/mcp`: `https://mcp.subastech.com/mcp`.
3. Autoriza la conexión cuando se te pida (mismo flujo OAuth). ChatGPT usa las herramientas `search` y `fetch` para la investigación en profundidad y el resto en el chat.

OpenAI ya no llama «conectores» a esto: hoy son plugins (apps MCP) y viven detrás del modo desarrollador. Si no ves la opción, es que tu cuenta o tu espacio de trabajo no la tiene activada.

### Claude Code

```
claude mcp add --transport http subastech https://mcp.subastech.com/mcp
```

Al primer uso se abre el navegador para autorizar (redirección a tu propio ordenador, `http://localhost/callback`).

### Cursor y VS Code

- Cursor: el enlace de un clic de arriba, o un servidor MCP de tipo HTTP con la URL `https://mcp.subastech.com/mcp`.
- VS Code: `code --add-mcp "{\"name\":\"subastech\",\"type\":\"http\",\"url\":\"https://mcp.subastech.com/mcp\"}"`, o **MCP: Add Server** desde la paleta de comandos.

### Otros clientes MCP (Windsurf, MCP Inspector, scripts propios)

Configura un servidor MCP de tipo HTTP con la URL `https://mcp.subastech.com/mcp`. Si el cliente no soporta OAuth, crea una clave de API en https://app.subastech.com/cuenta/integraciones y envíala como `Authorization: Bearer sbk_…`. Sin credenciales, las herramientas públicas funcionan igualmente.

## Claves de API

- Se crean y revocan en https://app.subastech.com/cuenta/integraciones (hasta 10 activas; caducidad 30/90/365 días o sin caducidad).
- Cada clave lleva sus permisos (scopes); por defecto solo lectura (`*:read`). La clave se muestra una sola vez.
- Sirven en el MCP, en el agente A2A y en la API. Los tokens OAuth se emiten en https://app.subastech.com/oauth/token.

## Herramientas MCP

### Públicas (sin cuenta)

| Herramienta | Qué hace |
| --- | --- |
| `buscar_subastas` | Busca por provincia, municipio, tipo, precio, superficie, texto libre, radio o bbox (hasta 20 por página) |
| `subasta` | Ficha pública por id o URL: datos del BOE, resumen citable, lotes y resultado oficial |
| `buscar_por_codigo` | Localiza por referencia BOE, catastral u otros identificadores |
| `resultados_recientes` | Últimas adjudicaciones con precio de remate del certificado del BOE |
| `estadisticas_publicas` | Cifras del catálogo, provincias, tipos y municipios |
| `explicar_concepto` | Glosario de subastas judiciales (sin LLM) |
| `planes` | Planes y precios |
| `search` / `fetch` | Contrato de investigación en profundidad de ChatGPT |

### Con cuenta (según plan)

| Herramienta | Permiso | Qué hace |
| --- | --- | --- |
| `analisis_subasta` | `informes:read` | Veredicto y ejes del scoring (Pro o superior; si no, devuelve `locked` con el plan necesario) |
| `informe` | `informes:read` | Informe de una subasta con las secciones de tu plan; los niveles desbloqueados se sirven, el resto remite a la web |
| `similares`, `recomendaciones`, `mercado` | `informes:read` / `cuenta:read` | Subastas parecidas, recomendaciones personales y estadísticas de mercado (Pro o superior) |
| `alertas_listar` / `previsualizar` / `crear` / `editar` / `eliminar` / `activar` | `alertas:read` / `alertas:write` | Alertas de nuevas subastas por correo |
| `favoritos_listar` / `anadir` / `quitar` | `favoritos:read` / `favoritos:write` | Favoritos |
| `mi_cuenta` | `cuenta:read` | Plan, cuotas y permisos del token |
| `notas_simples_listar`, `nota_simple_estado`, `nota_simple_pedir` | `notas:read` / `notas:write` | Nota simple registral (20 €): el pago se confirma siempre en el navegador |

Cuando una herramienta está fuera de tu plan responde un candado legible por máquina (`locked`) con la función, el plan mínimo y la URL para ampliar. Ninguna herramienta consume cuota ni realiza pagos por ti.

## Skills

- buscar-subastas-boe: https://app.subastech.com/.well-known/agent-skills/buscar-subastas-boe/SKILL.md
- interpretar-subasta-judicial: https://app.subastech.com/.well-known/agent-skills/interpretar-subasta-judicial/SKILL.md
- conectar-subastech-mcp: https://app.subastech.com/.well-known/agent-skills/conectar-subastech-mcp/SKILL.md
- crear-alerta-subastech: https://app.subastech.com/.well-known/agent-skills/crear-alerta-subastech/SKILL.md
- comprar-informe-o-nota-simple: https://app.subastech.com/.well-known/agent-skills/comprar-informe-o-nota-simple/SKILL.md

## Agente A2A

Endpoint JSON-RPC https://mcp.subastech.com/a2a (versión 1.0; también acepta los nombres de método de la 0.3). Skills públicas: buscar-subastas, ficha-subasta, resultados-boe, estadisticas-publicas, explicar-concepto y planes. Con OAuth o clave de API: analisis-subasta, informe, alertas, favoritos y recomendaciones. Cada respuesta incluye los datos del BOE, la URL canónica de la ficha y, si procede, el candado con el plan necesario.

## Límites y buenas prácticas

- Cita siempre la URL canónica de la ficha (`url`) cuando muestres una subasta.
- `discount` es aritmética del BOE (tasación frente a valor de subasta), no un veredicto. No infieras scoring, cargas ni rentabilidad: si no vienen, es que requieren cuenta.
- Respeta los `429` con `Retry-After`. Anónimo: 120 peticiones/min por IP; con token, según plan.
- Parte del análisis de los informes se genera con IA: https://app.subastech.com/ia.

Cuenta gratuita: https://app.subastech.com/registro · Planes: https://app.subastech.com/precios · Esta guía: https://app.subastech.com/agentes

---
Página canónica: https://app.subastech.com/agentes  ·  API JSON: https://app.subastech.com/openapi.json  ·  MCP: https://mcp.subastech.com/mcp
El scoring, el veredicto, las cargas, la rentabilidad y la valoración requieren cuenta: https://app.subastech.com/precios (registro gratuito: https://app.subastech.com/registro)
Guía para agentes: https://app.subastech.com/agentes · OpenAPI: https://app.subastech.com/openapi.json · llms.txt: https://app.subastech.com/llms.txt