Llevo desde finales de 2025 catalogando mi colección de retroinformática en RetroCatálogo, el sistema que creé y que mantengo desde entonces. Tenéis un artículo en este mismo blog: RetroCatálogo: el refugio de tus memorias digitales. Yo ya llevo más de un centenar de artículos dados de alta: mis Spectrum, los Amstrad, las consolas, hasta los libros. Y lo que más me gusta de la plataforma es que cada pieza lleva su ficha con fotos, número de serie, estado de conservación y hasta dónde la tengo guardada.
El problema es que mis asistentes de IA no tenían forma de verla. Si yo le preguntaba a Claude, a ChatGPT o a Codex «¿qué tengo guardado del Amstrad CPC?», se quedaban en el aire: no tenían acceso a mis datos. Hasta que RetroCatálogo empezó a exponer su API como servidor MCP, que es la forma estándar en la que los agentes de IA conectan con herramientas externas. Desde entonces el mismo catálogo alimenta a todos mis asistentes, y en este post te cuento cómo hacerlo con los principales: Claude Code, ChatGPT, Codex y Hermes, con ejemplos reales extraídos de mi propia cuenta.
Qué es MCP (en 30 segundos)
MCP (Model Context Protocol) es el protocolo que se ha impuesto para que un modelo de lenguaje «use» herramientas: en lugar de limitarse a devolverte texto, el agente puede llamar a funciones que leen y escriben en sistemas reales. Cada servidor MCP expone una lista de herramientas con su descripción y sus parámetros, y cualquier cliente compatible (Claude Code, ChatGPT, Codex, Hermes, Cursor…) puede conectarse y usarlas. Ya lo usé para conectar la documentación de mis proyectos con Claude Code, y este es el siguiente paso: que la IA no solo lea lo que le pasas, sino que sepa qué tienes.
RetroCatálogo expone el suyo en un endpoint público:
https://app.retrocatalogo.com/mcp
Y usa OAuth, que es la buena noticia: te autenticas con tu cuenta habitual en el navegador y cada asistente guarda su propio token. No hay ninguna clave de API que copiar y pegar por ahí, ni nada que comprometer en un archivo de configuración.
Qué puede hacer tu IA con tu colección
El servidor expone un juego de herramientas bastante completo. Por grupos:
- Perfil y estadísticas: tu perfil, cuántos artículos tienes, desglose por plataforma, estado de conservación o año.
- Búsqueda y fichas: buscar por nombre, marca, modelo o código con filtros combinables (plataforma, año, región, formato, estado, en venta), la ficha completa de un artículo con sus imágenes y ubicación, y el historial de cambios de cada pieza.
- Organización: listar tus colecciones, buscar posibles duplicados y las taxonomías globales (plataformas, regiones, formatos) que usan los filtros.
- Escritura: crear artículos, actualizar fichas (notas, estado, precios…) y añadir entradas al historial de cada pieza.
Con eso ya puedes pedirle cosas muy concretas. Te muestro ejemplos con datos reales de mi cuenta.
Ejemplos reales
«¿Qué tengo en mi colección?»
Cuéntame cómo está organizada mi colección de RetroCatálogo.
El agente llama a las herramientas de estadísticas y de colecciones y te responde con números. Con los datos de hoy, mi cuenta: 105 artículos en 5 colecciones, de las cuales 3 son públicas (Ordenadores clásicos, 31 piezas; Consolas de ayer y de hoy, 50; Mis libros retro, 11) y 2 privadas. Si le pides el desglose por plataforma, te dice cuántas piezas llevas por consola o por ordenador.
«¿Qué sé del Amstrad CPC 464?»
Dime todo lo que tengas sobre mi Amstrad CPC 464.
La ficha que devuelve incluye el código de inventario (RET-0001-000012), el número de serie, el año (1985), el estado de conservación, las fotos y la nota que le puse: «Ordenador funcionando. Modificado para un segundo switch de encendido y entrada de audio para pasar programas». Hasta dónde lo tengo guardado: el altillo. Son datos que yo anoté a mano, y que ahora cualquier asistente puede consultar y aprovechar. Por ejemplo, si le pides «prepara un anuncio para vender el CPC 464», te lo redacta con la ficha correcta en lugar de inventarse el equipo.
«¿Tengo algún Spectrum duplicado?»
Comprueba si tengo fichas duplicadas del ZX Spectrum.
Aquí entra la herramienta de duplicados: busca por nombre igual y te devuelve las candidatas (el Spectrum original de 1982, el ZX Spectrum + de 1984 y una reedición de 2024, en mi caso), para que las revises y, si procede, unifiques. No hace la fusión automática: eso lo decides tú.
«Anota que le he cambiado las correas del disco»
Añade al historial del Amstrad CPC 128 que el 24/09/2026 le cambié las correas del disco.
Las escrituras van al historial de la pieza con fecha y comentario, y la herramienta exige una clave de idempotencia para que si la red falla y la petición se reenvía, no se duplique la entrada. Es el tipo de detalle que se nota cuando el que escribe no es un humano haciendo clic.
Os dejo un par de vídeos de cómo usarlo en chatgpt
Y ahora cambiando datos (que ha encontrado él por su voluntad)
Conectarlo: cada harness a su manera
El endpoint es el mismo para todos. Lo que cambia es cómo se registra el servidor y cómo se completa el login OAuth.
Claude Code
Claude Code soporta servidores remotos HTTP con OAuth de serie. Tres comandos:
claude mcp add --transport http retrocatalogo https://app.retrocatalogo.com/mcp
claude mcp list
claude mcp login retrocatalogo
El primer comando lo registra (añade `–scope user` si quieres que esté disponible en todos tus proyectos y no solo en el actual). El segundo te mostrará «Needs authentication», que es lo esperado: todavía no has hecho login. El tercero abre el navegador, te logueas en RetroCatálogo y ya está: los tokens quedan guardados y se refrescan solos. Dentro de una sesión también puedes hacerlo con el comando `/mcp` y elegir Authenticate, sin salir de la conversación.
ChatGPT
ChatGPT web solo conecta con servidores MCP remotos, y para los propios necesitas Developer Mode: disponible en planes de pago (Plus, Pro, Business, Enterprise y Edu) y solo en web, no en la app de móvil. Los pasos:
- Activa Developer Mode (en las versiones actuales está bajo Ajustes, sección Seguridad e inicio de sesión; en builds anteriores, en Ajustes, Apps, Ajustes avanzados).
- En la página de apps/plugins de ChatGPT, crea una app nueva en modo desarrollador.
- Pega la URL `https://app.retrocatalogo.com/mcp` y deja la autenticación en OAuth.
- ChatGPT hará el login en tu navegador y escaneará las herramientas del servidor.
Después, en cualquier chat, eliges la app desde el menú de herramientas (+) y ya puedes hablar con tu colección. Con la matización de los planes: en los individuales las lecturas funcionan sin problema, pero las escrituras (crear o actualizar fichas) están documentadas a pleno rendimiento en Business, Enterprise y Edu; en Plus y Pro pueden limitarse a solo lectura o pedirte confirmación en cada una.
Codex (CLI, escritorio e IDE)
Codex guarda los servidores MCP en `~/.codex/config.toml`, y esa configuración la comparten el CLI, la app de escritorio de ChatGPT y la extensión del IDE: lo configuras una vez y sirve para los tres.
codex mcp add retrocatalogo --url https://app.retrocatalogo.com/mcp
codex mcp login retrocatalogo
O directamente en el fichero:
[mcp_servers.retrocatalogo]
url = "https://app.retrocatalogo.com/mcp"
`codex mcp list` te confirma que está ahí y el login OAuth es el mismo flujo de navegador. Dentro de la TUI puedes ver los servidores activos con `/mcp`.
Hermes
Hermes lo tiene aún más directo: en el `config.yaml` se declara el servidor con su autenticación y, la primera vez que se conecta, completa el flujo OAuth en el navegador:
mcp_servers:
retrocatalogo:
url: https://app.retrocatalogo.com/mcp
auth: oauth
Tras reiniciar (o con `/reload-mcp`), las herramientas aparecen con el prefijo `mcp__retrocatalogo__` (por ejemplo `mcp__retrocatalogo__search_items`) y los tokens quedan en `~/.hermes/mcp-tokens/`. Así está conectado este mismo post: los ejemplos de arriba los ha generado un agente con esas herramientas activas, sin que yo haya copiado ningún dato a mano.
Y el resto de clientes
Cualquier cliente MCP con soporte para servidores HTTP y OAuth dinámico (Cursor, VS Code, Claude Desktop…) usa el mismo patrón: en su fichero de configuración, típicamente un `.mcp.json` con un bloque `mcpServers`, pones la URL y el cliente se encarga del registro OAuth:
{
"mcpServers": {
"retrocatalogo": {
"type": "http",
"url": "https://app.retrocatalogo.com/mcp"
}
}
}
Seguridad y sentido común
Unas notas antes de soltar a la IA con tus fichas:
- OAuth por cliente: cada asistente tiene su token propio. Si dejas de usar uno, revocas esa conexión sin tocar las demás.
- Las escrituras son reales: crear un artículo o cambiar el estado de una pieza se hace de verdad. Si tu plan o cliente lo permite, empieza pidiendo solo lecturas y ve abriendo poco a poco.
- Lo que el agente ve es lo que tu cuenta puede ver: las colecciones privadas no se filtran a través de las herramientas de búsqueda propias.
- Confía en el servidor que conectas: un servidor MCP malintencionado podría sacar datos de tu contexto. RetroCatálogo es mío y lo reviso, pero la regla es general: no conectes servidores que no controlas.
Preguntas frecuentes
¿Qué es un servidor MCP?
Es un programa que expone herramientas (funciones) que un asistente de IA puede invocar: leer datos, buscar, escribir. El cliente (Claude Code, ChatGPT, Codex, Hermes) descubre las herramientas disponibles automáticamente y decide cuándo usar cada una.
¿Es seguro conectar mi colección?
La autenticación es OAuth, así que cada cliente tiene su propio token y puedes revocarlos uno a uno. Además, el agente solo ve lo que tu cuenta puede ver: las colecciones privadas no se filtran. La regla general sigue en pie: no conectes servidores que no controles.
¿Funciona con el plan gratuito de ChatGPT?
No. El Developer Mode, necesario para conectar apps propias con MCP, está disponible en los planes de pago (Plus, Pro, Business, Enterprise y Edu) y solo en la web. Claude Code, Codex y Hermes no tienen esa restricción.
¿Qué pasa si revoco el token de un asistente?
Ese cliente pierde el acceso y los demás siguen funcionando con normalidad: cada uno guarda su propio token, así que revocar uno no afecta al resto.
Enlaces útiles
- RetroCatálogo: el refugio de tus memorias digitales (introducción a la plataforma)
- Conectar Claude Code con MCPs (mi primer artículo sobre MCP)
- Endpoint MCP de RetroCatálogo
- Model Context Protocol (documentación oficial)
En resumen
Un catálogo, N asistentes. Con un endpoint y un login OAuth, la misma colección alimenta a Claude Code, ChatGPT, Codex y Hermes, y cada uno usa las herramientas que le cuadran: uno te prepara el anuncio de venta, otro te saca un informe por plataforma, otro te avisa de duplicados. Lo que antes era «ve a la web y búscalo» ahora es una pregunta.