# Agente Notion MCP

> Um agente Notion baseado em terminal para interagir com as suas páginas Notion utilizando linguagem natural através do servidor Notion MCP (Protocolo de Contexto do Modelo).

- Fonte: https://doutorai.pt/apps/notion-mcp-agent
- Categoria: Agentes MCP
- Dificuldade: Avançado
- Modelos: OpenAI
- Frameworks: Agno
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: NOTION_API_KEY, NOTION_TOKEN, OPENAI_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 📑 Notion MCP Agent

### 🎓 TUTORIAL GRATUITO Passo-a-Passo 
**👉 [Clica aqui para seguir o nosso tutorial completo passo-a-passo](https://www.theunwindai.com/p/build-a-terminal-based-notion-agent-with-mcp) 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:

```bash
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](https://www.notion.so/my-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:

```bash
python notion_mcp_agent.py
```

```markdown
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):
```

```bash
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"

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/notion-mcp-agent