Notion

Conecta assistentes de IA ao seu espaço de trabalho do Notion para pesquisar e gerenciar páginas, bancos de dados e conteúdo.

GitHub
11
Experimente este MCPPatrocinado

Documentação

Servidor MCP do Notion

Um servidor Model Context Protocol (MCP) que conecta o Claude e outros assistentes de IA ao seu espaço de trabalho do Notion. Esta integração permite que assistentes de IA interajam com seus bancos de dados, páginas e blocos do Notion.

O que é isto?

Esta ferramenta atua como uma ponte entre assistentes de IA (como o Claude) e seu espaço de trabalho do Notion. Ela permite que a IA:

  • Visualize e pesquise seus bancos de dados do Notion
  • Crie e atualize páginas
  • Gerencie blocos de conteúdo
  • E muito mais!

Guia de Configuração Passo a Passo

Pré-requisitos

  • Node.js (versão 14 ou superior)
  • Uma conta no Notion
  • Aplicativo Claude Desktop (se for usar com o Claude)

1. Obtendo sua Chave de API do Notion

  1. Acesse https://www.notion.so/my-integrations
  2. Clique no botão azul "+ New integration"
  3. Preencha os detalhes:
    • Nome: Escolha um nome como "Claude Assistant" ou "AI Helper"
    • Logotipo: Opcional
    • Espaço de trabalho associado: Selecione seu espaço de trabalho do Notion
  4. Clique em "Submit"
  5. Na próxima página, encontre a seção "Internal Integration Token"
  6. Clique em "Show" e copie o token (ele começa com secret_)

2. Configurando Este Servidor

Baixando o Repositório

Opção A: Baixar como ZIP (Recomendado para iniciantes)

  1. Acesse o repositório do GitHub: https://github.com/Sjotie/notionMCP/
  2. Clique no botão verde "Code" no canto superior direito
  3. Selecione "Download ZIP"
  4. Após o download, extraia o arquivo ZIP para um local no seu computador
    • Windows: Clique com o botão direito no arquivo ZIP e selecione "Extract All"
    • Mac: Clique duas vezes no arquivo ZIP para extrair

Opção B: Clonar com Git (Para usuários familiarizados com Git)

  1. Abra um prompt de comando ou terminal
    • Windows: Pressione Win+R, digite cmd e pressione Enter
    • Mac: Abra o Terminal em Applications > Utilities
  2. Navegue até onde deseja armazenar o repositório 
    cd path/to/desired/location
  3. Clone o repositório 
    git clone https://github.com/Sjotie/notionMCP/

Navegando para o Diretório do Projeto

Após baixar ou clonar, você precisa navegar até a pasta do projeto usando o comando cd (change directory):

Se você baixou o ZIP (Opção A):

  1. Abra um prompt de comando ou terminal

  2. Use o comando cd para navegar até onde você extraiu o arquivo ZIP:

    cd path/to/extracted/folder/notionMCP

    Por exemplo:

    • No Windows: cd C:\Users\YourName\Downloads\notionMCP
    • No Mac: cd /Users/YourName/Downloads/notionMCP

Se você clonou com Git (Opção B):

  1. O repositório deve ter sido clonado em uma pasta chamada "notionMCP"
  2. Se você ainda estiver na mesma janela do terminal após a clonagem, basta digitar: 
    cd notionMCP

Como saber se você está no diretório correto:

  • Após usar o comando cd, você pode verificar sua localização atual:
    • No Windows: Digite dir e pressione Enter - você deve ver arquivos como server.js
    • No Mac: Digite ls e pressione Enter - você deve ver arquivos como server.js

Instalando Dependências

Depois de estar no diretório notionMCP, instale as dependências necessárias:

npm install

Isso instalará todos os pacotes Node.js necessários. Você verá uma barra de progresso e, eventualmente, uma mensagem indicando que a instalação foi concluída. Pode dizer algo como "X Packages are looking for funding" - isso é completamente normal e significa que funcionou.

3. Conectando-se às Páginas do Notion

Por segurança, o Notion exige que você conceda acesso explicitamente a cada página ou banco de dados:

  1. Abra o Notion e navegue até uma página ou banco de dados que você deseja que a IA acesse
  2. Clique nos "•••" (três pontos) no canto superior direito
  3. Selecione "Add connections"
  4. Encontre e selecione a integração que você criou anteriormente
  5. Repita para quaisquer outras páginas ou bancos de dados que você deseja tornar acessíveis

4. Conectando-se ao Claude Desktop

  1. Localize seu arquivo de configuração do Claude Desktop:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json (Digite este caminho na barra de endereços do File Explorer)
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (No Finder, pressione Cmd+Shift+G e cole este caminho)

  2. Abra o arquivo em um editor de texto. Se ele não existir, crie-o com o seguinte conteúdo:

    {
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "C:\\path\\to\\notion-mcp-server\\server.js"
      ],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
      }
    }
  }
}

  3. Substitua:

    • C:\\path\\to\\notion-mcp-server\\server.js pelo caminho real para o arquivo server.js
      • Windows: Use barras invertidas duplas (\\) no caminho
      • Mac: Use barras normais (/)
    • your_notion_api_key_here pela sua chave de API do Notion

  4. Salve o arquivo e reinicie o Claude Desktop

5. Testando a Conexão

  1. Inicie uma nova conversa no Claude
  2. Peça ao Claude para interagir com seu espaço de trabalho do Notion, por exemplo:
    • "Mostre-me uma lista dos meus bancos de dados do Notion"
    • "Crie uma nova página no meu banco de dados Tasks com o título 'Test Task'"

Ferramentas Disponíveis

O servidor fornece estas ferramentas aos assistentes de IA:

  • list-databases: Visualizar todos os bancos de dados acessíveis
  • query-database: Obter entradas de um banco de dados
  • create-page: Adicionar uma nova página a um banco de dados
  • update-page: Modificar uma página existente
  • create-database: Criar um novo banco de dados
  • update-database: Modificar a estrutura de um banco de dados
  • get-page: Visualizar uma página específica
  • get-block-children: Visualizar blocos de conteúdo
  • append-block-children: Adicionar conteúdo a uma página
  • update-block: Editar blocos de conteúdo
  • get-block: Visualizar um bloco específico
  • search: Encontrar conteúdo em todo o seu espaço de trabalho

Solução de Problemas

Problemas Comuns:

  1. "Connection failed" no Claude

    • Certifique-se de que o caminho do servidor no claude_desktop_config.json está correto
    • Verifique se sua chave de API do Notion é válida
    • Garanta que o Node.js está instalado

  2. "Access denied" ao acessar conteúdo do Notion

    • Certifique-se de que você compartilhou a página/banco de dados com sua integração
    • Verifique se sua chave de API tem as permissões necessárias

  3. O servidor não inicia

    • Garanta que todas as dependências estão instaladas (npm install)
    • Verifique se o arquivo .env existe com sua chave de API

Obtendo Ajuda

Se você encontrar problemas não abordados aqui, por favor:

  • Verifique a saída do console para mensagens de erro
  • Garanta que sua chave de API do Notion é válida
  • Verifique se sua integração tem acesso às páginas/bancos de dados

Licença

MIT