---
title: "Criar sistema persistente de memória de IA na Cloudflare"
description: "Aprenda a criar um sistema de memória de IA persistente e auto-hospedado na Cloudflare com Second Brain e MCP. Partilhe o contexto entre Claude e Obsidian."
canonical_url: "https://techvoyage.dev/pt/article/use-cloudflare-as-ai-memory"
last_updated: "2026-10-20T09:53:43.042Z"
---

## A importância da memória persistente de IA para os agentes

À medida que os assistentes de IA se tornam integrados no nosso quotidiano, deparamo-nos frequentemente com o problema do contexto em branco. As decisões tomadas na semana passada são esquecidas, exigindo que introduzamos repetidamente os mesmos detalhes de stacks tecnológicas e redefinamos as preferências do utilizador em cada nova sessão.

Em vez de começar do zero a cada interação, precisamos de construir um sistema de memória que evolua, compreenda de forma contínua as escolhas do utilizador e elimine a necessidade de repetir o contexto constantemente.

## Sistemas de memória de IA auto-hospedados vs. integrados

Muitos agentes de IA vêm equipados com memória integrada, mas raramente limitamos o nosso fluxo de trabalho a um único assistente. Usamos o Claude para desenhar e arquitetar um projeto; o Kimi para programar; e o ChatGPT para pesquisa geral. O contexto não é partilhado entre estes diferentes agentes; permanece isolado em cada ferramenta de forma estanque.

