---
title: "Bâtir un système de mémoire IA persistant sur Cloudflare"
description: "Découvrez comment créer une mémoire IA persistante et auto-hébergée sur Cloudflare avec Second Brain et MCP. Partagez votre contexte entre Claude et Obsidian."
canonical_url: "https://techvoyage.dev/fr/article/use-cloudflare-as-ai-memory"
last_updated: "2026-10-20T09:53:46.816Z"
---

## L'importance d'une mémoire IA persistante pour les agents

À mesure que les assistants IA s'intègrent dans notre quotidien, nous sommes fréquemment confrontés au problème du contexte vide (blank context). Les décisions prises la semaine précédente sont oubliées, nous obligeant à ressaisir continuellement les détails de notre stack technologique et à redéfinir nos préférences utilisateur.

Plutôt que de repartir de zéro à chaque session, nous devons mettre en place un système de mémoire évolutif qui assimile continuellement les choix de l'utilisateur et élimine le besoin de répéter sans cesse le contexte.

## Mémoire IA auto-hébergée vs. Systèmes de mémoire intégrés

De nombreux agents IA intègrent désormais leur propre mémoire, mais nous n'utilisons rarement qu'un seul outil pour toutes nos tâches. Nous sollicitons Claude pour l'architecture et la conception d'un projet, Kimi pour le code, et ChatGPT pour la recherche de fond. Le contexte n'est pas partagé entre ces différents outils ; il reste cloisonné au sein de chaque agent.

Du point de vue de l'ingénierie logicielle, nous évitons les boîtes noires. Nous exigeons un système de mémoire IA observable, auditable et totalement sous notre contrôle. Le projet open source [Second Brain](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare/tree/main) (un fork de [https://github.com/rahilp/second-brain-cloudflare](https://github.com/rahilp/second-brain-cloudflare)) offre une solution de mémoire persistante et auto-hébergée compatible avec le protocole MCP (Model Context Protocol). N'importe quel agent IA compatible (comme Claude, ChatGPT ou Kimi Code) peut ainsi exploiter et alimenter ce contexte unique y compris en local.

## Comment bâtir un Second Brain de mémoire IA sur Cloudflare

Le système de mémoire de Second Brain est déployé sur **Cloudflare Workers**, offrant une infrastructure d'exécution serverless hautement distribuée à l'échelle mondiale. Cela garantit que la recherche de souvenirs (recall) et les autres opérations s'exécutent avec une latence minimale, totalement invisible dans la boucle de réflexion de l'IA.

La génération d'embeddings vectoriels repose sur le modèle dédié de **Workers AI**. Ces embeddings sont ensuite stockés dans **Cloudflare Vectorize**, une base de datos vectorielle globale performante. **Cloudflare Vectorize** effectue une recherche de similarité cosinus (cosine similarity) pour identifier les souvenirs sémantiquement proches de la requête.

Second Brain intègre également des mécanismes de déduplication et de fusion intelligente. Tout contenu présentant une similarité inférieure à 85 % est enregistré ; au-delà, il est ignoré ou marqué comme doublon potentiel. Les textes de plus de 1 600 caractères sont découpés proprement selon les phrases ou les sauts de ligne, avec un chevauchement (overlap) de 200 caractères pour éviter toute perte de contexte. Chaque segment est ensuite vectorisé pour garantir des correspondances ultra-précises.

Les outils suivants sont exposés sous forme d'interfaces MCP exploitables par vos agents IA :

- `remember` : stocker des idées, des décisions, des préférences ou du contexte projet.
- `append` : ajouter des précisions à un souvenir existant.
- `update` : remplacer intégralement un souvenir.
- `recall` : rechercher des souvenirs par leur sens sémantique plutôt que par des mots-clés exacts.
- `list_recent` : lister les derniers souvenirs enregistrés.
- `forget` : supprimer définitivement un souvenir.
- `link/connections` : lier des souvenirs associés entre eux (fonctionnalité de graphe v2).

### Configuration de Second Brain sur Cloudflare

