Notion

Integre com espaços de trabalho do Notion para gerenciar bancos de dados, páginas e conteúdo.

GitHub
4

Documentação

Notion MCP Server

Um servidor Model Context Protocol (MCP) para integração com workspaces do Notion. Este servidor fornece uma interface padronizada para que modelos de IA acessem, consultem e modifiquem conteúdo no Notion.

Pré-requisitos

  • Node.js (v16 ou superior)
  • Chave de API do Notion (das suas integrações do Notion)
  • Workspace do Notion conectado com as permissões adequadas

Instalação

  1. Clone este repositório:

    git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

  2. Instale as dependências:

    npm install

  3. Crie um arquivo .env no diretório raiz com sua chave de API do Notion:

    # Required
NOTION_API_KEY=your_notion_api_key_here

# Optional settings
DEBUG=false
REQUIRE_CONFIRMATION_FOR_CREATE=true
REQUIRE_CONFIRMATION_FOR_UPDATE=true
REQUIRE_CONFIRMATION_FOR_DELETE=true
UPDATE_POLLING_INTERVAL=60000
MAX_BLOCK_DEPTH=3
BACKUP_DIR=./backups
BACKUP_RETENTION_DAYS=30
MAX_BACKUPS_PER_PAGE=5

  4. Compile o projeto:

    npm run build

  5. Inicie o servidor:

    npm start

Usando com o Claude for Desktop

Para usar este servidor MCP do Notion com o Claude for Desktop:

  1. Certifique-se de que o Claude for Desktop esteja instalado e atualizado para a versão mais recente

  2. Abra o arquivo de configuração do Claude for Desktop:

    • No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • No Windows: %APPDATA%\Claude\claude_desktop_config.json

  3. Adicione a configuração do servidor:

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

  4. Salve o arquivo e reinicie o Claude for Desktop

Recursos

O servidor expõe os seguintes recursos:

URI do RecursoDescrição
notion://databasesLista todos os bancos de dados no workspace
notion://databases/{databaseId}/schemaRecupera o esquema de um banco de dados específico
notion://databases/{databaseId}/contentRecupera todas as páginas/itens de um banco de dados específico
notion://pages/{pageId}Recupera o conteúdo de uma página específica
notion://updatesRecupera atualizações e alterações recentes no workspace

Ferramentas

O servidor fornece as seguintes ferramentas:

Prompts

O servidor inclui estes prompts pré-configurados:

Nome do PromptDescrição
upcoming-deadlinesObter uma lista de prazos futuros
project-statusResumir o status de um projeto
daily-tasksObter uma lista de tarefas para hoje

Exemplos de Consultas

Depois de conectado ao Claude, você pode fazer perguntas em linguagem natural sobre seu workspace do Notion:

  1. "Quais tarefas vencem hoje no meu workspace?"
  2. "Mostre-me o status do Projeto X"
  3. "Crie uma nova página no meu banco de dados 'Ideias' com o título 'Novo Conceito de Recurso'"
  4. "Atualize o status da tarefa Y para 'Concluída'"
  5. "Quais alterações foram feitas no meu workspace nas últimas 24 horas?"
  6. "Resuma os prazos futuros para a próxima semana"
  7. "Mostre-me todos os backups da página abc123"
  8. "Restaure a página abc123 a partir do arquivo de backup page_abc123_2023-01-01.json"

Estendendo o Servidor

Para adicionar novas funcionalidades:

  1. Adicionar Recursos: Estenda os manipuladores de recursos em index.ts
  2. Adicionar Ferramentas: Crie novas definições de ferramentas em index.ts
  3. Adicionar Prompts: Defina novos modelos de prompts em index.ts
  4. Aprimorar a Integração com a API: Adicione novas funções de API em notion-api.ts

Logs

Verifique os logs do servidor para obter informações detalhadas sobre erros:

  • Logs do Claude for Desktop: Procure nos diretórios de logs do Claude os logs relacionados ao MCP
  • Saída do Servidor: Verifique os fluxos de saída padrão e de erro para os logs do servidor