Colección verificable con IA opcional · 2026
Pokédex Manager
Pokédex Manager explora PokéAPI, mantiene una colección aislada por cuenta y reconoce cartas a partir de una foto con confirmación humana antes de guardar nada. El asistente obtiene su contexto por una sesión MCP de solo lectura, así que cita datos de la colección en lugar de deducirlos. Kimi es opcional: sin proveedor de IA quedan catálogo, colección, estadísticas y un asistente local acotado.
RolDiseño de producto, arquitectura e implementación
Contexto y evolución
El sistema detrás de las pantallas.
Un asistente que conversa sobre una colección puede inventar lo que no encuentra. Pokédex Manager resuelve eso antes que la conversación: el modelo no consulta la base de datos, ejecuta herramientas con esquema por una sesión MCP de solo lectura y la respuesta cita cuáles se ejecutaron.
El asistente interno y los clientes MCP externos atraviesan la misma frontera: un puerto de producto de solo lectura, en memoria para uno y por Streamable HTTP con bearer y sujeto explícitos para el otro. No existe una ruta paralela que evite el aislamiento por cuenta, y ninguna operación MCP escribe datos de negocio.
El resto del producto no depende de que Kimi esté disponible. Sin proveedor de IA quedan catálogo, colección, estadísticas y un asistente local que cruza esa misma frontera; una caché de 24 horas en MongoDB conserva la última ficha conocida de PokéAPI, y el contenedor verifica sus índices antes de arrancar en lugar de operar sobre una base ambigua.
Decisiones y resultados
- Un servidor MCP propio con seis herramientas de solo lectura; el asistente y los clientes externos entran por la misma frontera.
- El reconocimiento contrasta la propuesta del modelo con PokéAPI y no agrega nada sin confirmación.
- Sin proveedor de IA la aplicación conserva catálogo, colección, estadísticas y asistente local.
Mapa del sistema
Abre cada aplicación.
No son etiquetas: cada módulo conserva su propia ruta y contexto técnico.
- 01Ver módulo
Catálogo
PokéAPI con filtros, orden global y una caché que sobrevive a la caída del origen.
- 02Ver módulo
Colección
Una colección por cuenta, con el aislamiento en la consulta y en el índice.
- 03Ver módulo
Servidor MCP
Seis herramientas de solo lectura y una sola frontera de contexto.
- 04Ver módulo
Asistente
Kimi cuando está habilitado; un enrutador determinista cuando no.
- 05Ver módulo
Reconocimiento de cartas
El modelo propone, PokéAPI resuelve y la persona confirma.
- 06Ver módulo
Operación
Compose para levantarlo y una cadena de calidad que no omite la persistencia.