Notion MCP: o guia completo para conectar a IA ao seu espaço de trabalho

O que é o Notion MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas e fontes de dados externas. O Notion MCP é a implementação oficial desse padrão, hospedada pelo Notion: um servidor que fica entre sua ferramenta de IA e seu espaço de trabalho e disponibiliza o Notion como um conjunto de ferramentas tipadas — buscar, ler página, editar página, consultar banco de dados — em vez de uma API bruta que o agente teria que aprender a usar por conta própria.

Na prática, a diferença em relação ao antigo fluxo com token de integração é da água para o vinho. Você se autentica uma vez via OAuth, o agente descobre automaticamente as ferramentas disponíveis, e o conteúdo das páginas é transmitido em markdown — um formato com o qual os modelos conseguem trabalhar mais facilmente e que consome muito menos tokens do que o JSON de blocos do Notion.

Servidor hospedado vs. servidor com hospedagem própria

Há duas formas oficiais de executar o servidor, e uma opção padrão clara:

Use o servidor hospedado, a menos que você precise especificamente limitar o acesso à leitura ou usar um ambiente isolado da rede. O Notion já declarou claramente que o notion-mcp-server de código aberto no GitHub deixou de ser prioridade e pode ser descontinuado.

Configuração: Claude Code, Claude Desktop, Cursor, ChatGPT

Claude Code (um comando)

claude mcp add --transport http notion https://mcp.notion.com/mcp

Na próxima execução, o Claude Code abre o fluxo de autenticação OAuth; autorize o acesso, e as ferramentas do Notion aparecerão automaticamente.

Claude Desktop

Configurações → Conectores → adicione o Notion pelo diretório (um clique), ou adicione um conector personalizado com a URL https://mcp.notion.com/mcp.

Cursor

Adicione ao .cursor/mcp.json (do projeto) ou às configurações globais de MCP:

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

ChatGPT e outros

Qualquer ferramenta que possa atuar como cliente MCP pode se conectar — o ChatGPT oferece esse suporte por meio de conectores. Ferramentas sem suporte a MCP não conseguem usar o Notion MCP de forma alguma, o que é o motivo mais comum para uma configuração “não funcionar”.

Versão com hospedagem própria

Crie uma integração interna em notion.so/profile/integrations, conceda a ela acesso às páginas específicas que você quer disponibilizar e execute o servidor com seu token:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_****" }
    }
  }
}

O que os agentes podem fazer na prática

• Buscar nas suas páginas e nos conteúdos conectados — o agente encontra o contexto, em vez de você precisar colá-lo.
• Ler páginas em markdown — conteúdo completo da página em uma única chamada, com uso eficiente de tokens, incluindo transcrições de notas de reunião.
• Escrever e editar — criar páginas, sobrescrever conteúdo ou fazer edições pontuais de busca e substituição.
• Trabalhar com bancos de dados — consultar fontes de dados com filtros e ordenações, atualizar propriedades e criar registros.
• Mover e organizar — alterar a página pai das páginas e gerenciar a estrutura.

Na prática, isso cobre todo o ciclo de uma wiki com LLM: o agente importa fontes, escreve resumos no Notion, cria links cruzados entre páginas e responde a perguntas com base no que já construiu. Usamos exatamente essa configuração todos os dias — as receitas prontas para copiar e colar estão em Claude Code + Notion: cinco fluxos de trabalho, e o relato completo da construção, com suas limitações expostas com franqueza, está em Wiki com LLM para Notion.

Segurança e permissões

• Suas permissões são o limite máximo. Um agente conectado pelo Notion MCP pode acessar exatamente o que sua conta pode — nada além disso — e não consegue contornar as permissões de cada página.
• O limite mínimo depende de você. O servidor hospedado sempre atua com todo o seu acesso, então pense bem antes de conectar um agente experimental a um espaço de trabalho com dados sensíveis. Para acesso somente leitura, use o servidor com hospedagem própria e um token de integração com apenas a permissão “Ler conteúdo”.
• Controles do plano Enterprise. Administradores de espaços de trabalho no plano Enterprise podem ativar a Governança de MCP: uma lista de aplicativos de IA aprovados, auditoria de conexões e um controle para desconectar todos.
• Os dados são enviados ao modelo. Tudo o que o agente lê passa a fazer parte do contexto dele — considere a política de dados da própria ferramenta de IA como parte da sua superfície de segurança.

O mapa que falta: o que o MCP não oferece

O MCP dá mãos ao agente — buscar, ler, escrever. Não dá olhos. Cada consulta é uma visão pelo buraco da fechadura: o agente vê as páginas que buscou naquela rodada, não a estrutura do espaço de trabalho — quais páginas são pontos centrais, quais agrupamentos existem, onde estão as páginas órfãs. Esse é um problema de grafos, não de recuperação de informação.

É exatamente essa camada que o IVGraph acrescenta a uma configuração com Notion + MCP: o espaço de trabalho representado como um grafo de conhecimento 3D interativo para você, e a mesma estrutura disponibilizada de forma programática para agentes pela IVGraph LLM API — busca, vizinhanças de nós e caminhos mais curtos entre páginas. O agente edita via MCP; o grafo mostra a vocês dois como o espaço de trabalho realmente está estruturado.

Perguntas frequentes