Tus colecciones, también en tu asistente IA

Conecta Codex, Claude Code, ChatGPT o Claude.ai a RetroCatalogo para buscar en tus colecciones y trabajar con las fichas de tus artículos.

Conecta tu cuenta

Necesitas una cuenta activa. Solicita una invitación si todavía no tienes acceso.

Esta es la URL que debes añadir a tu cliente MCP:

https://app.retrocatalogo.com/mcp

ChatGPT y Claude.ai

Añade un conector MCP personalizado con esta URL y autenticación OAuth. El registro es automático: no necesitas introducir un identificador ni un secreto de cliente. Inicia sesión en RetroCatalogo y revisa los permisos y el dominio de retorno antes de autorizar.

Para estos servicios, RetroCatalogo debe estar accesible desde Internet mediante HTTPS. No pueden acceder al localhost de tu ordenador.

Codex

Empieza con permiso de lectura:

codex mcp add retrocatalog --url https://app.retrocatalogo.com/mcp
codex mcp login retrocatalog --scopes catalog:read

Claude Code

claude mcp add --scope user --transport http retrocatalog https://app.retrocatalogo.com/mcp
claude mcp login retrocatalog

Abre el enlace que indique el cliente, inicia sesión con tu cuenta habitual y revisa los permisos antes de autorizar. Claude Code puede solicitar también escritura; la pantalla de consentimiento te lo indicará.

Después abre una conversación nueva y prueba: «Lista mis colecciones y busca mis artículos de Nintendo».

Tú decides el acceso

Lectura permite consultar tu perfil (incluido el correo), tus colecciones y artículos, incluidos los privados, con sus notas, valores registrados, ubicación, historial y documentos. Escritura permite además crear y editar artículos, y moverlos entre colecciones propias, editar notas y añadir entradas al historial. No se permite borrar contenido.

Una conexión de lectura necesita un nuevo consentimiento para escribir. Puedes retirar el acceso en cualquier momento desde Conexiones autorizadas.

Herramientas disponibles

get_my_profile Lectura: Consultar tu perfil, correo y límites de cuenta.
list_collections Lectura: Listar tus colecciones con paginación.
get_collection Lectura: Consultar una colección propia por su identificador.
search_items Lectura: Buscar artículos con filtros combinables de colección, edición, estado y venta.
get_item Lectura: Consultar ficha completa, imágenes y ubicación de un artículo propio.
list_taxonomies Lectura: Buscar plataformas, regiones y formatos para filtrar.
get_item_history Lectura: Consultar el historial de un artículo propio.
list_item_documents Lectura: Listar documentos adjuntos y sus enlaces.
get_catalog_stats Lectura: Contar artículos y agruparlos por colección, plataforma, estado o año.
find_duplicate_items Lectura: Buscar posibles duplicados por nombre y edición.
create_item Escritura: Crear un artículo en una colección propia.
update_item Escritura: Editar un artículo, sus notas o moverlo entre colecciones propias.
add_item_log Escritura: Añadir una entrada fechada al historial de un artículo propio.

Consultas que puedes probar

«Busca mis juegos de Mega Drive de 1991 que estén en venta».
«¿En qué caja está este artículo y qué reparaciones tiene anotadas?».
«Muéstrame sus manuales y resume mi colección por plataforma».
«¿Tengo algún artículo con este nombre y edición?».

Los posibles duplicados son coincidencias de nombre que debes revisar; no se fusionan ni eliminan artículos. Las estadísticas cuentan el catálogo registrado, sin estimar precios de mercado.

Antes de escribir

Las herramientas de escritura editan los campos de la ficha y añaden entradas al historial. La ubicación, plataformas, regiones, formatos y documentos se pueden consultar, pero no modificar por MCP. Al mover un artículo a otra colección, su ubicación anterior se elimina y el cambio queda en el historial.

Cada escritura lleva una clave de reintento. Tu asistente debe conservar la misma clave y los mismos argumentos si se pierde la respuesta, para no duplicar la operación.

La guía técnica en Markdown incluye cómo solicitar escritura, los argumentos de las herramientas y las reglas de reintento.

Documentación para asistentes

/llms.txt ofrece un índice breve y enlaza la guía en Markdown. Es una ayuda para encontrar documentación; no concede permisos ni garantiza que todos los asistentes la lean automáticamente.

El descubrimiento de autenticación utiliza los metadatos del recurso MCP y los metadatos OAuth.

Privacidad · Términos de uso