Connectez vos agents IA

Démarrage rapide

OwlMem offre à chaque agent IA de votre équipe une base de connaissances et une mémoire partagées, via MCP. Connecter un agent prend environ une minute.

1. Créez votre espace. Connectez-vous sur owlmem.com/app avec votre adresse e-mail. Votre premier espace est gratuit.
2. Ajoutez OwlMem à votre IA. Utilisez cette adresse partout où votre application demande un serveur MCP distant ou un connecteur personnalisé :
   Copier

   https://mcp.owlmem.com/mcp

3. Approuvez-le. Votre application ouvre une page OwlMem. Choisissez un nom pour l’agent et cliquez sur Allow. C’est tout — aucune clé à copier.

Expliquez ensuite à vos agents comment s’en servir — voir Former vos agents. Chaque application connectée apparaît dans la console sous AI agents & tokens → Connected apps, où vous pouvez la déconnecter à tout moment.

Claude (web, bureau et mobile)

1. Ouvrez Settings → Connectors et choisissez Add custom connector.
2. Nommez-le OwlMem et collez l’URL :
   Copier

   https://mcp.owlmem.com/mcp

3. Cliquez sur Connect, connectez-vous à OwlMem et cliquez sur Allow.

Les connecteurs ajoutés sur le web fonctionnent aussi dans Claude Desktop et les applications mobiles. Avec les offres Team et Enterprise de Claude, un administrateur devra peut-être d’abord ajouter le connecteur pour l’organisation.

Claude Code

Ajoutez le serveur (utilisez --scope user pour le rendre disponible dans tous vos projets) :

claude mcp add --transport http --scope user owlmem https://mcp.owlmem.com/mcp

Lancez ensuite Claude Code, tapez /mcp, sélectionnez owlmem et choisissez Authenticate. Votre navigateur ouvre la page d’approbation OwlMem.

Codex

L’ajout du serveur lance immédiatement la connexion :

codex mcp add owlmem --url https://mcp.owlmem.com/mcp

Si l’étape dans le navigateur a expiré, exécutez codex mcp login owlmem. Vous pouvez aussi l’ajouter à la main dans ~/.codex/config.toml, puis vous connecter :

[mcp_servers.owlmem]
url = "https://mcp.owlmem.com/mcp"

Codex demande confirmation avant d’appeler des outils MCP, sauf si vous les autorisez dans ses paramètres d’approbation.

ChatGPT

1. Ouvrez Settings → Apps & Connectors. Sous Advanced settings, activez Developer mode.
2. Choisissez Create, nommez-le OwlMem, collez l’URL et choisissez OAuth comme méthode d’authentification :
   Copier

   https://mcp.owlmem.com/mcp

3. Connectez-vous à OwlMem et cliquez sur Allow.

La disponibilité des connecteurs personnalisés dépend de votre abonnement ChatGPT et des paramètres de votre espace de travail.

Cursor

Ajoutez ceci à ~/.cursor/mcp.json (ou à .cursor/mcp.json dans un projet) :

{
  "mcpServers": {
    "owlmem": { "url": "https://mcp.owlmem.com/mcp" }
  }
}

Ouvrez Cursor Settings → MCP. OwlMem affiche Needs login — cliquez dessus et approuvez dans le navigateur.

VS Code (GitHub Copilot)

Lancez MCP: Add Server depuis la palette de commandes, choisissez HTTP et collez l’URL, ou ajoutez-le à .vscode/mcp.json :

{
  "servers": {
    "owlmem": { "type": "http", "url": "https://mcp.owlmem.com/mcp" }
  }
}

VS Code vous demande de vous connecter la première fois que Copilot utilise le serveur.

Windsurf, Gemini CLI et autres

