Sobre o MCP

MCP (o Model Context Protocol) é um novo padrão aberto que grandes empresas de IA (Anthropic, OpenAI e outras) adotaram para que ferramentas como o Engram se conectem diretamente a assistentes de IA. Pense nele como um conector universal: um único padrão, e o Claude, o Cursor, o ChatGPT ou qualquer outra ferramenta de IA que suporte MCP consegue acessar suas notas. Eles podem pesquisá-las, lê-las e salvar novas, tudo com permissões que você controla.

Você não precisa entender MCP para usar o Engram. Escolha sua ferramenta de IA em Integrações de IA, siga alguns cliques e pronto. Esta página está aqui para quem quer conhecer o contexto.

O que é o MCP

Antes do MCP, levar suas notas para um assistente de IA significava copiar e colar, exportar ou criar uma integração personalizada para cada app. O MCP padroniza a conexão:

• O Engram expõe um único endpoint MCP (uma URL, um protocolo).
• Seu cliente de IA fala MCP (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed e outros).
• O handshake é feito via OAuth. Você mantém o controle do que fica acessível por qual cliente.
• Ferramentas, prompts e recursos são descobertos dinamicamente. O cliente pergunta ao Engram o que está disponível, e o Engram responde. Nada vem pré-configurado por integração.

Uma metáfora de uma linha: o MCP é o USB-C da IA. Um único formato de conexão, vários dispositivos nas duas pontas.

O que você pode fazer depois de conectar

• Pedir à sua IA que encontre notas sobre um assunto. Ela faz uma busca semântica em todo o seu cofre e traz as mais relevantes
• Pedir que ela resuma uma pasta ou encadeie notas relacionadas
• Pedir que ela redija uma nota nova e a salve direto no seu cofre (com a sua aprovação)
• Usar a busca do Engram dentro do seu fluxo de trabalho com IA, sem exportar, copiar e colar ou duplicar suas notas em lugar nenhum

Você pode perguntar ao Claude “o que eu escrevi sobre X no mês passado?” e ele encontra a resposta chamando a ferramenta de busca do Engram.

O protocolo, em resumo

Para quem gosta de detalhes, aqui está a superfície técnica. Você pode pular esta parte e usar o Engram normalmente.

O Engram fala MCP sobre HTTPS. Em particular:

• Autorização: OAuth 2.1 com Dynamic Client Registration (DCR), para que os clientes não precisem de credenciais emitidas previamente.
• Descoberta: GET /.well-known/oauth-authorization-server e tools/list, para que os clientes saibam o que está acessível.
• Ferramentas: search, get_note, write_note, list_folders e mais.
• Recursos: notas endereçáveis como URIs.
• Escopos: permissões granulares que você concede por sessão (veja Escopos).

Páginas desta seção

• Configuração do MCP: trecho de JSON e tabela de caminhos para quem conecta por arquivos de configuração em vez da interface gráfica
• Escopos: o que cada permissão concede
• Solução de problemas: quando o conector não consegue falar com o Engram

Para a configuração de cada cliente (Claude, Cursor, ChatGPT e outros), veja Integrações de IA.

O catálogo interativo de ferramentas (todas as ferramentas que o Engram expõe, com esquemas de entrada e exemplos) chega em uma fase posterior e será gerado diretamente do código do backend, para que nunca fique desatualizado.