Configuração em 60 segundos
claude mcp add --transport http notion https://mcp.notion.com/mcp
Aprove a solicitação de autorização OAuth na próxima execução — pronto. Agora o Claude Code pode pesquisar no seu espaço de trabalho, ler páginas em Markdown, editá-las e consultar bancos de dados. Todas as opções de conexão, permissões e os prós e contras da hospedagem externa versus hospedagem própria estão no nosso guia completo de MCP para Notion; o conceito por trás de toda essa configuração está em O que é uma wiki LLM?
Primeiro, ensine ao agente como funciona seu espaço de trabalho (CLAUDE.md)
A diferença entre um chatbot e um bibliotecário disciplinado é um arquivo de convenções. O Claude Code lê o CLAUDE.md no diretório do seu projeto sempre que é iniciado — coloque ali as regras do seu espaço de trabalho uma vez, e todos os fluxos abaixo passam a segui-las:
# My Notion workspace
- Sources live in "Inbox"; synthesized notes in "Knowledge Base"
- Always cite the source page when creating summaries
- Link related pages with @-mentions (they create backlinks)
- Never edit pages in "Archive"
- Projects DB relates to Tasks DB via the "Project" property
Os cinco fluxos de trabalho
1. Incorporar uma fonte
"Leia o artigo que acabei de adicionar à Caixa de entrada. Crie uma página de resumo na Base de conhecimento com as principais afirmações e o que há de novo em relação ao que já tenho, e mencione com @ todas as páginas relacionadas. Sinalize tudo o que contradiz minhas notas existentes."
Uma fonte geralmente envolve várias páginas — o resumo, o índice e todas as páginas vinculadas ao resumo. É esse efeito cumulativo que a tomada manual de notas nunca consegue sustentar.
2. Rodada de links cruzados
"Encontre 5 pares de páginas na Base de conhecimento que tenham relação de significado, mas não estejam vinculadas. Para cada par, explique a conexão em uma frase e adicione as menções com @ se eu confirmar."
É aqui que a compreensão semântica supera as tags: o Claude conecta páginas que não têm nenhuma palavra-chave em comum. Como as menções com @ criam backlinks, cada par confirmado enriquece as duas páginas ao mesmo tempo.
3. Revisão semanal
"Liste tudo o que mudou no meu espaço de trabalho nesta semana: páginas novas, projetos atualizados, tarefas paradas. Depois, sugira 3 links cruzados e 1 resumo que valha a pena atualizar."
Vinte minutos no domingo substituem aquele hábito de revisão que não passa de fevereiro. Você confirma; o agente arquiva.
4. Análise de lacunas
"Reúna tudo o que sei sobre [topic] em todo o espaço de trabalho. Organize assim: bem coberto / pouco coberto / não coberto."
A coluna "não coberto" é sua fila de pesquisa — extraída das suas próprias notas, em vez de baseada em suposições.
5. Salvar as respostas na base
"A comparação que você acabou de produzir — salve como uma página na Base de conhecimento, vincule as fontes e adicione ao índice."
Boas respostas não deveriam evaporar no histórico do chat. Salvas na base, elas se tornam nós que servem de base para a próxima pergunta — o conhecimento se acumula em vez de voltar à estaca zero.
Regras de segurança (aprendidas do jeito mais chato)
- Confirme os links cruzados antes de criá-los. Às vezes, os modelos conectam páginas por palavras em comum — o nosso já vinculou "decoradores em Python" a "decoração de interiores". Revisar antes de aplicar é melhor do que desfazer.
- Trabalhe em grupos próximos, não na base inteira. Não peça "todas as 1800 páginas" — limite o escopo a um banco de dados, um agrupamento ou uma semana. Os limites de contexto são reais.
- Proteja as áreas que não podem ser alteradas. Liste as páginas arquivadas e as páginas que são a fonte oficial de informação como somente leitura no CLAUDE.md.
- Lembre-se do modelo de acesso. Via MCP, o agente tem as suas permissões — tudo o que você pode acessar ou alterar, ele também pode. Defina o escopo de acordo com isso (detalhes na seção de segurança do guia de MCP).
Feche o ciclo: veja a estrutura mudar
Uma resposta em texto não consegue responder à única pergunta que importa ao longo dos meses: a base de conhecimento está mesmo ficando mais conectada? Um grafo consegue. Abra seu espaço de trabalho no IVGraph depois de alguns ciclos de incorporação de fontes e criação de links cruzados: os agrupamentos ficam mais coesos, páginas órfãs passam a fazer parte da rede e surgem páginas centrais. É a comparação visual das mudanças no seu segundo cérebro — e os agentes podem consultar essa mesma estrutura pela API LLM do IVGraph para escolher os próximos candidatos a links cruzados.

Perguntas frequentes
Como conecto o Claude Code ao Notion?
claude mcp add --transport http notion https://mcp.notion.com/mcp, depois aprove a autorização OAuth. Todas as opções estão no guia de MCP.
Claude Desktop ou Claude Code?
Desktop para perguntar; Code para fazer a manutenção. Os fluxos acima dependem da persistência do CLAUDE.md e da execução em várias etapas — esse é o território do Claude Code.
Qual é a diferença em relação ao Notion AI?
O Notion AI oferece assistência no próprio conteúdo; aqui, a manutenção é programável. Convenções próprias, etapas encadeadas e outras ferramentas (arquivos, web, git) no mesmo ciclo. Muita gente usa os dois.
De onde vem a filosofia de segundo cérebro por trás disso?
Do padrão de wiki LLM — a história completa e a arquitetura estão em O que é uma wiki LLM? e no nosso diário de implementação prática, Wiki LLM para Notion.