Do ponto de vista da engenharia de software, evitamos caixas negras. Precisamos de um sistema de memória de IA observável, auditável e totalmente sob o nosso controlo direto. O projeto de código aberto [Second Brain](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare/tree/main), desenvolvido como um fork de [https://github.com/rahilp/second-brain-cloudflare](https://github.com/rahilp/second-brain-cloudflare), disponibiliza um sistema de memória persistente e auto-hospedado com suporte ao Model Context Protocol (MCP). Qualquer agente de IA compatível, como o Claude, ChatGPT ou Kimi Code, pode assim partilhar do mesmo contexto de memória unificado.

## Como criar um Second Brain de memória de IA na Cloudflare

O sistema de memória Second Brain é implementado sobre o **Cloudflare Workers**, proporcionando uma infraestrutura de servidores serverless distribuída globalmente com baixíssima latência. Isto permite que as operações de pesquisa de memória e armazenamento ocorram de forma quase instantânea na lógica de raciocínio da IA.

O modelo de embeddings do **Workers AI** é usado para gerar os vetores. Estes embeddings são guardados no **Cloudflare Vectorize**, que é uma base de dados vetorial altamente otimizada e distribuída. O **Cloudflare Vectorize** realiza buscas de similaridade por cosseno para identificar memórias com relevância sémântica.

O Second Brain conta também com mecanismos inteligentes de desduplicação e fusão. Textos com menos de 85% de similaridade sémântica são armazenados diretamente; caso contrário, são bloqueados ou marcados como potenciais duplicados. Textos longos que excedam 1.600 caracteres são fragmentados respeitando os limites de frases ou quebras de linha, mantendo uma sobreposição (overlap) de 200 caracteres para preservar a continuidade do assunto. Cada fragmento é então vetorizado para correspondências de alta precisão.

As seguintes ferramentas são expostas como interfaces MCP para utilização direta pelos agentes de IA:

- `remember`: Guardar ideias, decisões, preferências e contexto geral do projeto.
- `append`: Acrescentar novas informações ou atualizações a uma memória existente.
- `update`: Substituir uma memória existente por completo.
- `recall`: Localizar memórias com base no seu significado sémântico e não em palavras-chave exatas.
- `list_recent`: Listar as memórias gravadas recentemente.
- `forget`: Apagar de forma definitiva um registo de memória.
- `link/connections`: Conectar memórias relacionadas entre si (funcionalidade de grafo v2).

### Configuração do Second Brain na Cloudflare

1. Clique em `Deploy to Cloudflare` na página do [Github repo](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare). [[![Página do GitHub com o botão Deploy to Cloudflare destacado](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/deploy-to-cloudflare-button.webp)]]
2. Preencha o formulário do Cloudflare Worker apresentado.
![Formulário de configuração de implantação do Cloudflare Workers](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-deployment-form.webp)
3. Introduza '384' no campo Dimensions; selecione 'cosine' para Metric; e clique no botão Deploy.
![Tela de configuração de criação do banco de dados Cloudflare Vectorize](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-vectorize-configuration.webp)
4. O ecrã seguinte apresenta a visão geral do seu Second Brain no Cloudflare Worker:
![Painel de controle geral do worker do Second Brain implantado](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-second-brain-overview.webp)
5. Vá a 'Settings' (Definições) e clique no ícone de edição da variável 'AUTH_TOKEN' para criar uma chave de acesso segura:
![Configurações de variáveis do Cloudflare Worker destacando AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-settings.webp)
6. Clique no link 'Rotate' para poder definir o novo valor: ![Tela de modificação e rotação da variável AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-rotate.webp)![Inserindo a string aleatória gerada no campo de valor AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-value-input.webp)
7. Execute o comando `openssl rand -base64 32` no seu terminal macOS para gerar um valor aleatório seguro e cole-o no campo 'Value'.
8. Clique no botão 'Deploy' para guardar o novo valor da variável 'AUTH_TOKEN'.
9. Abra o endereço URL do seu worker do Second Brain no seu navegador de internet.
![Tela de login da interface web do Second Brain com entrada de Bearer Token](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-login.webp)
10. Introduza o 'AUTH_TOKEN' gerado no campo de input `Bearer token` e clique no botão 'Connect' para aceder ao painel de controlo (Web UI).

### Integração do Claude Desktop via MCP

1. Clique em 'Customize' nas definições do Claude Desktop.
![Interface do Claude Desktop apontando para o botão Customize](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-customize-button.webp)
2. Selecione 'Developer' para abrir e editar manualmente o ficheiro de configuração dos servidores MCP:
![Menu de configurações do desenvolvedor do Claude Desktop para aceder à configuração MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-developer-menu.webp)
3. Adicione o seguinte bloco de código à secção `mcpServers` no ficheiro `claude_desktop_config.json`:

```json
"second-brain": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker-url>/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }
```

![JSON de configuração do Claude Desktop MCP contendo o servidor do Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-config-json.webp)
4. Reinicie a aplicação Claude Desktop e confirme a lista de 'Local MCP servers'. O estado deve indicar 'running' (em execução).
![Claude Desktop exibindo o status ativo para o servidor MCP do Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-status-running.webp)

### Integração do Claude Code via MCP

- Execute o seguinte comando no terminal para adicionar o novo servidor MCP:

```shell
claude mcp add --transport http second-brain https://<your-worker-url>/mcp
```

- O Claude Code irá identificar que o ponto de acesso requer OAuth e abrirá uma janela no seu navegador de internet para que possa submeter o `AUTH_TOKEN`.
- Crie o ficheiro `CLAUDE.md` na diretoria `~/.claude` com as instruções descritas em [CLAUDE_INSTRUCTIONS.md](https://github.com/rahilp/second-brain-cloudflare/blob/main/AI_Instructions/CLAUDE_INSTRUCTIONS.md).

### Integração do Gemini CLI via MCP

1. Adicione a seguinte configuração de servidor MCP ao seu ficheiro './.gemini/settings.json':

```json
"second-brain": {
      "httpUrl": "https://<your-worker-url>/mcp",
      "oauth": {
        "enabled": true
      }
    }
```

1. Inicialize o Gemini CLI.

### Testar o Second Brain em agentes de IA

1. Ao definir uma paleta de cores de marca básica no **Claude Desktop**, o Second Brain não é ativado de imediato por padrão.
![Primeiro teste no Claude Desktop sem a camada de memória do Second Brain ativa](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-first-run-brand-palette.webp)
2. Ao utilizar comandos simples como 'remember', são chamadas as ferramentas integradas locais `memory_user-edits` do **Claude Desktop**, e não a camada de armazenamento remoto.
![Claude Desktop recorrendo às edições locais integradas em vez do Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-remember-built-in-tool-fallback.webp)
3. Ao enviar o seguinte comando no **Claude Code**, a integração com o Second Brain foi chamada com sucesso:

```text
Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black."
```

![Janela de terminal do Claude Code exibindo o acionamento bem-sucedido do Second Brain MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-code-second-brain-mcp-called.webp)
4. Verificação das novas definições de cor armazenadas diretamente no painel do **Second Brain na Cloudflare**:
![Verificando os códigos de cores da marca gravados na interface web do Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-color-verification.webp)
- *O Claude Code funcionou de forma transparente porque o ficheiro CLAUDE_INSTRUCTIONS.md do projeto continha regras que apontam para as palavras-chave do 'Second Brain'.*
5. Para utilizar esta integração no **Claude Desktop**, é necessário especificar expressamente o termo 'Second Brain' no seu prompt para forçar a gravação ou leitura nesta camada de memória persistente.
![Acionando o Second Brain no Claude Desktop ao mencionar explicitamente palavras-chave](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-second-brain-explicit-trigger.webp)
6. O mesmo se aplica ao **Gemini CLI**, onde terá de indicar 'Second Brain' para ativar as ferramentas MCP integradas.
![Janela de terminal do Gemini CLI demonstrando chamadas bem-sucedidas ao Second Brain MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/gemini-cli-second-brain-trigger.webp)
- *Adicionar regras semelhantes ao ficheiro GEMINI.md, seguindo o padrão do CLAUDE_INSTRUCTIONS.md, permitirá que o sistema use o Second Brain em segundo plano sem que tenha de escrever as palavras-chave.*

### Extensões para navegadores web

- Estão disponíveis extensões para os navegadores Chrome, Firefox e Microsoft Edge.
- As funcionalidades incluem:

  - **Capturar a página atual** — guarda automaticamente o título e o endereço URL no seu Second Brain.
  - **Capturar texto selecionado** — selecione qualquer excerto de texto numa página antes de clicar no botão da extensão; o excerto será gravado em associação com o título e a URL.
  - **Adicionar notas rápidas** — escreva observações rápidas ou categorize com `#hashtags` diretamente no popup da extensão antes de gravar; os hashtags são indexados automaticamente como tags.

### Sincronização de conhecimento pessoal com o plugin Obsidian

- Existe um plugin Obsidian para efetuar a sincronização das suas notas pessoais do Obsidian Vault diretamente com o Second Brain na Cloudflare.
- Pode usar tags específicas nas notas que deseja enviar para o armazenamento persistente.

#### Instalar o plugin Obsidian

1. Abra o Obsidian → Definições → Community Plugins
![Painel de configurações do Obsidian navegando para a seção Community Plugins](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-settings-community-plugins.webp)
2. Clique no botão 'Browse' para pesquisar plug-ins.
![Página de pesquisa de plug-ins do Obsidian mostrando o botão Browse](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-browse.webp)
3. Procure por 'Second Brain Sync'.
![Pesquisando pelo plug-in Second Brain Sync na loja de plug-ins do Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-search-second-brain.webp)
4. Clique no botão 'Install' (Instalar) e, em seguida, em 'Enable' (Ativar).
![Instalando e ativando o plug-in Second Brain Sync no Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-install-and-enable.webp)

#### Configurar o plugin Obsidian

1. Aceda a Obsidian → Definições → Second Brain Sync
2. Preencha os campos 'URL' e o 'Auth token' com os dados do seu Worker.
![Inserindo a URL do Worker e o Token de autorização nas configurações do Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-configuration-credentials.webp)
3. Clique em 'Test' para verificar se a ligação remota está operacional.
![Teste de conexão do plug-in do Obsidian exibindo verificação bem-sucedida](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-connection-test-success.webp)
4. Defina os comportamentos de sincronização. Configure a tag de sincronização desejada em 'Sync tag' e ative 'Auto-sync on save'.
![Configurando a Sync Tag e ativando a sincronização automática ao salvar no Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-sync-behavior-settings.webp)
5. Crie uma nota na sua pasta do Obsidian com a tag `second-brain` (conforme definido no ecrã de configurações).
![Criando uma nova nota no Obsidian com a tag second-brain para sincronização](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-note-with-sync-tag.webp)
6. A nota é gravada e sincronizada de imediato para a sua instância de Cloudflare.
![Verificando a nota do Obsidian sincronizada com sucesso na interface web do Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-synced-note-verification.webp)

## Conclusão

O Second Brain oferece uma solução de código aberto inteligente para um dos maiores limites das tecnologias de IA: o esquecimento de contexto e a ausência de memória. Ao combinar este projeto com a infraestrutura escalável da Cloudflare, obtém-se uma camada de memória sémântica auto-hospedada, globalmente distribuída e de latência reduzida. Com a integração do Model Context Protocol (MCP), esta base de conhecimento torna-se totalmente portátil entre diferentes agentes de IA.

A integração com o Obsidian amplia esta arquitetura ligando a sua tomada de notas tradicional ao raciocínio lógico da IA. As suas notas e rascunhos são convertidos em dados estruturados que os agentes conseguem interpretar e interrogar a qualquer momento.

Ao unificar auto-hospedagem, pesquisa sémântica vetorial e padrões de comunicação abertos como o MCP, o Second Brain demonstra ser muito mais do que um simples repositório: é a base estrutural para construir o seu próprio ecossistema de produtividade de IA pessoal.

## Referências:

- [https://www.thesecondbrain.dev/](https://www.thesecondbrain.dev/)
- [https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works](https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works)
- [Connect to AI Clients](https://github.com/rahilp/second-brain-cloudflare/wiki/Connect-to-AI-Clients)
- [Second Brain Obsidian Plugin](https://github.com/rahilp/second-brain-cloudflare/wiki/Obsidian-Plugin)
- [https://github.com/rahilp/second-brain-obsidian-plugin](https://github.com/rahilp/second-brain-obsidian-plugin)