Criei um Agente que Documenta Tudo no Notion
Eu tenho um problema. Não é um problema de "meu código não compila". É um problema de "eu tenho tantas ideias, projetos e anotações que meu cérebro quase explode e reinicia". 😵💫
Então... eu fiz o que qualquer desenvolvedor razoável faria, certo? Eu construí um agente de IA dentro do Open Claw cuja única função é documentar tudo de forma bonita no Notion. Seu nome é Escriber e ele é meu novo documentador.
Esta é minha submissão para o Desafio Notion MCP. Deixe-me te dizer, construir um agente focado em um único propósito com 14 ferramentas do Notion é exatamente tão satisfatório quanto parece.
O Que Eu Construí
Escriber é o agente #2 de 5 na minha equipe multi-agente OpenClaw.
Seu SOUL.md diz exatamente isso: "Eu documento. Bonito. No Notion." E para quem não usou o OpenClaw, eles fornecem a esses agentes arquivos Soul.md que definem quem o agente é e dão a ele uma pequena personalidade.
É isso. Ponto final. Ele não pode depurar seu código. Ele não pode dar conselhos de vida. Ele tem uma única função e ele se mantém nela — o que, honestamente, é mais disciplina do que eu tenho na maior parte do tempo. 😆
Ele vive no Discord como um bot ou posso usar a interface de chat da web para chamá-lo diretamente. Ele pode ser ligeiramente artesanal. O humor seco é incorporado por design, porque a documentação não precisa ser sem alma. Ele utiliza meu bot Synap para escrever resumos de projetos e limpá-los como eu diria, então ele armazenará o que o Synap enviar de volta.
Ele não é um canivete suíço. Ele é um escalpelo. E às vezes isso é exatamente o que você precisa.
Demonstração em Vídeo
Mostre-nos o Código
Escriber se comunica com o Notion através do mcporter — um relay MCP que faz proxy de chamadas de ferramentas para o servidor MCP oficial do Notion. Cada interação com o Notion se parece com isso:
mcporter call notion.<tool_name> --args '{ ... }'
Limpo. Consistente. Um padrão para governá-los todos.
Aqui está o arsenal completo — 14 ferramentas, um agente, zero desculpas para projetos não documentados:
| Ferramenta | O Que Ela Faz |
|---|---|
notion.search |
Encontrar páginas/bancos de dados existentes antes de criar duplicatas |
notion.create_page |
Criar uma nova página em qualquer lugar no espaço de trabalho |
notion.retrieve_page |
Leia os metadados de uma página |
notion.update_page |
Atualizar propriedades da página |
notion.append_block_children |
Adicionar blocos de conteúdo a uma página existente |
notion.retrieve_block_children |
Ler o que já está em uma página |
notion.retrieve_block |
Buscar um bloco específico |
notion.update_block |
Editar um bloco existente |
notion.delete_block |
Remover um bloco |
notion.create_database |
Criar um novo banco de dados |
notion.retrieve_database |
Ler a estrutura do banco de dados |
notion.update_database |
Modificar o esquema do banco de dados |
notion.query_database |
Filtrar e pesquisar entradas do banco de dados |
notion.create_database_item |
Adicionar uma linha a um banco de dados |
Escriber também tem regras de fluxo de trabalho incorporadas em suas instruções. Porque ferramentas sem disciplina são apenas caos com uma API:
- Pesquisar primeiro. Sempre verifique se a página já existe antes de criar uma nova.
- Ler antes de escrever. Recupere os filhos do bloco antes de adicionar para evitar desastres estruturais.
- Tipo de bloco certo. Chamadas para decisões. Toggles para detalhes. Títulos para estrutura. Nem tudo é um parágrafo.
- Estruturar intencionalmente. Meça duas vezes, corte uma vez. 🤣
Como Eu Usei o Notion MCP
Deixe-me te contar como isso realmente funciona.
mcporter conecta Escriber ao servidor MCP oficial do Notion em https://mcp.notion.com/mcp. Cada chamada de ferramenta é feita através desse relay — sem manipulação direta da API, sem construtores de solicitações personalizados. A camada MCP cuida disso. Escriber apenas fala a ferramenta.
Aqui está como isso se parece no dia a dia:
Um novo projeto começa?
create_page para criar o hub do projeto. create_database_item para registrá-lo no banco de dados mestre de projetos. Feito em segundos.
Finalizando uma sessão de construção?
append_block_children à página do projeto existente. Notas de construção, decisões tomadas, o que quebrou, o que não quebrou. Estruturado. Com data/hora. Realmente encontrável depois.
Listagens de Emprego do JB
create_page Meu agente recrutador armazenou uma lista de empregos usando o Escriber todas as manhãs. O meu eu futuro ficará grato. O meu eu passado não estava fazendo isso. Estes são armazenados no Notion diariamente e são classificáveis ☠️
Deixe-me te contar sobre o momento de vergonha que tornou isso real.
Eu voltei a revisar meu próprio espaço de trabalho no Notion algumas semanas atrás. Páginas com títulos como "ideias v3 FINAL" e "notas do projeto NÃO DELETAR" contendo exatamente... três pontos e um link do YouTube. É isso. Esse é o legado. Um cemitério de boas intenções. ☠️
Escriber existe porque eu precisava de alguém com mais disciplina de documentação do que eu. Acontece que alguém é um agente de IA focado com um arquivo de alma e 14 ferramentas do Notion.
Uma função. Uma lane. Personalidade real. E a documentação realmente está sendo escrita agora.
"A otimização começa com um único ponto de falha — ou um único ponto de sucesso. Possua a lane."
Além disso, obrigado ao Bloggy, por dedicar tempo para ajudar com este post.
Escriber é parte da minha equipe de agentes OpenClaw. Se você está curioso sobre como construir configurações multi-agente no openclaw, deixe um comentário — estou escrevendo mais sobre toda essa pilha à medida que ela se junta.
A implementação de agentes de IA como Escriber pode ajudar empresas brasileiras a otimizar a documentação e organização de projetos. Isso pode resultar em maior eficiência e clareza nas comunicações internas, além de facilitar o acesso a informações importantes. A adoção de tais soluções pode ser um diferencial competitivo no mercado.
