OwlMem
Doku

Verbinde deine KI-Agenten

Verbinde Claude, ChatGPT, Cursor, Codex, VS Code und andere MCP-Clients mit OwlMem, dem gemeinsamen KI-Gedächtnis deines Teams.

Schnellstart

OwlMem gibt jedem KI-Agenten in deinem Team eine gemeinsame Wissensdatenbank und ein Gedächtnis, über MCP. Einen Agenten zu verbinden dauert etwa eine Minute.

  1. Leg deinen Space an. Melde dich unter owlmem.com/app mit deiner E-Mail-Adresse an. Dein erster Space ist kostenlos.
  2. Füge OwlMem zu deiner KI hinzu. Verwende diese Adresse überall dort, wo deine App nach einem Remote-MCP-Server oder benutzerdefinierten Connector fragt:
    https://mcp.owlmem.com/mcp
  3. Gib es frei. Deine App öffnet eine OwlMem-Seite. Wähle einen Namen für den Agenten und klicke auf Allow. Das war’s — keine Schlüssel zum Kopieren.

Erklär deinen Agenten dann, wie sie es nutzen sollen — siehe Agenten anleiten. Jede verbundene App erscheint in der Konsole unter AI agents & tokens → Connected apps, wo du sie jederzeit trennen kannst.

Claude (Web, Desktop und Mobil)

  1. Öffne Settings → Connectors und wähle Add custom connector.
  2. Nenne ihn OwlMem und füge die URL ein:
    https://mcp.owlmem.com/mcp
  3. Klicke auf Connect, melde dich bei OwlMem an und klicke auf Allow.

Connectors, die du im Web hinzufügst, funktionieren auch in Claude Desktop und den Mobil-Apps. In den Team- und Enterprise-Tarifen von Claude muss ein Admin den Connector eventuell zuerst für die Organisation hinzufügen.

Claude Code

Füge den Server hinzu (mit --scope user ist er in jedem Projekt verfügbar):

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

Starte dann Claude Code, tippe /mcp, wähle owlmem und dann Authenticate. Dein Browser öffnet die OwlMem-Freigabeseite.

Codex

Beim Hinzufügen des Servers startet die Anmeldung sofort:

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

Wenn der Schritt im Browser abgelaufen ist, führe codex mcp login owlmem aus. Oder trag ihn von Hand in ~/.codex/config.toml ein und melde dich dann an:

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

Codex fragt nach, bevor es MCP-Tools aufruft, sofern du sie nicht in seinen Genehmigungseinstellungen erlaubst.

ChatGPT

  1. Öffne Settings → Apps & Connectors. Schalte unter Advanced settings den Developer mode ein.
  2. Wähle Create, nenne ihn OwlMem, füge die URL ein und wähle OAuth als Authentifizierung:
    https://mcp.owlmem.com/mcp
  3. Melde dich bei OwlMem an und klicke auf Allow.

Ob benutzerdefinierte Connectors verfügbar sind, hängt von deinem ChatGPT-Tarif und den Workspace-Einstellungen ab.

Cursor

Füge Folgendes zu ~/.cursor/mcp.json hinzu (oder zu .cursor/mcp.json in einem Projekt):

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

Öffne Cursor Settings → MCP. OwlMem zeigt Needs login — klicke darauf und gib es im Browser frei.

VS Code (GitHub Copilot)

Führe MCP: Add Server aus der Befehlspalette aus, wähle HTTP und füge die URL ein, oder trag sie in .vscode/mcp.json ein:

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

VS Code fordert dich zur Anmeldung auf, wenn Copilot den Server zum ersten Mal nutzt.

Windsurf, Gemini CLI und andere

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

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

Gemini CLI — ~/.gemini/settings.json, danach /mcp auth owlmem ausführen:

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

Jeder andere Client, der Remote-MCP-Server mit OAuth unterstützt, funktioniert genauso: URL angeben und freigeben. OwlMem unterstützt die MCP-Autorisierungsspezifikation (OAuth 2.1 mit PKCE und dynamischer Client-Registrierung).

Stattdessen ein Token verwenden

Manche Tools beherrschen den Anmeldeablauf nicht — Skripte, CI-Jobs, ältere Clients. Erstelle für sie in der Konsole unter AI agents & tokens → Connect an AI ein Token und sende es als Bearer-Token:

Authorization: Bearer om_…

Beispiel für Claude Code:

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

Für einen Client, der nur lokale (stdio-)Server ausführt, überbrücke mit mcp-remote:

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

Tokens laufen nicht ab; widerrufe eines in der Konsole, wenn du es nicht mehr brauchst. Ein Agent ist du plus sein Name: Erstellst du ein neues Token für einen Namen, den du schon verwendest, ersetzt es das alte Token — das alte funktioniert sofort nicht mehr. Dasselbe gilt, wenn du eine App über die Anmeldung neu verbindest.

Ein Einladungstoken für die KI eines anderen

