Todos os artigos
AFFiNE
Toeverything·Publicado 20 de ago. de 2026
Um painel de texto e um painel de canvas ligados à mesma porta MCP

Notion MCP: como funciona, conexão e limites (2026)

Resumo em 30 segundos

  • O Notion MCP é o servidor MCP oficial do Notion: conectado uma vez, Claude, ChatGPT e Cursor conseguem buscar nas suas páginas, consultar bancos de dados e — onde você permitir — criar páginas.
  • A conexão usa OAuth e leva minutos; nada de copiar chave de API, é uma autorização com a sua conta do Notion.
  • Dois limites são estruturais: o servidor oficial atual é só hospedado (sem auto-hospedagem), e o visual — quadros brancos, diagramas — não existe no modelo de dados do Notion.
  • Se as decisões do seu time também moram em quadros brancos, ou se auto-hospedar é inegociável, o servidor MCP embutido do AFFiNE cobre mais terreno (tabela comparativa no fim).

Este guia mostra o que o Notion MCP faz de verdade, como conectar em cada cliente, os limites que pegam de surpresa e os casos em que outro servidor é a escolha certa. Se MCP ainda é novidade, comece por o que é um servidor MCP.

O que é o Notion MCP

Notion MCP é o servidor oficial hospedado pelo Notion. Em vez de cada aplicativo de IA escrever a própria integração, ele expõe as capacidades do workspace como ferramentas tipadas que qualquer cliente MCP chama: buscar páginas, ler conteúdo, consultar bancos de dados e criar ou atualizar páginas com todas as permissões do usuário do Notion que concluir o OAuth.

Duas premissas antes de conectar:

  • Quem hospeda é o Notion. A autorização passa pela sua conta e o servidor roda na infraestrutura do Notion. Operar você mesmo o servidor oficial atual não está previsto; houve um servidor open source antes, mas foi descontinuado.
  • O usuário conectado define o limite de acesso. O servidor hospedado recebe todas as permissões do usuário do Notion que conclui o OAuth; não aparece um seletor de páginas durante a autorização. Para restringir o alcance, use uma conta dedicada com menos permissões.
Fluxo OAuth que leva as permissões do usuário conectado a páginas e bancos de dados pelo Notion MCP
O servidor hospedado age com as permissões de quem conclui o OAuth; não há um seletor de páginas separado.

O que dá para fazer

O valor prático se concentra em três usos:

  • Perguntar às notas reais. «O que decidimos sobre o preço do onboarding?» responde a partir da página da reunião, não de um chute do modelo.
  • Consultar bancos de dados em linguagem natural. Filtrar tarefas atrasadas, resumir o pipeline comercial, listar bloqueios do lançamento — consultas estruturadas feitas em português.
  • Rascunhar direto no workspace. Onde você permitir, os assistentes criam páginas ou complementam: resumo de reunião no banco certo, notas de pesquisa direto no Notion.

Como conectar, cliente por cliente

O fluxo oficial é parecido em todos: adicione o servidor, conclua o OAuth no navegador e aprove o cliente.

  1. Claude (Desktop e claude.ai): adicione o Notion pelo diretório de conectores, ou aponte um conector personalizado para o endpoint MCP do Notion, e autorize na janela OAuth.
  2. Claude Code: adição por CLI com transporte HTTP; a autenticação termina via /mcp no primeiro uso. O padrão é o mesmo de adicionar servidores MCP ao Claude Code.
  3. Cursor: escreva o servidor do Notion no ~/.cursor/mcp.json, reinicie e autorize.
  4. ChatGPT: os conectores aceitam servidores MCP; personalizados exigem o modo de desenvolvedor. A autorização é com a sua conta do Notion.

Depois teste com uma pergunta cuja resposta você conhece: «ache a página em que comparamos orçamentos de fornecedores e liste os finalistas». Se nada aparecer, confirme primeiro que a conta conectada encontra a página no Notion e depois revise as permissões de ferramentas do cliente.

Permissões e limites do plano antes de conectar

O guia de segurança do Notion é direto: o servidor MCP hospedado pode agir com todas as permissões do usuário conectado. Administradores do Enterprise podem aprovar ou bloquear clientes MCP, mas a conta OAuth continua sendo a principal fronteira no uso diário. Quando precisar restringir o alcance, use uma conta dedicada com permissões mínimas e revogue conexões que não usa mais.

A busca em páginas do Notion tem ampla disponibilidade. Já a busca em fontes conectadas, como Slack, Google Drive ou Jira, depende do Notion AI e do plano. As ferramentas disponíveis também podem variar por workspace; consulte a lista oficial de ferramentas compatíveis.

Limite de permissões entre a busca interna do Notion e fontes externas sujeitas a um plano de IA
As permissões do espaço de trabalho limitam o alcance do MCP; a busca em fontes conectadas também pode exigir um plano do Notion AI.

