Notion MCP

Visão Geral

O Notion MCP é o servidor oficial hospedado do Model Context Protocol (MCP) fornecido pela Notion. Ele permite que assistentes de IA e agentes interajam de forma segura e eficiente com espaços de trabalho do Notion, usando o padrão aberto do MCP.

Em vez de gerenciar chaves de API ou hospedar localmente, os usuários se conectam via um simples OAuth 2.0 com PKCE. O servidor é executado em https://mcp.notion.com/mcp (transporte HTTP com streaming recomendado) e https://mcp.notion.com/sse (alternativa de fallback).

Ele é mantido ativamente pela Notion e otimizado para fluxos de trabalho de IA modernos, substituindo o legado notion-mcp-server de código aberto, que não é mais mantido ativamente.

Principais Funcionalidades

• Autenticação Segura OAuth: Escopo granular de permissões durante a conexão — sem tokens de longa duração expostos.
• 20+ Ferramentas Otimizadas para IA: Inclui notion-search (em todo o espaço de trabalho e fontes conectadas como Slack, Google Drive, Jira), consultas a bancos de dados (atualizadas para a API de 2025-09-03 com fontes de dados), criação de páginas, adição de blocos, atualização de propriedades, comentários e muito mais.
• Acesso Bidirecional em Tempo Real: Leia conteúdo rico (convertido automaticamente para Markdown para eficiência de tokens), crie/atualize páginas e bancos de dados, adicione comentários.
• Infraestrutura Zero: Totalmente hospedado e sempre atualizado — sem necessidade de Docker, servidores ou manutenção.
• Suporte a Streaming: Transporte moderno para respostas mais rápidas e melhor experiência do agente.
• Ampla Compatibilidade com Clientes: Suporte nativo no Claude Desktop, Cursor, VS Code, ChatGPT (com ajustes nos nomes das ferramentas) e em clientes MCP personalizados.

Como Funciona

A Notion hospeda tanto o servidor MCP quanto a API subjacente do Notion. Os clientes MCP em suas ferramentas de IA descobrem automaticamente as ferramentas disponíveis, as invocam via linguagem natural e recebem resultados estruturados. Um pipeline de geração de código converte os esquemas OpenAPI da Notion em ferramentas MCP validadas (usando Zod), garantindo alta qualidade e consistência.

Opções de Configuração

• Recomendado: Conexão de um clique na galeria ou importação direta por URL (https://mcp.notion.com/mcp).
• Claude: claude mcp add --transport http notion https://mcp.notion.com/mcp e autentique via /mcp.
• Cursor: Adicione como servidor MCP global nas configurações.
• Clientes Personalizados: Siga o guia de OAuth + PKCE da Notion para construir suas próprias integrações.

Notion MCP vs. Servidor de Código Aberto Legado

O repositório GitHub legado (makenotion/notion-mcp-server) ainda está disponível, mas não é mais mantido ativamente. A Notion recomenda fortemente a versão hospedada por segurança, desempenho, facilidade de uso e compatibilidade com as últimas alterações da API.

Casos de Uso

• Trabalhadores do conhecimento resumindo anotações e criando automaticamente itens de ação.
• Desenvolvedores referenciando especificações/bancos de dados do Notion diretamente no Cursor ou Claude durante a codificação.
• Equipes construindo agentes autônomos que gerenciam roadmaps, wikis, tarefas e comentários.
• Criadores de conteúdo gerando e mantendo documentos vivos com referências cruzadas em tempo real.

Ferramentas Suportadas (Lista Parcial)

• notion-search — busca de texto completo poderosa com filtros.
• Operações com bancos de dados e fontes de dados (consulta, criação, atualização).
• Gerenciamento de páginas e blocos (anexar, atualizar texto enriquecido).
• Comentários e listagem de espaços de trabalho.

As ferramentas são mantidas atualizadas com a evolução da API do Notion.

Primeiros Passos

Visite a documentação oficial em developers.notion.com/guides/mcp/mcp para conectar suas ferramentas de IA hoje.

O Notion MCP representa o padrão para integração perfeita e segura entre IA e ferramentas de produtividade — o “USB-C para agentes de IA” no ecossistema Notion.