Damit der Agent eines Partners deine Organisation ohne eigenes Konto nutzen kann, erstellt das Hauptkonto unter AI agents & tokens ein Einladungstoken (omi_…). Der Partner fügt OwlMem in seiner App hinzu und fügt das Token auf der OwlMem-Anmeldeseite ein, statt sich anzumelden. Die erste KI, die es verwendet, wird daran gebunden; alle anderen, die es später versuchen, werden abgewiesen. Die Liste zeigt, ob ein Token gebunden ist, und widerrufst du eines, wird diese KI getrennt.

Tools für deine Agenten

Wissen ist für Seiten, die Menschen und Agenten immer wieder lesen (Anleitungen, Entscheidungen, Projektnotizen). Das Gedächtnis ist für einzelne Fakten, die ein Agent nach Bedeutung abrufen kann.

ToolArgumenteFunktion
kb_searchquery, limitDurchsucht die Wissensdatenbank (wörtlich, ohne Unterscheidung von Groß- und Kleinschreibung). Agenten sollten vor dem Schreiben suchen.
kb_readpathLiest ein Dokument.
kb_list—Listet alle Dokumente mit Beschreibung und letzter Änderung auf. Nützlich zum Umorganisieren.
kb_writepath, content, message, modeErstellt oder aktualisiert ein Dokument. Prüft auf Beinahe-Duplikate und bittet den Agenten, stattdessen die vorhandene Seite zu aktualisieren.
kb_movefrom, to, messageVerschiebt oder benennt ein Dokument um, zum Beispiel nach archive/.
kb_deletepath, messageLöscht ein veraltetes Dokument. Jede Änderung ist ein git-Commit, es lässt sich also wiederherstellen.
kb_recallquery, limitRuft zu einer Frage passende Fakten aus dem Gedächtnis ab, mit Datum und Ablauf.
kb_retaincontent, context, snapshot, valid_days, expiresSpeichert einen Fakt, eine Regel oder ein Ereignis. Veränderliche Werte (Preise, Versionen, Status) sollten snapshot oder ein Ablaufdatum setzen, damit sie automatisch abtreten.
kb_forgetid, reasonSetzt eine falsche oder veraltete Erinnerung außer Kraft. Sie lässt sich in der Konsole wiederherstellen.

Suchen und Abrufen sind in jedem Tarif unbegrenzt. Das Speichern von Erinnerungen zählt zu den monatlichen Gedächtnis-Schreibvorgängen deines Tarifs; das Schreiben von Dokumenten zählt zum Speicher.

Agenten anleiten

Agenten nutzen OwlMem viel besser mit ein paar Zeilen in ihren dauerhaften Anweisungen — CLAUDE.md, AGENTS.md, Cursor-Regeln oder die Anweisungen eines Claude-Projekts:

## 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.

Neue Spaces starten mit vier Ordnern — lessons/, projects/, reference/, archive/ —, jeder mit einer kurzen README. Agenten können weitere Ordner bis zu drei Ebenen tief anlegen.

Der Tresor und der owlmem-Befehl

Der Tresor bewahrt Zugangsdaten auf, die deine Agenten brauchen, Ende-zu-Ende-verschlüsselt: Einträge werden auf deinem Rechner mit einem Schlüssel verschlüsselt, den nur du hast, und OwlMem speichert Chiffretext, den es nicht lesen kann. Das Hauptkonto schaltet ihn in der Konsole unter Vault (Tresor) ein; danach können alle in der Organisation ihn nutzen. Bewahre den angezeigten Wiederherstellungscode auf — die Konsole bietet an, ihn dir aus deiner eigenen E-Mail-App selbst zu schicken, sodass er nie über OwlMem läuft.

Mit einem Passkey entsperren. Jeder Passkey, den du unter Your approval methods hinzufügst, wird zugleich zum Entsperren des Tresors eingerichtet, per Fingerabdruck oder Gesichtserkennung deines Geräts (die PRF-Funktion des Passkeys; Passkeys in Chrome, Edge, Safari, Google Password Manager und iCloud Keychain unterstützen sie). Danach sind Importieren, Exportieren und das Entsperren eines neuen Rechners nur ein Antippen — der Wiederherstellungscode ist nur für Notfälle.

Agenten nutzen ihn über den Befehl owlmem (Node 18 oder neuer):

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 legt Geheimnisse in die Umgebung des Befehls, sodass der Agent sie nie sieht. Damit ein Agent den Tresor direkt nutzen kann, füge den lokalen MCP-Server hinzu — die Entschlüsselung bleibt auf deinem Rechner:

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

Wenn du bei owlmem vault unlock Enter drückst, öffnet dein Browser eine Seite mit dem Agenten, dem Rechner und einem Code — prüfe, ob der Code mit deinem Terminal übereinstimmt, tippe auf deinen Passkey, und der Schlüssel wird nur an diesen Rechner gesendet, für ihn verschlüsselt.

Agenten brauchen eine Freigabe, um den Tresor zu nutzen (Passkey, Authenticator-App oder GitHub), jeweils für 15 Minuten bis 2 Stunden; jede Person gibt ihre eigenen Agenten frei, das Hauptkonto kann die Agenten aller freigeben. Löschen und Exportieren brauchen immer eine neue Freigabe. Importiere aus Bitwarden, 1Password, KeePass und .env-Dateien oder exportiere — in der Konsole mit einem Antippen deines Passkeys oder mit owlmem vault import / export.

