Knownbase MCP

Servidor Knownbase MCP

Memoria de proyecto persistente y buscable para agentes de IA, a través del Model Context Protocol.

Knownbase es un servidor MCP alojado que brinda a los agentes de codificación de IA (Claude, Cursor, ChatGPT, Claude Code, Windsurf y cualquier otro cliente compatible con MCP) un lugar para leer y escribir notas, decisiones y traspasos duraderos que viven fuera de tu historial de git: la memoria de trabajo que un agente pierde en el momento en que termina una sesión.

Este repositorio documenta el endpoint /mcp: cómo conectarse, qué herramientas expone y cómo funciona la autenticación. No hay instalación local: Knownbase es un servidor MCP remoto de HTTP transmisible, por lo que conectarse es simplemente apuntar tu cliente a una URL.

https://knownbase.dev/mcp

El problema que resuelve

Los agentes de IA no tienen estado entre sesiones. Cada nuevo chat, cada nueva terminal, cada ventana de IDE reiniciada comienza desde cero. El agente vuelve a leer tu código pero no tiene memoria de por qué las cosas son como son:

• Decisiones de arquitectura y las compensaciones detrás de ellas
• Rutas de depuración ("probamos X, no funcionó porque Y")
• Convenciones y trampas que no son obvias a partir del código mismo
• Traspasos de tareas entre sesiones, o entre tú y el agente de un compañero
• Cualquier cosa que no quieras saturar en el historial de git pero que el agente aún necesite saber

Sin una capa de memoria, terminas reexplicando el mismo contexto cada sesión, o el agente redescubre (y vuelve a romper) lo mismo dos veces. Knownbase le da al agente un espacio de trabajo que puede buscar y escribir directamente, para que esa memoria persista y se acumule en lugar de reiniciarse.

Inicio rápido

1. Crea un espacio de trabajo gratuito en knownbase.dev (no se requiere tarjeta).
2. Conecta tu cliente MCP a https://knownbase.dev/mcp; consulta docs/CONNECTING_CLIENTS.md para los pasos exactos por cliente (Claude, Claude Code, ChatGPT, Cursor y clientes MCP genéricos).
3. Autentícate con una clave API estática o OAuth 2.1 (la mayoría de los clientes descubren OAuth automáticamente); consulta docs/AUTHENTICATION.md.
4. Comienza una tarea con get_context para cargar lo que ya se sabe, escribe conocimiento duradero con remember y recurre a search_notes / get_note / upsert_note para control directo. Referencia completa de herramientas: docs/TOOLS.md.

Lo que expone

Herramienta	Propósito
list_projects	Lista categorías de proyecto y conteos de notas en el espacio de trabajo
get_context	Orientación de proyecto en una sola llamada: restricciones, decisiones, estado, elementos abiertos y cambios recientes, clasificados y empaquetados según un presupuesto de tokens
search_notes	Búsqueda por texto, proyecto, etiqueta, estado o fecha de última modificación (por palabras clave; la búsqueda semántica llegará pronto, y semantic: true recurre a palabras clave hasta entonces)
get_note	Lee una nota completa, con sus enlaces/enlaces inversos
get_notes	Lectura por lotes de hasta 50 notas en una sola llamada
remember	Almacena un hecho/decisión/restricción duradero en una llamada: deriva el título, verifica duplicados o contradicciones, informa lo que hizo
checkpoint	Cierra una sesión de trabajo como estado duradero estructurado: resumen, decisiones, descubrimientos, elementos abiertos, próximas acciones
get_changes_since	Reanuda desde otro agente, sesión o máquina mediante un cursor opaco, sin recargar el proyecto
upsert_note	Crea una nota o actualiza parcialmente una existente
patch_note	Cambia parte de un cuerpo (añadir, anteponer o buscar y reemplazar literal) sin reenviarlo
delete_note	Eliminación suave (papelera) de una nota
list_note_revisions	Lista las versiones anteriores guardadas de una nota
get_note_revision	Lee el cuerpo completo de una revisión histórica
workspace_info / usage_summary	Plan, límites, uso y el alcance de acceso de esta clave
rename_project	Renombrado masivo de un proyecto en todas las notas
rename_tag	Renombrado masivo o eliminación de una etiqueta en todas las notas
backup_project	Exporta el contenido completo de un proyecto en línea, para respaldo/portabilidad

Las notas también llevan metadatos temporales tipados opcionales (decision / fact / constraint / …, además de un ciclo de vida current / superseded / disputed) que get_context clasifica y filtra. Consulta Memoria temporal tipada en la referencia de herramientas.

La referencia completa a nivel de parámetros, incluidos los formatos de respuesta minimalistas por diseño para ahorrar tokens de agente, está en docs/TOOLS.md.

Por qué un servidor MCP remoto y alojado

Cada nota está limitada a tu propio espacio de trabajo; nada se comparte entre inquilinos. La búsqueda de texto completo se ejecuta en el servidor, por lo que los agentes obtienen resultados sin cargar todo tu corpus de notas en el contexto. La búsqueda semántica (basada en significado) llegará pronto: search_notes ya acepta semantic: true y recurre a la búsqueda por palabras clave hasta que esté disponible, y workspace_info informa plan.semanticSearch para que un agente pueda verificar primero. Las notas tienen versiones (cada edición crea una instantánea de revisión) y eliminación suave (papelera, no eliminación permanente), por lo que la escritura de un agente nunca es una puerta de un solo sentido.

Enlaces

• Página principal: qué es Knownbase y para quién es
• Características
• Precios: plan gratuito (3 proyectos, 300 notas, 2 claves MCP), además de planes Go / Solo / Team / Business, cada uno con prueba gratuita de 7 días
• Blog: guías sobre MCP, memoria de agentes y traspasos
• llms.txt: resumen legible por máquina del producto/endpoint
• Contacto · hello@knownbase.dev

Contenido del repositorio

• docs/AUTHENTICATION.md: claves API, flujo OAuth 2.1, claves limitadas a proyectos
• docs/CONNECTING_CLIENTS.md: configuración por cliente (Claude, Claude Code, ChatGPT, Cursor, otros)
• docs/TOOLS.md: referencia completa de herramientas con formatos de entrada/salida
• server.json: manifiesto del Registro MCP

Este repositorio documenta un servicio alojado; no contiene el código fuente del servidor Knownbase. ¿Encontraste un problema con estos documentos o una discrepancia con el comportamiento real del servidor? Por favor, abre un problema o envía un correo a hello@knownbase.dev.

Licencia

La documentación de este repositorio está licenciada bajo MIT. El uso del servicio Knownbase en sí se rige por sus Términos de servicio.