Knownbase MCP

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

Documentación

Servidor Knownbase MCP

Memoria de proyecto persistente y buscable para agentes de IA — mediante el Protocolo de Contexto de Modelos (MCP).

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 la 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 (streamable-HTTP), así 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
Rastros 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 necesite saber

Sin una capa de memoria, terminas reexplicando el mismo contexto en 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

Crea un espacio de trabajo gratuito en knownbase.dev (no se requiere tarjeta).
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).
Autentícate con una clave API estática o con OAuth 2.1 (la mayoría de los clientes descubren OAuth automáticamente) — consulta docs/AUTHENTICATION.md.
Comienza a escribir notas: upsert_note, y luego search_notes / get_note para recuperarlas más tarde. Referencia completa de herramientas: docs/TOOLS.md.

Lo que expone

Herramienta	Propósito
`list_projects`	Lista las categorías de proyectos y los conteos de notas en el espacio de trabajo
`search_notes`	Busca por texto, proyecto, etiqueta, estado o fecha de última modificación (por palabras clave o semántica)
`get_note`	Lee una nota completa, con sus enlaces/enlaces inversos
`get_notes`	Lectura por lotes de hasta 50 notas en una sola llamada
`upsert_note`	Crea una nota o actualiza parcialmente una existente
`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`	Renombra un proyecto en masa en todas las notas
`rename_tag`	Renombra o elimina una etiqueta en masa en todas las notas
`backup_project`	Exporta el contenido completo de un proyecto en línea, para respaldo/portabilidad

La referencia completa a nivel de parámetros, incluidos los formatos de respuesta minimalistas por defecto diseñados para ahorrar tokens del 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 (y, en los planes compatibles, la búsqueda semántica/basada en significado) se ejecuta en el servidor, por lo que los agentes obtienen resultados sin cargar todo tu corpus de notas en el contexto. Las notas tienen versiones (cada edición crea una instantánea de revisión) y se eliminan de forma 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 los 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 de Knownbase. ¿Encontraste un problema con estos documentos o una discrepancia con el comportamiento real del servidor? Por favor abre un issue o envía un correo a hello@knownbase.dev.

Licencia

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