Backups. Wann immer ein Eintrag geändert oder gelöscht wird, bleibt die vorherige Version 30 Tage erhalten. Das Hauptkonto kann sie auf der Tresorseite wiederherstellen; dabei wird auch eine Kopie dessen aufbewahrt, was ersetzt wurde.

Tarife und Preise

Die Tarife unterscheiden sich nur in der Zahl der KI-Agenten, die sich verbinden können, im Speicher, in den Gedächtnis-Schreibvorgängen pro Monat und in den Tresoreinträgen. Jeder Tarif hat jede Funktion und beliebig viele Personen. Preise in US-Dollar; bei jährlicher Abrechnung zahlst du zehn Monate und bekommst zwölf.

TarifMonatlichJährlichKI-AgentenSpeicherGedächtnis-Schreibvorgänge / MonatTresoreinträge
GratisGratis—1200 MB10020
Persönlich$19 / Monat$190 / Jahr51 GB1.000200
Familie$39 / Monat$390 / Jahr102 GB2.000500
Team$79 / Monat$790 / Jahr204 GB4.0002.000
Unternehmen$159 / Monat$1.590 / Jahr408 GB8.00010.000
  • KI-Agenten zählen als Person plus Agentenname — dein Claude und der Claude einer Teamkollegin sind zwei Agenten. Suchen und Lesen sind unbegrenzt.
  • Upgraden oder kündigen kannst du jederzeit unter Billing in der Konsole. Nach einer Kündigung bleibt der Tarif bis zum Ende des bezahlten Zeitraums bestehen.
  • Erstattungen. Volle Erstattung innerhalb von 14 Tagen nach deiner ersten Zahlung — schreib an [email protected]. Danach werden Zahlungen nicht erstattet. Siehe die Nutzungsbedingungen.

Organisationen, Limits und deine Daten

  • Organisationen. Dein Space ist eine Organisation mit einem Hauptkonto. Das Hauptkonto lädt Personen unter Organization per E-Mail ein; sie treten als Nutzer bei. Alle teilen Wissensdatenbank, Erinnerungen und Tresor. Jeder Nutzer verwaltet seine eigenen KI-Agenten und Tokens; das Hauptkonto verwaltet die aller, dazu Mitglieder, Abrechnung, Export und Löschung. Tarife begrenzen KI-Agenten, nicht Personen.
  • Getrennte Konten. Dieselbe E-Mail-Adresse in zwei Organisationen ergibt zwei getrennte Konten. Nach der Anmeldung wählst du, welche Organisation du betrittst; wechseln kannst du über die Seitenleiste.
  • Limits. Jeder Tarif legt die Zahl der KI-Agenten, den Speicher und die monatlichen Gedächtnis-Schreibvorgänge fest — siehe Preise. Ist ein Limit erreicht, werden Schreibvorgänge mit einer klaren Meldung abgelehnt; Lesen funktioniert weiter.
  • Dein GitHub. Synchronisiere die Wissensdatenbank unter Knowledge → Sync to your GitHub mit einem Repository, das dir gehört. Nur Markdown-Dateien werden synchronisiert.
  • Exportieren und löschen. Das Hauptkonto kann unter Organization alles herunterladen oder die Organisation löschen.
  • Datenschutz. Deine Daten liegen auf Servern in Kanada. Wir trainieren keine Modelle mit deinen Daten und zeigen keine Werbung. Details in der Datenschutzerklärung.

Fehlerbehebung

“The space has reached its AI agent limit”
Jeder Agent (eine Person plus ein Name) belegt einen Platz. Verwende auf der Freigabeseite einen deiner vorhandenen Agentennamen erneut, deaktiviere in der Konsole einen Agenten, den du nicht mehr nutzt, oder upgrade.
Die App sagt, sie müsse sich neu anmelden
Der Zugriff wird automatisch erneuert. Wenn du die App in der Konsole getrennt hast oder sie 60 Tage nicht genutzt wurde, verbinde sie erneut.
Die Anmelde-E-Mail kommt nicht an
Sieh im Spam-Ordner nach Mails von [email protected]. Links funktionieren einmal und laufen nach 15 Minuten ab; öffne sie im selben Browser wie die Freigabeseite.
owlmem vault unlock fragt nur nach einem Wiederherstellungscode
Das ist eine alte Version. Führe npx -y owlmem@latest vault unlock aus (oder aktualisiere mit npm install -g owlmem) und drück bei der Eingabeaufforderung Enter.
“This passkey can't unlock the vault” (Dieser Passkey kann den Tresor nicht entsperren)
Sein Gerät unterstützt die PRF-Funktion nicht. Für Agenten-Freigaben funktioniert er weiterhin. Füge einen weiteren Passkey hinzu, der in Google Password Manager, iCloud Keychain oder Windows Hello gespeichert ist.
“401 Unauthorized” mit einem Token
Das Token wurde widerrufen oder falsch eingegeben. Tokens beginnen mit om_ und werden als Authorization: Bearer om_… gesendet.

Kommst du immer noch nicht weiter? Schreib an [email protected].