Os limites que pegam de surpresa

  • Só hospedado. Não há caminho de auto-hospedagem para o servidor oficial atual. Se a conformidade exige a infraestrutura de conhecimento nas suas máquinas, o desencontro é estrutural, não de configuração.
  • Texto e bancos de dados, não canvas. O modelo de dados do Notion são páginas e bancos. Quadros brancos, diagramas, murais de post-its: o servidor não busca o que o produto não modela.
  • O servidor hospedado não aceita Bearer Token de conta de serviço. O fluxo compatível usa OAuth de usuário; automações sem supervisão exigem outro desenho de integração.
  • A busca com IA mais profunda é paga. A busca por IA do Notion através de aplicativos externos pertence aos planos de IA; a conexão MCP dá acesso às ferramentas, não destrava essas funções.

Nada disso é fatal para um time que vive em bancos de dados. Pesa quando o conhecimento é visual — ou quando auto-hospedar é requisito.

Quando o AFFiNE MCP encaixa melhor

O AFFiNE resolve o mesmo problema — deixar o workspace legível para os assistentes — partindo de outro ponto: documentos e quadros brancos num espaço só, com o servidor MCP embutido tratando os dois como cidadãos de primeira classe.

Notion MCPAFFiNE MCP
ServidorOficial, hospedado pelo NotionOficial, embutido no produto
Auto-hospedagemNão prevista (servidor atual)Sim — o mesmo servidor em instâncias auto-hospedadas
Quadros brancosFora do modelo de dadosA busca indexa o texto do canvas e devolve localizações de elementos e quadros
BuscaConteúdo do Notion dentro de todas as permissões do usuário; fontes externas exigem Notion AIPalavra-chave + semântica no workspace inteiro, conforme suas permissões
CredenciaisOAuth de usuário; a conexão herda as permissões dele no workspacePor cliente, com validade e revogação imediata, somente leitura por padrão
CustoConexão gratuitaGrátis no Cloud e auto-hospedado com recursos de IA ativados

Comparação baseada em capacidades documentadas publicamente, em agosto de 2026.

A diferença que os times sentem primeiro são os quadros brancos. Decisão raramente mora só na prosa — mora no diagrama da revisão de arquitetura, nos post-its da retrospectiva. Um servidor que busca onde o pensamento aconteceu responde perguntas que um servidor só-texto não alcança. E a configuração fica dentro do produto: Configurações → Integrations → MCP Server → Create credential → colar o JSON gerado no cliente.

Levando a comparação para o plano do produto, o corte honesto: times de operações centrados em bancos de dados vão bem com o Notion; times cujo conhecimento mistura documentos com trabalho visual, de olho em auto-hospedagem, vão melhor com o AFFiNE. Para a camada de acesso de IA, a tabela acima decide.

Perguntas frequentes

O Notion MCP é grátis?

Conectar é grátis com uma conta do Notion, e o acesso básico às ferramentas funciona em workspaces gratuitos. Os recursos de IA do próprio Notion — como a busca por IA através de aplicativos conectados — pertencem aos planos pagos; a conexão MCP não os destrava.

O Notion MCP funciona com o ChatGPT?

Funciona. O ChatGPT aceita MCP pelos conectores, com servidores personalizados no modo de desenvolvedor. Claude, Claude Code, Cursor e Cline também conectam — esse é justamente o ponto do MCP: um servidor, todos os assistentes compatíveis.

Dá para auto-hospedar o Notion MCP?

Não. O servidor oficial atual existe apenas hospedado pelo Notion, e o antigo open source foi descontinuado. Se a sua base de conhecimento acessível por IA precisa rodar na sua infraestrutura, o AFFiNE oferece auto-hospedado o mesmo servidor MCP do Cloud.

O Notion MCP busca em quadros brancos ou diagramas?

Não — o modelo de dados do Notion são páginas e bancos de dados; não há conteúdo de canvas para buscar. O servidor MCP do AFFiNE indexa o texto do canvas Edgeless e devolve localizações de elementos e quadros, então diagramas e murais de post-its também aparecem na busca.

Qual é a diferença entre o Notion MCP e a API do Notion?

A API é a interface de programação do Notion, feita para desenvolvedores. O servidor MCP adiciona por cima uma camada padrão: as capacidades do workspace viram ferramentas tipadas que os assistentes descobrem e chamam sozinhos. Usar MCP quase não exige código — uma autorização OAuth e um trecho de configuração.

Resumindo

Conecte o servidor que está onde as decisões do seu time realmente moram. Se for em bancos de dados, o Notion MCP dá conta. Se for em documentos e no quadro branco onde o plano nasceu — entregue os dois ao seu assistente: a configuração leva minutos e não adiciona cobrança MCP quando os recursos de IA estão ativados.