Knownbase MCP

Memória de projeto persistente e pesquisável para agentes de IA, via Model Context Protocol.

Documentação

Servidor Knownbase MCP

Memória de projeto persistente e pesquisável para agentes de IA, através do Model Context Protocol.

Knownbase é um servidor MCP hospedado que dá aos agentes de codificação de IA (Claude, Cursor, ChatGPT, Claude Code, Windsurf e qualquer outro cliente compatível com MCP) um lugar para ler e escrever notas duráveis, decisões e transferências que vivem fora do seu histórico do git: a memória de trabalho que um agente perde no momento em que a sessão termina.

Este repositório documenta o endpoint /mcp: como conectar, quais ferramentas ele expõe e como funciona a autenticação. Não há instalação local: Knownbase é um servidor MCP remoto com streamable-HTTP, então conectar é apenas apontar seu cliente para uma URL.

https://knownbase.dev/mcp

O problema que isso resolve

Agentes de IA não têm estado entre sessões. Cada novo chat, cada novo terminal, cada janela de IDE reiniciada começa do zero. O agente relê seu código, mas não tem memória do porquê das coisas serem como são:

Decisões de arquitetura e os tradeoffs por trás delas
Trilhas de depuração ("tentamos X, não funcionou porque Y")
Convenções e pegadinhas que não são óbvias a partir do próprio código
Transferências de tarefas entre sessões, ou entre você e o agente de um colega
Qualquer coisa que você não queira poluir o histórico do git, mas ainda precise que o agente saiba

Sem uma camada de memória, você acaba reexplicando o mesmo contexto a cada sessão, ou o agente redescobre (e re-quebra) a mesma coisa duas vezes. Knownbase dá ao agente um espaço de trabalho que ele pode pesquisar e escrever diretamente, para que essa memória persista e se acumule em vez de reiniciar.

Início rápido

Crie um espaço de trabalho gratuito em knownbase.dev (sem necessidade de cartão).
Conecte seu cliente MCP a https://knownbase.dev/mcp; veja docs/CONNECTING_CLIENTS.md para passos exatos por cliente (Claude, Claude Code, ChatGPT, Cursor e clientes MCP genéricos).
Autentique com uma chave de API estática ou OAuth 2.1 (a maioria dos clientes descobre OAuth automaticamente); veja docs/AUTHENTICATION.md.
Comece uma tarefa com get_context para carregar o que já é conhecido, escreva conhecimento durável com remember, e use search_notes / get_note / upsert_note como fallback para controle direto. Referência completa de ferramentas: docs/TOOLS.md.

O que ele expõe

Ferramenta	Propósito
`list_projects`	Lista categorias de projeto e contagens de notas no espaço de trabalho
`get_context`	Orientação de projeto em uma chamada: restrições, decisões, status, itens em aberto e mudanças recentes, ranqueados e compactados para um orçamento de tokens
`search_notes`	Pesquisa por texto, projeto, tag, status ou data da última modificação (palavra-chave; busca semântica está chegando em breve, e `semantic: true` usa palavra-chave como fallback até lá)
`get_note`	Lê uma nota completa, com seus links/backlinks
`get_notes`	Leitura em lote de até 50 notas em uma chamada
`remember`	Armazena um fato/decisão/restrição durável em uma chamada: deriva o título, verifica duplicatas ou contradições, relata o que fez
`checkpoint`	Encerra uma sessão de trabalho como estado durável estruturado: resumo, decisões, descobertas, itens em aberto, próximas ações
`get_changes_since`	Retoma de outro agente, sessão ou máquina via um cursor opaco, sem recarregar o projeto
`upsert_note`	Cria uma nota, ou atualiza parcialmente uma existente
`patch_note`	Altera parte de um corpo (anexar, prefixar ou localizar-e-substituir literal) sem reenviá-lo
`delete_note`	Exclusão suave (lixeira) de uma nota
`list_note_revisions`	Lista as versões anteriores salvas de uma nota
`get_note_revision`	Lê o corpo completo de uma revisão histórica
`workspace_info` / `usage_summary`	Plano, limites, uso e o escopo de acesso desta chave
`rename_project`	Renomeia em massa um projeto em todas as notas
`rename_tag`	Renomeia ou remove em massa uma tag em todas as notas
`backup_project`	Exporta o conteúdo completo de um projeto inline, para backup/portabilidade

As notas também carregam metadados temporais tipados opcionais (decision / fact / constraint / …, além de um ciclo de vida current / superseded / disputed) que get_context ranqueia e filtra. Veja Memória temporal tipada na referência de ferramentas.

A referência completa em nível de parâmetro, incluindo as formas de resposta enxutas por padrão projetadas para economizar tokens do agente, está em docs/TOOLS.md.

Por que um servidor MCP remoto e hospedado

Cada nota é limitada ao seu próprio espaço de trabalho; nada é compartilhado entre tenants. A busca em texto completo é executada no servidor, então os agentes obtêm resultados sem carregar todo o seu corpus de notas no contexto. A busca semântica (baseada em significado) está chegando em breve: search_notes já aceita semantic: true e usa busca por palavra-chave como fallback até que esteja disponível, e workspace_info relata plan.semanticSearch para que um agente possa verificar primeiro. As notas são versionadas (cada edição tira um snapshot de uma revisão) e têm exclusão suave (lixeira, não remoção permanente), então a escrita de um agente nunca é uma porta de mão única.

Conteúdo do repositório

docs/AUTHENTICATION.md: chaves de API, fluxo OAuth 2.1, chaves com escopo de projeto
docs/CONNECTING_CLIENTS.md: configuração por cliente (Claude, Claude Code, ChatGPT, Cursor, outros)
docs/TOOLS.md: referência completa de ferramentas com formas de entrada/saída
server.json: manifesto do MCP Registry

Este repositório documenta um serviço hospedado; ele não contém o código-fonte do servidor Knownbase. Encontrou um problema com estes documentos, ou uma divergência com o comportamento real do servidor? Por favor, abra uma issue ou envie um e-mail para hello@knownbase.dev.

Licença

A documentação neste repositório é licenciada sob MIT. O uso do próprio serviço Knownbase é regido pelos seus Termos de Serviço.