1. Cliquez sur `Deploy to Cloudflare` depuis la page du [Github repo](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare). [[![Page GitHub avec le bouton Deploy to Cloudflare mis en évidence](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/deploy-to-cloudflare-button.webp)]]
2. Remplissez le formulaire de création du Cloudflare Worker.
![Formulaire de configuration du déploiement de Cloudflare Workers](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-deployment-form.webp)
3. Saisissez '384' pour Dimensions, sélectionnez 'cosine' pour Metric, puis cliquez sur le bouton Deploy.
![Écran de configuration de la création de base de données Cloudflare Vectorize](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-vectorize-configuration.webp)
4. Voici un aperçu de l'interface d'administration de Second Brain déployé sur Cloudflare Worker.
![Tableau de bord général du worker Second Brain déployé](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-second-brain-overview.webp)
5. Accédez à l'onglet 'Settings', puis cliquez sur l'icône d'édition de la variable 'AUTH_TOKEN' afin de définir votre jeton de sécurité.
![Paramètres des variables de Cloudflare Worker mettant en évidence AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-settings.webp)
6. Cliquez sur le lien 'Rotate' pour pouvoir saisir une nouvelle valeur. ![Écran de modification et de rotation de la variable AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-rotate.webp)![Saisie de la chaîne aléatoire générée dans le champ de valeur AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-value-input.webp)
7. Lancez la commande `openssl rand -base64 32` dans votre terminal macOS pour générer une clé d'accès aléatoire et collez-la dans le champ de saisie 'Value'.
8. Cliquez sur le bouton 'Deploy' pour appliquer et enregistrer la nouvelle valeur de 'AUTH_TOKEN'.
9. Ouvrez l'URL de votre worker Second Brain dans votre navigateur web.
![Écran de connexion de l'interface web de Second Brain avec champ de saisie Bearer Token](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-login.webp)
10. Saisissez le jeton 'AUTH_TOKEN' créé dans le champ `Bearer token` puis cliquez sur le bouton 'Connect' pour accéder à l'interface web (Web UI).

### Intégration de Claude Desktop via MCP

1. Cliquez sur 'Customize' dans Claude Desktop.
![Interface de Claude Desktop pointant vers le bouton Customize](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-customize-button.webp)
2. Cliquez sur 'Developer' pour éditer manuellement le fichier de configuration des serveurs MCP.
![Menu des paramètres développeur de Claude Desktop pour accéder à la configuration MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-developer-menu.webp)
3. Ajoutez la configuration suivante à la section `mcpServers` de votre fichier `claude_desktop_config.json` :

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

![JSON de configuration de Claude Desktop MCP contenant le serveur Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-config-json.webp)
4. Redémarrez Claude Desktop et vérifiez la liste des 'Local MCP servers'. Le statut doit indiquer 'running'.
![Claude Desktop affichant le statut actif pour le serveur Second Brain MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-status-running.webp)

### Intégration de Claude Code via MCP

- Exécutez la commande suivante pour ajouter le serveur MCP :

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

- Claude Code détectera automatiquement que le point de terminaison (endpoint) requiert une authentification OAuth et ouvrira une page de connexion dans votre navigateur pour valider votre `AUTH_TOKEN`.
- Créez un fichier `CLAUDE.md` dans le répertoire `~/.claude` et ajoutez-y les instructions détaillées issues de [CLAUDE_INSTRUCTIONS.md](https://github.com/rahilp/second-brain-cloudflare/blob/main/AI_Instructions/CLAUDE_INSTRUCTIONS.md).

### Intégration de Gemini CLI via MCP

1. Ajoutez la configuration de serveur MCP suivante à votre fichier './.gemini/settings.json' :

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

1. Démarrez l'interface Gemini CLI.

### Tester Second Brain avec les agents IA

1. En commençant par configurer une simple palette de marque dans **Claude Desktop**, Second Brain n'est pas sollicité par défaut.
![Premier test dans Claude Desktop sans la couche de mémoire Second Brain active](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-first-run-brand-palette.webp)
2. En utilisant le mot-clé générique 'remember', seuls les outils locaux `memory_user-edits` de **Claude Desktop** s'exécutent, ignorant la couche distante de Second Brain.
![Claude Desktop basculant vers les modifications locales intégrées au lieu de Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-remember-built-in-tool-fallback.webp)
3. En soumettant l'instruction suivante à **Claude Code**, le serveur Second Brain est immédiatement appelé :

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

![Fenêtre de terminal de Claude Code affichant le déclenchement réussi de Second Brain MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-code-second-brain-mcp-called.webp)
4. Nous pouvons instantanément vérifier l'enregistrement des codes couleurs au sein de la base **Second Brain sur Cloudflare** :
![Vérification des codes couleur de marque enregistrés dans la base de données de Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-color-verification.webp)
- *Si Claude Code a réagi correctement, c'est parce que son fichier de directives CLAUDE_INSTRUCTIONS.md contient explicitement les termes liés à 'Second Brain'.*
5. Pour obtenir le même résultat dans **Claude Desktop**, vous devez mentionner explicitement 'Second Brain' dans vos prompts pour forcer l'écriture ou la lecture de cette couche mémoire.
![Déclenchement de Second Brain dans Claude Desktop en mentionnant explicitement les mots-clés](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-second-brain-explicit-trigger.webp)
6. De la même manière, le mot-clé 'Second Brain' doit être mentionné dans vos échanges avec le **Gemini CLI** pour déclencher l'appel MCP associé.
![Fenêtre de terminal de Gemini CLI montrant des appels réussis vers Second Brain MCP](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/gemini-cli-second-brain-trigger.webp)
- *L'ajout de directives adaptées dans votre fichier GEMINI.md (similaires à celles de CLAUDE_INSTRUCTIONS.md) permettra de solliciter Second Brain de manière totalement transparente.*

### Extensions pour navigateurs web

- Des extensions officielles sont disponibles pour Google Chrome, Mozilla Firefox et Microsoft Edge.
- Elles permettent de :

  - **Capturer la page actuelle** — sauvegarde le titre et l'adresse URL directement dans votre Second Brain.
  - **Capturer un extrait de texte** — sélectionnez n'importe quelle ligne de texte sur une page avant de cliquer sur l'extension pour l'enregistrer avec les métadonnées de la page.
  - **Ajouter une note libre** — saisissez du contexte ou des `#hashtags` directement depuis la popup de l'extension ; les tags sont automatiquement extraits et catégorisés.

### Synchroniser ses connaissances personnelles avec le plugin Obsidian

- Un plugin Obsidian dédié permet de synchroniser de manière bidirectionnelle les notes de votre coffre (Vault) local vers votre Second Brain hébergé sur Cloudflare.
- Vous pouvez choisir de ne synchroniser que les notes associées à un tag spécifique.

#### Installer le plugin Obsidian

1. Ouvrez Obsidian → Settings → Community Plugins
![Panneau de configuration d'Obsidian naviguant vers la section Community Plugins](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-settings-community-plugins.webp)
2. Cliquez sur le bouton 'Browse'.
![Page de recherche des plugins d'Obsidian affichant le bouton Browse](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-browse.webp)
3. Recherchez 'Second Brain Sync'.
![Recherche du plugin Second Brain Sync dans la bibliothèque d'extensions d'Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-search-second-brain.webp)
4. Cliquez sur 'Install' puis sur 'Enable'.
![Installation et activation du plugin Second Brain Sync dans Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-install-and-enable.webp)

#### Configurer le plugin Obsidian

1. Ouvrez Obsidian → Settings → Second Brain Sync
2. Renseignez l'adresse de votre Worker ('URL') et votre jeton de sécurité ('Auth token').
![Saisie de l'URL du Worker et du jeton d'autorisation dans les paramètres d'Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-configuration-credentials.webp)
3. Cliquez sur le bouton 'Test' pour valider la bonne communication avec votre serveur.
![Test de connexion réussi du plugin Obsidian vers la base de données](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-connection-test-success.webp)
4. Ajustez les préférences de synchronisation. Définissez le tag de déclenchement ('Sync tag') et cochez 'Auto-sync on save'.
![Configuration du Sync Tag et activation de l'auto-synchronisation à l'enregistrement dans Obsidian](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-sync-behavior-settings.webp)
5. Créez une nouvelle note dans Obsidian et associez-y le tag configuré (par exemple `second-brain`).
![Création d'une nouvelle note dans Obsidian tagguée avec second-brain pour la synchronisation](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-note-with-sync-tag.webp)
6. Dès l'enregistrement, la note est instantanément synchronisée avec votre instance Cloudflare.
![Vérification de la note Obsidian synchronisée avec succès dans l'interface web de Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-synced-note-verification.webp)

## Conclusion

Second Brain offre une réponse open source élégante à l'une de nos plus grandes frustrations avec les IA : l'absence de mémoire à long terme. En s'appuyant sur l'infrastructure robuste de Cloudflare, il déploie une couche de mémoire sémantique auto-hébergée, globale et à très faible latence. Grâce aux interfaces MCP, cette base de connaissances devient nativement transportable entre tous vos assistants virtuels.

L'intégration d'Obsidian pousse l'expérience encore plus loin en jetant un pont entre la prise de notes structurée et l'exécution d'agents. Vos notes personnelles se métamorphosent ainsi en un contexte exploitable par l'IA à la demande.

En fusionnant auto-hébergement, recherche vectorielle sémantique et protocoles ouverts (MCP), Second Brain jette les bases concrètes de ce que doit être un véritable écosystème d'agents IA au service de l'utilisateur.

## Références :

- [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)