Windsurf — ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "owlmem": { "serverUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Gemini CLI — ~/.gemini/settings.json, puis exécutez /mcp auth owlmem :

{
  "mcpServers": {
    "owlmem": { "httpUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Tout autre client qui prend en charge les serveurs MCP distants avec OAuth fonctionne de la même manière : donnez-lui l’URL et approuvez. OwlMem implémente la spécification d’autorisation MCP (OAuth 2.1 avec PKCE et enregistrement dynamique des clients).

Utiliser un jeton à la place

Certains outils ne savent pas gérer la connexion — scripts, tâches CI, clients plus anciens. Pour ceux-là, créez un jeton dans la console sous AI agents & tokens → Connect an AI et envoyez-le comme jeton bearer :

Authorization: Bearer om_…

Exemple avec Claude Code :

claude mcp add --transport http owlmem https://mcp.owlmem.com/mcp --header "Authorization: Bearer $OWLMEM_TOKEN"

Pour un client qui n’exécute que des serveurs locaux (stdio), faites le pont avec mcp-remote :

{
  "mcpServers": {
    "owlmem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.owlmem.com/mcp", "--header", "Authorization: Bearer ${OWLMEM_TOKEN}"],
      "env": { "OWLMEM_TOKEN": "om_…" }
    }
  }
}

Les jetons n’expirent pas ; révoquez-en un dans la console quand vous n’en avez plus besoin. Un agent, c’est vous plus son nom : créer un nouveau jeton pour un nom que vous utilisez déjà remplace l’ancien jeton, qui cesse aussitôt de fonctionner. Il en va de même lorsque vous reconnectez une application via la connexion.

Un jeton d’invitation pour l’IA de quelqu’un d’autre

Pour permettre à l’agent d’un partenaire d’utiliser votre organisation sans compte, le compte principal crée un jeton d’invitation (omi_…) sous AI agents & tokens. Le partenaire ajoute OwlMem dans son application et colle le jeton sur la page de connexion OwlMem au lieu de se connecter. La première IA qui l’utilise y est liée ; toute autre qui l’essaie ensuite est refusée. La liste indique si chaque jeton est lié, et en révoquer un déconnecte l’IA correspondante.

Les outils de vos agents

Les connaissances servent aux pages que personnes et agents relisent (guides pratiques, décisions, notes de projet). La mémoire sert aux faits isolés qu’un agent peut rappeler par leur sens.

La recherche et le rappel sont illimités dans toutes les formules. Enregistrer des souvenirs compte dans les écritures de souvenirs mensuelles de votre formule ; écrire des documents compte dans le stockage.

Former vos agents

Les agents utilisent bien mieux OwlMem avec quelques lignes dans leurs instructions permanentes — CLAUDE.md, AGENTS.md, règles Cursor ou instructions d’un projet Claude :

## Team memory (OwlMem)
- Before starting a task, use kb_search (documents) and kb_recall (facts) for the topic.
- When you learn something reusable — a fix, a gotcha, a decision — save it with kb_write
  under lessons/ or projects/<name>/. Search first and update the existing page instead of
  creating a duplicate.
- Store facts that change (prices, versions, status) with kb_retain and snapshot=true or an
  expiry, so they retire on their own.
- Never put passwords or API keys in documents or memory. Use the OwlMem vault.

Les nouveaux espaces démarrent avec quatre dossiers — lessons/, projects/, reference/, archive/ — chacun avec un court README. Les agents peuvent créer d’autres dossiers, jusqu’à trois niveaux de profondeur.

Le coffre-fort et la commande owlmem

Le coffre-fort conserve les identifiants dont vos agents ont besoin, chiffrés de bout en bout : les éléments sont chiffrés sur votre machine avec une clé que vous seul détenez, et OwlMem stocke un texte chiffré qu’il ne peut pas lire. Le compte principal l’active dans la console sous Vault (coffre-fort) ; tous les membres de l’organisation peuvent ensuite l’utiliser. Conservez le code de récupération qui s’affiche — la console propose de vous l’envoyer par e-mail depuis votre propre messagerie, pour qu’il ne transite jamais par OwlMem.

Déverrouiller avec une Passkey. Chaque Passkey que vous ajoutez sous Your approval methods est aussi configurée pour déverrouiller le coffre-fort, grâce à l’empreinte digitale ou à la reconnaissance faciale de votre appareil (la fonction PRF des Passkeys ; les Passkeys de Chrome, Edge, Safari, Google Password Manager et du trousseau iCloud la prennent en charge). Dès lors, importer, exporter ou déverrouiller une nouvelle machine se fait d’une seule touche — le code de récupération ne sert qu’en cas d’urgence.

Les agents l’utilisent via la commande owlmem (Node 18 ou plus récent) :

npm install -g owlmem
owlmem login            # paste a token for this agent
owlmem vault unlock     # press Enter to approve in your browser with a passkey (or paste the recovery code)
owlmem run --env DB_PASSWORD=prod/db:password -- ./deploy.sh

owlmem run place les secrets dans l’environnement de la commande, si bien que l’agent ne les voit jamais. Pour qu’un agent utilise directement le coffre-fort, ajoutez le serveur MCP local — le déchiffrement reste sur votre machine :

claude mcp add owlmem-vault -- npx -y owlmem mcp

Quand vous appuyez sur Entrée à l’invite owlmem vault unlock, votre navigateur ouvre une page indiquant l’agent, la machine et un code — vérifiez que le code correspond à celui de votre terminal, validez avec votre Passkey, et la clé est envoyée à cette machine uniquement, chiffrée pour elle.

Les agents ont besoin d’une approbation pour utiliser le coffre-fort (Passkey, application d’authentification ou GitHub), valable de 15 minutes à 2 heures à la fois ; chacun approuve ses propres agents, le compte principal peut approuver ceux de tout le monde. La suppression et l’exportation exigent toujours une nouvelle approbation. Importez depuis Bitwarden, 1Password, KeePass et des fichiers .env, ou exportez, depuis la console d’une simple touche de votre Passkey ou avec owlmem vault import / export.

Sauvegardes. Chaque fois qu’un élément est modifié ou supprimé, la version précédente est conservée pendant 30 jours. Le compte principal peut la restaurer depuis la page du coffre-fort ; la restauration conserve aussi une copie de ce qu’elle remplace.

Formules et tarifs

Les formules ne diffèrent que par le nombre d’agents IA pouvant se connecter, le stockage, les écritures de souvenirs par mois et les éléments du coffre-fort. Chaque formule inclut toutes les fonctionnalités, et autant de personnes que vous le souhaitez. Les prix sont en dollars américains ; la facturation annuelle correspond au prix de dix mois pour douze.

• Les agents IA se comptent comme une personne plus un nom d’agent — votre Claude et le Claude d’un collègue sont deux agents. La recherche et la lecture sont illimitées.
• Changez de formule ou résiliez à tout moment sous Billing dans la console. En cas de résiliation, la formule reste active jusqu’à la fin de la période payée.
• Remboursements. Remboursement intégral dans les 14 jours suivant votre premier paiement — écrivez à [email protected]. Passé ce délai, les paiements ne sont pas remboursés. Voir les conditions.

Organisations, limites et vos données

• Organisations. Votre espace est une organisation dotée d’un compte principal. Le compte principal invite des personnes par e-mail sous Organization ; elles rejoignent l’organisation en tant qu’utilisateurs. Tout le monde partage la base de connaissances, les souvenirs et le coffre-fort. Chaque utilisateur gère ses propres agents IA et jetons ; le compte principal gère ceux de tout le monde, ainsi que les membres, la facturation, l’exportation et la suppression. Les formules limitent les agents IA, pas les personnes.
• Comptes distincts. Une même adresse e-mail dans deux organisations correspond à deux comptes distincts. Après la connexion, vous choisissez dans quelle organisation entrer ; vous pouvez en changer depuis la barre latérale.
• Limites. Chaque formule fixe le nombre d’agents IA, le stockage et les écritures de souvenirs mensuelles — voir les tarifs. Lorsqu’une limite est atteinte, les écritures sont refusées avec un message clair ; la lecture continue de fonctionner.
• Votre GitHub. Synchronisez la base de connaissances avec un dépôt qui vous appartient sous Knowledge → Sync to your GitHub. Seuls les fichiers Markdown sont synchronisés.
• Exportation et suppression. Le compte principal peut tout télécharger ou supprimer l’organisation sous Organization.
• Confidentialité. Vos données sont stockées sur des serveurs au Canada. Nous n’entraînons pas de modèles sur vos données et n’affichons pas de publicité. Détails dans la politique de confidentialité.

Dépannage

« The space has reached its AI agent limit »

Chaque agent (une personne plus un nom) occupe une place. Sur la page d’approbation, réutilisez l’un de vos noms d’agent, désactivez dans la console un agent que vous n’utilisez plus, ou passez à une formule supérieure.

L’application indique qu’elle doit se reconnecter

L’accès est renouvelé automatiquement. Si vous avez déconnecté l’application dans la console, ou si elle n’a pas été utilisée depuis 60 jours, connectez-la à nouveau.

L’e-mail de connexion n’arrive pas

Vérifiez vos spams à la recherche d’un message de [email protected]. Les liens ne fonctionnent qu’une fois et expirent après 15 minutes ; ouvrez-les dans le même navigateur que la page d’approbation.

owlmem vault unlock ne demande qu’un code de récupération

Il s’agit d’une ancienne version. Exécutez npx -y owlmem@latest vault unlock (ou mettez à jour avec npm install -g owlmem) et appuyez sur Entrée à l’invite.

« This passkey can't unlock the vault » (cette Passkey ne peut pas déverrouiller le coffre-fort)

Son appareil ne prend pas en charge la fonction PRF. Elle permet toujours d’approuver des agents. Ajoutez une autre Passkey enregistrée dans Google Password Manager, le trousseau iCloud ou Windows Hello.

« 401 Unauthorized » avec un jeton

Le jeton a été révoqué ou mal saisi. Les jetons commencent par om_ et sont envoyés sous la forme Authorization: Bearer om_….

Toujours bloqué ? Écrivez à [email protected].