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 — via 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, decisões e transferências duráveis que vivem fora do seu histórico do git — a memória de trabalho que um agente de outra forma perde no momento em que uma 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 HTTP streamable, 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 de por que as coisas são 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 poluindo o histórico do git, mas que 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 quebra de novo) a mesma coisa duas vezes. Knownbase dá ao agente um espaço de trabalho que ele pode pesquisar e escrever diretamente, para que a memória persista e se acumule em vez de ser reiniciada.

Início rápido

Crie um workspace gratuito em knownbase.dev (sem necessidade de cartão).
Conecte seu cliente MCP a https://knownbase.dev/mcp — veja docs/CONNECTING_CLIENTS.md para os passos exatos por cliente (Claude, Claude Code, ChatGPT, Cursor e clientes MCP genéricos).
Autentique-se com uma chave de API estática ou OAuth 2.1 (a maioria dos clientes descobre OAuth automaticamente) — veja docs/AUTHENTICATION.md.
Comece a escrever notas: upsert_note, depois search_notes / get_note para recuperá-las depois. Referência completa de ferramentas: docs/TOOLS.md.

O que ele expõe

Ferramenta	Finalidade
`list_projects`	Lista categorias de projeto e contagens de notas no workspace
`search_notes`	Pesquisa por texto, projeto, tag, status ou data de última modificação (por palavra-chave ou semântica)
`get_note`	Lê uma nota completa, com seus links/backlinks
`get_notes`	Lê em lote até 50 notas em uma única chamada
`upsert_note`	Cria uma nota, ou atualiza parcialmente uma existente
`delete_note`	Exclui suavemente (lixeira) 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 própria 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

A referência completa em nível de parâmetro, incluindo os formatos de resposta enxutos por padrão, projetados 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 workspace — nada é compartilhado entre tenants. A pesquisa de texto completo (e, em planos compatíveis, a pesquisa semântica/baseada em significado) é executada no servidor, então os agentes obtêm resultados sem carregar todo o seu corpus de notas no contexto. As notas são versionadas (cada edição cria um snapshot de revisão) e excluídas suavemente (lixeira, não removidas permanentemente), 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 formatos 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.