# Notion MCP

Servidor oficial de Model Context Protocol (MCP) hospedado pela Notion. Conecta de forma segura ferramentas de IA como Claude, Cursor e ChatGPT ao seu espaço de trabalho do Notion para operações de leitura, pesquisa, criação e atualização em tempo real via OAuth — sem chaves de API ou auto-hospedagem necessárias.

Canonical URL: https://a2a-mcp.org/entry/notion-mcp-pt

Language: pt

Category: MCP Servers

Updated: 2026-03-24

## 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.
![Imagem](https://cdn.a2a-mcp.org/blog/G3-NFZaElpXp2ZSBVQYZv.webp)

## 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](https://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.

## Tags

- notion
- mcp
- model-context-protocol
- integração-de-ia
- servidor-hospedado
- oauth
- claude
- cursor
- produtividade
- banco-de-dados
- espaço-de-trabalho

## Sources

- [Project website](https://developers.notion.com/guides/mcp/mcp)
