Protocolo MCP
Suporte nativo ao Model Context Protocol, permitindo integração direta com qualquer agente ou IDE compatível com MCP.
Context OS
Plataforma de memória persistente auto-hospedada e independente de fornecedor para agentes de IA.
Dê aos seus agentes de inteligência artificial a capacidade de lembrar, refletir e recuperar informações através de uma infraestrutura de memória semântica robusta, privada e sob seu controle total.
⚡ Powered by Hindsight v0.9.1🏗️ Arquitetura
Internet → Cloudflare → Caddy (TLS) → Hindsight → PostgreSQL + pgvector
Todas as requisições externas passam pela Cloudflare (proteção DDoS e cache) antes de alcançarem o Caddy, que gerencia certificados TLS automaticamente e serve como proxy reverso na porta 443 (HTTPS).
O Caddy encaminha as requisições autenticadas para o Hindsight, a engine de memória que persiste dados no PostgreSQL 18 com a extensão pgvector 0.8.6 para busca semântica vetorial.
⚠️ Serviços internos não são expostos diretamente à internet: o Control Plane (porta 9999) e o PostgreSQL (porta 5432) permanecem na rede Docker. O acesso público ocorre apenas por HTTPS via Caddy.
✨ Funcionalidades
Busca Semântica, Temporal e por Grafos
Recupere memórias por similaridade vetorial, por intervalo de tempo ou navegando relações entre entidades em um grafo de conhecimento.
Isolamento Multi-Bank
Cada banco de memória é um namespace isolado. Agentes e projetos diferentes mantêm memórias completamente separadas.
Autenticação Bearer Token
Todas as operações exigem autenticação via token Bearer. Sem credenciais válidas, nenhum acesso é concedido.
Retain / Recall / Reflect
Retain: armazenar memórias. Recall: recuperar informações relevantes. Reflect: gerar insights a partir do histórico acumulado.
🗄️ Bancos de Memória
Bancos (banks) são namespaces isolados de memória. Cada banco opera de forma independente, com seu próprio conjunto de memórias, sem vazamento de informação entre eles.
- andre-global /mcp/andre-global/
- context-os /mcp/context-os/
Padrão de endpoint: /mcp/<bank-id>/
🛡️ Segurança
- HTTPS obrigatório — todas as conexões são criptografadas via TLS. Requisições HTTP são redirecionadas automaticamente.
- Autenticação Bearer Token — cada requisição à API deve incluir um token válido no header Authorization.
- PostgreSQL não exposto — o banco de dados é acessível apenas pela rede interna Docker. A porta 5432 não está aberta externamente.
- Console público seguro — o Swagger em /docs permite explorar a API. O Control Plane administrativo permanece interno até receber subdomínio e autenticação próprios.
- Segredos fora do Git — credenciais, tokens e chaves privadas nunca são versionados no repositório. Variáveis de ambiente e arquivos protegidos são usados para configuração sensível.
🚀 Começar
Configure seu agente de IA para se conectar ao Context OS e comece a construir memória persistente agora.
Guia de Configuração MCP → Console da API →