O que é o servidor MCP do Notion para o Claude?
Se você já desejou que o Claude lesse seus documentos reais do Notion, em vez de trabalhar apenas com o que você cola no chat, o servidor MCP do Notion torna isso possível. Ele conecta o Claude diretamente ao seu workspace para que ele pesquise, leia e atualize suas páginas por meio de uma conversa normal. Esta definição explica o que é a integração, o que ela permite que o Claude faça e como ela se encaixa em um fluxo de trabalho prático.
Contribuição de
SaaS Hackers
Resposta rápida: o servidor MCP do Notion conecta o Claude diretamente ao seu workspace do Notion usando o Model Context Protocol. Depois de configurado, o Claude pode ler, pesquisar, atualizar e criar páginas do Notion por meio de linguagem natural. A configuração leva menos de 20 minutos e não exige experiência com programação.
A integração Notion MCP transforma o Claude de um assistente de AI independente em algo realmente útil para equipes de B2B SaaS: uma AI que lê sua documentação real, consulta seus bancos de dados e atualiza suas páginas sem que você precise trocar de aba.
Este guia cobre a configuração completa tanto para o Claude Desktop quanto para o Claude Code, além dos fluxos de trabalho práticos que as equipes de SaaS mais aproveitam depois que tudo está conectado.
O que é o servidor MCP do Notion?
O servidor MCP do Notion é uma integração oficial criada pelo Notion que usa o Model Context Protocol (um padrão aberto criado pela Anthropic) para dar ao Claude acesso direto ao seu workspace do Notion. Em vez de copiar e colar conteúdo no Claude, o Claude lê e escreve diretamente no Notion.
Isso importa para equipes de B2B SaaS porque seu workspace do Notion provavelmente guarda especificações de produto, pesquisas com clientes, documentos de onboarding e anotações de reuniões. Conectar o Claude a esse contexto o torna um assistente muito mais útil do que um que trabalha do zero.
O que o Claude pode fazer depois de conectado:
- Pesquisar em todo o seu workspace do Notion por palavra-chave ou tema
- Ler o conteúdo completo de qualquer página à qual tenha acesso
- Consultar entradas de bancos de dados e filtrar por propriedades
- Criar novas páginas e entradas em bancos de dados
- Atualizar o conteúdo de páginas existentes
- Resumir documentos longos sob demanda
O que você precisa antes de começar
Antes de configurar a integração do Claude com o Notion MCP, confirme que você tem o seguinte:
- Claude Desktop (gratuito ou Pro) ou Claude Code instalado
- Uma conta do Notion (qualquer plano)
- Node.js instalado na sua máquina (versão 18 ou superior)
- Acesso de administrador ao seu workspace do Notion ou permissão para criar integrações
Se você usa especificamente o Claude Code, o Notion também publica um plugin oficial que reúne o servidor MCP com slash commands prontos. Essa opção é abordada separadamente mais abaixo.
Como configurar o Notion MCP com o Claude Desktop
Passo 1: crie uma integração no Notion
- Acesse notion.so/my-integrations
- Clique em New integration
- Dê um nome a ela (por exemplo, "Claude MCP")
- Selecione o workspace ao qual você quer que o Claude tenha acesso
- Em capabilities, ative Read content, Update content e Insert content
- Clique em Save
- Copie o Internal Integration Token que aparecer. Você vai precisar dele no Passo 3.
Passo 2: conecte páginas à sua integração
As integrações do Notion só acessam páginas que você compartilha explicitamente com elas. Isso é um recurso de segurança, não um defeito.
Para cada página ou banco de dados do Notion ao qual você quer que o Claude tenha acesso:
- Abra a página no Notion
- Clique no menu de três pontos (canto superior direito)
- Selecione Connections
- Encontre o nome da sua integração e clique em Confirm
Você pode compartilhar uma página de nível superior para dar ao Claude acesso a tudo o que está dentro dela.
Passo 3: configure o servidor MCP no Claude Desktop
Abra o arquivo de configuração do Claude Desktop. No Mac, ele fica em:
~/Library/Application Support/Claude/claude_desktop_config.jsonNo Windows:
%APPDATA%\Claude\claude_desktop_config.jsonAdicione o seguinte ao arquivo, substituindo YOUR_INTEGRATION_TOKEN pelo token do Passo 1:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_INTEGRATION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
}
}
}
}Passo 4: reinicie o Claude Desktop
Feche completamente o Claude Desktop e abra-o de novo. Quando o app carregar, você deverá ver um ícone de martelo no canto inferior esquerdo da interface de chat. Isso confirma que o servidor MCP está ativo e que o Claude tem acesso às ferramentas.
Passo 5: teste a conexão
Digite isto no Claude:
"Search my Notion workspace for pages about [a topic you know exists]."
Se o Claude retornar resultados do seu workspace, a integração está funcionando.
Como configurar o Notion MCP com o Claude Code
Quem usa o Claude Code tem uma opção um pouco diferente (e mais rápida): o plugin oficial do Notion para o Claude Code.
Opção A: instale o plugin oficial do Notion
O plugin oficial (publicado em makenotion/claude-code-notion-plugin no GitHub) reúne o servidor MCP com skills e slash commands prontos. É o caminho recomendado se você usa o Claude Code como interface principal.
Passos de instalação:
- Abra o Claude Code
- Execute o seguinte comando no terminal:
claude mcp add notionhq/notion-mcp-server- Quando solicitado, cole o token da sua integração do Notion
- Confirme a conexão
O plugin adiciona slash commands como /notion-search, /notion-create, e /notion-update diretamente ao seu fluxo de trabalho no Claude Code.
Opção B: configuração manual via claude.json
Se você prefere a configuração manual ou precisa de uma configuração personalizada, adicione o servidor MCP do Notion ao seu arquivo claude.json usando a mesma estrutura JSON mostrada na seção do Claude Desktop acima.
Fluxos de trabalho práticos para equipes de B2B SaaS
Colocar a integração para funcionar é só o primeiro passo. Aqui é onde ela realmente compensa.
Consultando seus bancos de dados do Notion
Equipes de SaaS costumam guardar dados de clientes, pedidos de funcionalidades ou tarefas de sprint em bancos de dados do Notion. Quando o Claude tem acesso, você pode consultar esses bancos de dados em linguagem natural.
Exemplos de prompts:
- "Encontre todas as entradas do banco de dados do meu roadmap de produto em que o status é 'In Review'"
- "Mostre-me todas as páginas marcadas com o nome do cliente Acme Corp"
- "Liste todas as tarefas atribuídas a [nome] marcadas como alta prioridade"
O Claude lê as propriedades do banco de dados e filtra os resultados sem que você precise criar visualizações personalizadas.
Resumindo documentos longos
Especificações de produto, relatórios de pesquisa com clientes e guias de onboarding tendem a ficar longos. O Claude pode resumir qualquer página conectada do Notion em segundos.
Exemplos de prompts:
- "Resuma a página de pesquisa com clientes do 2º trimestre em 5 tópicos"
- "Me dê as principais decisões do registro de decisões de arquitetura do nosso sistema de cobrança"
- "Quais são as principais objeções registradas no nosso playbook de vendas?"
Isso é especialmente útil antes de calls com clientes ou revisões internas, quando você precisa de um resumo rápido. Equipes que constroem uma documentação mais estruturada e fluxos de conteúdo repetíveis costumam combinar esse tipo de configuração com o apoio de boas agências de content marketing para B2B SaaS para transformar conhecimento interno em ativos que geram pipeline.
Atualizando páginas sem sair do seu fluxo de trabalho
O Claude pode escrever conteúdo de volta no Notion, não apenas ler. Para equipes de SaaS, isso elimina o atrito de alternar entre o assistente de AI e a ferramenta de documentação.
Exemplos de prompts:
- "Adicione uma nova seção ao nosso checklist de onboarding para clientes enterprise sobre a configuração de SSO"
- "Atualize a propriedade de status da página da funcionalidade 'API rate limiting' para 'Shipped'"
- "Crie uma nova página no nosso banco de dados de anotações de reuniões com a data de hoje e o seguinte resumo: [cole as anotações]"
Construindo uma base de conhecimento viva
O caso de uso mais duradouro do claude notion mcp em um contexto de B2B SaaS é tratar o Notion como uma camada de memória persistente para o Claude. Em vez de explicar de novo seu produto, seus clientes ou seus processos em cada conversa, o Claude lê esse contexto no Notion no início de cada sessão.
Configure assim:
- Crie uma página "Claude Context" no Notion com seu ICP, o posicionamento do produto e a terminologia principal
- Compartilhe essa página com a sua integração
- Comece cada sessão do Claude com: "Leia minha página Claude Context no Notion antes de começarmos"
Isso leva cerca de 30 minutos para montar e economiza bastante tempo em todas as sessões seguintes. Para equipes maiores, esse tipo de processo passa a fazer parte de uma operação de marketing para B2B SaaS mais ampla, principalmente quando documentação, execução de campanhas e relatórios precisam ficar alinhados.
Solução de problemas comuns de configuração
O Claude diz que não encontra nenhuma ferramenta do Notion
O servidor MCP não foi carregado. Feche completamente o Claude Desktop e reinicie-o. Verifique se há erros de sintaxe JSON no seu arquivo claude_desktop_config.json (uma vírgula ou um colchete faltando quebra o arquivo inteiro).
O Claude consegue pesquisar, mas não retorna resultados
Sua integração não foi conectada a nenhuma página. Volte ao Passo 2 e compartilhe as páginas relevantes com a sua integração.
Erros de autenticação quando o Claude tenta acessar o Notion
Provavelmente o token da sua integração foi digitado incorretamente. Volte a notion.so/my-integrations, gere o token novamente e atualize o arquivo de configuração.
O Claude consegue ler páginas, mas não consegue atualizá-las
Verifique as capabilities da sua integração. Acesse notion.so/my-integrations, abra sua integração e confirme que "Update content" e "Insert content" estão ativados.
Claude Desktop vs Claude Code: qual usar?
| Claude Desktop | Claude Code | |
|---|---|---|
| Ideal para | Usuários não técnicos, redatores, operadores | Desenvolvedores, equipes técnicas |
| Complexidade da configuração | Moderada (configuração em JSON) | Baixa (comando de CLI) |
| Plugin do Notion | Configuração manual do MCP | Plugin oficial disponível |
| Slash commands | Não | Sim (com o plugin) |
| Recomendado para equipes de SaaS | Marketing, CS, Ops | Produto, Engenharia |
Ambas as opções usam o mesmo servidor MCP do Notion e oferecem acesso idêntico ao seu workspace. A diferença é a preferência de interface, não a capacidade.
Perguntas frequentes
O que é o servidor MCP do Notion e como ele funciona com o Claude?
O servidor MCP do Notion é uma integração oficial que usa o Model Context Protocol para dar ao Claude acesso direto de leitura e escrita ao seu workspace do Notion. O Claude envia solicitações ao servidor MCP, que as traduz em chamadas da API do Notion. O resultado é que o Claude pode pesquisar, ler, criar e atualizar conteúdo do Notion por meio de linguagem natural, sem nenhum copia e cola manual.
A integração do Claude com o Notion MCP é gratuita?
O servidor Notion MCP em si é gratuito e de código aberto. Você precisa de um plano do Claude que ofereça suporte ao uso de ferramentas MCP (Claude Pro ou superior para o Claude Desktop, ou o Claude Code, que tem preços próprios). O plano gratuito do Notion aceita integrações, então não é necessário um plano pago do Notion.
Como adiciono o Notion MCP especificamente ao Claude Code?
Execute claude mcp add notionhq/notion-mcp-server no terminal do Claude Code e siga as instruções para inserir o token da sua integração do Notion. Se preferir, instale o plugin oficial do Notion para o Claude Code a partir do makenotion/claude-code-notion-plugin repositório do GitHub, que adiciona o servidor MCP e comandos slash prontos em uma única etapa.
O Claude pode editar minhas páginas do Notion ou apenas lê-las?
O Claude pode ler, criar e atualizar páginas e itens de bancos de dados do Notion, desde que sua integração tenha as permissões corretas ativadas. Acesse notion.so/my-integrations e confirme que as opções "Update content" e "Insert content" estão ativas na sua integração.
É seguro conectar o Claude ao meu workspace do Notion?
As integrações do Notion só acessam as páginas que você compartilha explicitamente com elas. O Claude não consegue ver nenhuma página fora das que você conectou. O token da sua integração deve ser mantido em sigilo e armazenado apenas no seu arquivo de configuração local, nunca em um repositório compartilhado ou público.
Contribuição de
SaaS Hackers
