Agente Notion MCP

🎓 TUTORIAL GRATUITO Passo-a-Passo

👉 Clica aqui para seguir o nosso tutorial completo passo-a-passo e aprende a construir isto do zero com explicações detalhadas de código e melhores práticas.

Um agente Notion baseado em terminal para interagir com as tuas páginas Notion utilizando linguagem natural através do servidor Notion MCP (Model Context Protocol).

Funcionalidades

• Interage com páginas Notion através de uma interface de linha de comandos
• Realiza operações de atualização, inserção e recuperação nas tuas páginas Notion
• Cria e edita blocos, listas, tabelas e outras estruturas Notion
• Adiciona comentários a blocos
• Pesquisa por informações específicas
• Lembra o contexto da conversa para interações de múltiplos turnos
• Gestão de sessões para conversas persistentes

Pré-requisitos

• Python 3.10+
• Uma conta Notion com permissões de administrador
• Um token de Integração Notion
• Uma chave de API OpenAI

Instalação

1. Clona o repositório
2. Instala os pacotes Python necessários:

pip install -r requirements.txt

3. Instala o servidor Notion MCP (será feito automaticamente quando executares a aplicação)

Configuração da Integração com o Notion

Criar uma Integração com o Notion

1. Vai a Notion Integrations
2. Clica em "Nova integração"
3. Nomeia a tua integração (por exemplo, "Notion Assistant")
4. Seleciona as capacidades necessárias (Ler e Escrever conteúdo)
5. Submete e copia o teu "Token de Integração Interna"

Partilhar a Tua Página do Notion com a Integração

1. Abre a tua página do Notion
2. Clica nos três pontos (⋮) no canto superior direito da página
3. Seleciona "Adicionar conexões" no menu dropdown
4. Procura o nome da tua integração na caixa de pesquisa
5. Clica na tua integração para a adicionar à página
6. Confirma clicando em "Confirmar" na caixa de diálogo que aparece

Alternativamente, também podes partilhar através do botão "Partilhar":

1. Clica em "Partilhar" no canto superior direito
2. Na caixa de diálogo de partilha, procura o nome da tua integração (precedido por "@")
3. Clica na tua integração para a adicionar
4. Clica em "Convidar" para conceder acesso à tua página

Ambos os métodos concederão à tua integração acesso total à página e ao seu conteúdo.

Encontrar o ID da Tua Página do Notion

1. Abre a tua página do Notion num navegador
2. Copia a URL, que se parece com:

https://www.notion.so/workspace/Your-Page-1f5b8a8ba283...

3. O ID é a parte após o último hífen e antes de quaisquer parâmetros de consulta

Exemplo: 1f5b8a8bad058a7e39a6

Configuração

Podes configurar o agente utilizando variáveis de ambiente:

• NOTION_API_KEY: O teu token de Integração do Notion
• OPENAI_API_KEY: A tua chave da API do OpenAI
• NOTION_PAGE_ID: O ID da tua página do Notion

Alternativamente, podes definir estes valores diretamente no script.

Utilização

Executa o agente a partir da linha de comando:

python notion_mcp_agent.py

Quando inicias o agente, ele irá pedir-te para introduzires o teu ID de página do Notion. Podes:

1. Introduzir o teu ID de página no prompt
2. Pressionar Enter sem escrever nada para usar o ID de página por defeito (se estiver definido)
3. Fornecer o ID da página diretamente como um argumento de linha de comando (ignorando o prompt):

python notion_mcp_agent.py your-page-id-here

Fluxo de Conversa

Cada vez que inicias o agente, ele cria um ID de utilizador único e um ID de sessão para manter o contexto da conversa. Isto permite que o agente se lembre de interações anteriores e continue conversas coerentes mesmo depois de fechares e reiniciares a aplicação.

Podes sair da conversa a qualquer momento digitando exit, quit, bye ou goodbye.

Exemplos de Consultas

• "O que está na minha página do Notion?"
• "Adiciona um novo parágrafo a dizer 'Notas da reunião de hoje'"
• "Cria uma lista com marcadores com três itens: Maçã, Banana, Laranja"
• "Adiciona um comentário ao primeiro parágrafo a dizer 'Isto parece bom!'"
• "Procura por quaisquer menções a reuniões"
• "Resume a nossa conversa até agora"