Verbind je AI-agents

Snel aan de slag

OwlMem geeft elke AI-agent in je team één gedeelde kennisbank en één gedeeld geheugen, via MCP. Een agent verbinden duurt ongeveer een minuut.

1. Maak je werkruimte aan. Log in op owlmem.com/app met je e-mailadres. Je eerste werkruimte is gratis.
2. Voeg OwlMem toe aan je AI. Gebruik dit adres overal waar je app om een externe MCP-server of custom connector vraagt:
   Kopiëren

   https://mcp.owlmem.com/mcp

3. Keur het goed. Je app opent een pagina van OwlMem. Kies een naam voor de agent en klik op Allow. Dat is alles — geen sleutels om te kopiëren.

Vertel je agents daarna hoe ze het moeten gebruiken — zie Je agents instrueren. Elke verbonden app verschijnt in de console onder AI agents & tokens → Connected apps, waar je hem op elk moment kunt loskoppelen.

Claude (web, desktop en mobiel)

1. Open Settings → Connectors en kies Add custom connector.
2. Noem hem OwlMem en plak de URL:
   Kopiëren

   https://mcp.owlmem.com/mcp

3. Klik op Connect, log in bij OwlMem en klik op Allow.

Connectors die je op het web toevoegt, werken ook in Claude Desktop en de mobiele apps. Bij de Team- en Enterprise-abonnementen van Claude moet een beheerder de connector mogelijk eerst voor de organisatie toevoegen.

Claude Code

Voeg de server toe (gebruik --scope user om hem in elk project beschikbaar te maken):

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

Start daarna Claude Code, typ /mcp, selecteer owlmem en kies Authenticate. Je browser opent de goedkeuringspagina van OwlMem.

Codex

Zodra je de server toevoegt, begint het inloggen:

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

Is de browserstap verlopen, voer dan codex mcp login owlmem uit. Of voeg hem met de hand toe aan ~/.codex/config.toml en log daarna in:

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

Codex vraagt om toestemming voordat het MCP-tools aanroept, tenzij je ze toestaat in de goedkeuringsinstellingen.

ChatGPT

1. Open Settings → Apps & Connectors. Zet onder Advanced settings de Developer mode aan.
2. Kies Create, noem hem OwlMem, plak de URL en kies OAuth als authenticatie:
   Kopiëren

   https://mcp.owlmem.com/mcp

3. Log in bij OwlMem en klik op Allow.

Of custom connectors beschikbaar zijn, hangt af van je ChatGPT-abonnement en je workspace-instellingen.

Cursor

Voeg dit toe aan ~/.cursor/mcp.json (of aan .cursor/mcp.json in een project):

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

Open Cursor Settings → MCP. OwlMem toont Needs login — klik erop en keur goed in de browser.

VS Code (GitHub Copilot)

Voer MCP: Add Server uit vanuit het opdrachtenpalet, kies HTTP en plak de URL, of voeg hem toe aan .vscode/mcp.json:

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

VS Code vraagt je om in te loggen de eerste keer dat Copilot de server gebruikt.

Windsurf, Gemini CLI en andere

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

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

Gemini CLI — ~/.gemini/settings.json, voer daarna /mcp auth owlmem uit:

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

Elke andere client die externe MCP-servers met OAuth ondersteunt, werkt op dezelfde manier: geef hem de URL en keur goed. OwlMem ondersteunt de MCP-autorisatiespecificatie (OAuth 2.1 met PKCE en dynamische clientregistratie).

Een token gebruiken

Sommige tools kunnen de inlogstap niet doorlopen — scripts, CI-jobs, oudere clients. Maak daarvoor in de console een token aan onder AI agents & tokens → Connect an AI en stuur het mee als bearer-token:

Authorization: Bearer om_…

Voorbeeld voor Claude Code:

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

Voor een client die alleen lokale (stdio) servers draait, sla je een brug met 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 verlopen niet; trek een token in via de console als je het niet meer nodig hebt. Een agent is jij plus zijn naam, dus als je een nieuw token aanmaakt voor een naam die je al gebruikt, vervangt dat het oude token — het oude werkt dan meteen niet meer. Hetzelfde geldt als je een app opnieuw verbindt via inloggen.

Een uitnodigingstoken voor de AI van iemand anders

Wil je de agent van een partner je organisatie laten gebruiken zonder account, dan maakt het hoofdaccount een uitnodigingstoken (omi_…) aan onder AI agents & tokens. De partner voegt OwlMem toe in zijn app en plakt het token op de inlogpagina van OwlMem, in plaats van in te loggen. De eerste AI die het gebruikt, wordt eraan gekoppeld; ieder ander die het later probeert, wordt geweigerd. De lijst toont of elk token gekoppeld is, en als je een token intrekt, wordt die AI losgekoppeld.

Tools die je agents krijgen

Kennis is voor pagina's die mensen en agents opnieuw lezen (handleidingen, beslissingen, projectnotities). Geheugen is voor losse feiten die een agent op betekenis kan ophalen.

Zoeken en ophalen zijn onbeperkt in elk abonnement. Herinneringen opslaan telt mee voor de maandelijkse geheugenschrijfacties van je abonnement; documenten schrijven telt mee voor de opslag.

Je agents instrueren

Agents gebruiken OwlMem veel beter met een paar regels in hun vaste instructies — CLAUDE.md, AGENTS.md, Cursor-regels of de instructies van een Claude-project:

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

Nieuwe werkruimtes beginnen met vier mappen — lessons/, projects/, reference/, archive/ — elk met een korte README. Agents mogen andere mappen aanmaken, tot drie niveaus diep.

De kluis en het owlmem-commando

De kluis bewaart inloggegevens die je agents nodig hebben, end-to-end versleuteld: items worden op je machine versleuteld met een sleutel die alleen jij hebt, en OwlMem bewaart versleutelde gegevens die het niet kan lezen. Het hoofdaccount zet de kluis aan in de console onder Vault (kluis); daarna kan iedereen in de organisatie hem gebruiken. Bewaar de herstelcode die je dan te zien krijgt — de console biedt aan om hem naar jezelf te mailen vanuit je eigen mailapp, zodat hij nooit via OwlMem gaat.

Ontgrendelen met een Passkey. Elke Passkey die je toevoegt onder Your approval methods, wordt ook ingesteld om de kluis te ontgrendelen, met de vingerafdruk of gezichtsherkenning van je apparaat (de PRF-functie van de Passkey; Passkeys van Chrome, Edge, Safari, Google Password Manager en iCloud Keychain ondersteunen dit). Daarna zijn importeren, exporteren en een nieuwe machine ontgrendelen één tik — de herstelcode is alleen voor noodgevallen.

Agents gebruiken de kluis via het commando owlmem (Node 18 of nieuwer):

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 zet geheimen in de omgeving van het commando, zodat de agent ze nooit ziet. Wil je een agent de kluis direct laten gebruiken, voeg dan de lokale MCP-server toe — het ontsleutelen blijft op je machine:

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

Druk je op Enter bij owlmem vault unlock, dan opent je browser een pagina met de agent, de machine en een code — controleer of de code overeenkomt met die in je terminal, tik op je Passkey, en de sleutel wordt alleen naar die machine gestuurd, speciaal voor die machine versleuteld.

Agents hebben goedkeuring nodig om de kluis te gebruiken (Passkey, authenticator-app of GitHub), voor 15 minuten tot 2 uur per keer; ieder keurt zijn eigen agents goed, het hoofdaccount kan die van iedereen goedkeuren. Verwijderen en exporteren vragen altijd een nieuwe goedkeuring. Importeren uit Bitwarden, 1Password, KeePass en .env-bestanden, of exporteren, doe je vanuit de console met één tik op je Passkey of met owlmem vault import / export.

Back-ups. Telkens wanneer een item wordt gewijzigd of verwijderd, blijft de vorige versie 30 dagen bewaard. Het hoofdaccount kan die terugzetten vanaf de kluispagina; bij het terugzetten blijft ook een kopie bewaard van wat werd vervangen.

Abonnementen en prijzen

Abonnementen verschillen alleen in hoeveel AI-agents er kunnen verbinden, de opslag, de geheugenschrijfacties per maand en de kluisitems. Elk abonnement heeft elke functie, en zoveel mensen als je wilt. Prijzen zijn in Amerikaanse dollars; bij jaarlijkse betaling betaal je tien maanden en krijg je er twaalf.

• AI-agents worden geteld als een persoon plus een agentnaam — jouw Claude en de Claude van een teamgenoot zijn twee agents. Zoeken en lezen zijn onbeperkt.
• Upgraden of opzeggen kan op elk moment onder Billing in de console. Na opzeggen houd je het abonnement tot het einde van de periode waarvoor je hebt betaald.
• Terugbetaling. Volledige terugbetaling binnen 14 dagen na je eerste betaling — mail naar [email protected]. Daarna worden betalingen niet terugbetaald. Zie de voorwaarden.

Organisaties, limieten en je gegevens

• Organisaties. Je werkruimte is een organisatie met één hoofdaccount. Het hoofdaccount nodigt mensen per e-mail uit onder Organization; zij komen erbij als gebruikers. Iedereen deelt de kennisbank, herinneringen en kluis. Elke gebruiker beheert zijn eigen AI-agents en tokens; het hoofdaccount beheert die van iedereen, plus de leden, facturatie, export en verwijdering. Abonnementen beperken AI-agents, geen mensen.
• Aparte accounts. Hetzelfde e-mailadres in twee organisaties is twee aparte accounts. Na het inloggen kies je welke organisatie je opent; wisselen doe je via de zijbalk.
• Limieten. Elk abonnement bepaalt het aantal AI-agents, de opslag en de maandelijkse geheugenschrijfacties — zie prijzen. Is een limiet bereikt, dan worden schrijfacties geweigerd met een duidelijke melding; lezen blijft werken.
• Je GitHub. Synchroniseer de kennisbank met een repository van jezelf onder Knowledge → Sync to your GitHub. Alleen Markdown-bestanden worden gesynchroniseerd.
• Exporteren en verwijderen. Het hoofdaccount kan onder Organization alles downloaden of de organisatie verwijderen.
• Privacy. Je gegevens worden opgeslagen op servers in Canada. We trainen geen modellen op je gegevens en tonen geen advertenties. Details staan in het privacybeleid.

Problemen oplossen

“The space has reached its AI agent limit”

Elke agent (een persoon plus een naam) neemt één plek in. Hergebruik op de goedkeuringspagina een van je agentnamen, schakel in de console een agent uit die je niet meer gebruikt, of upgrade.

De app zegt dat hij opnieuw moet inloggen

Toegang wordt automatisch vernieuwd. Heb je de app in de console losgekoppeld, of is hij 60 dagen niet gebruikt, verbind hem dan opnieuw.

De inlogmail komt niet aan

Kijk in je spammap of er mail van [email protected] is. Links werken één keer en verlopen na 15 minuten; open ze in dezelfde browser als de goedkeuringspagina.

owlmem vault unlock vraagt alleen om een herstelcode

Dat is een oude versie. Voer npx -y owlmem@latest vault unlock uit (of werk bij met npm install -g owlmem) en druk op Enter bij de prompt.

“This passkey can't unlock the vault” (deze Passkey kan de kluis niet ontgrendelen)

Het apparaat van deze Passkey ondersteunt de PRF-functie niet. Je kunt er nog steeds agents mee goedkeuren. Voeg een andere Passkey toe die is opgeslagen in Google Password Manager, iCloud Keychain of Windows Hello.

“401 Unauthorized” met een token

Het token is ingetrokken of verkeerd getypt. Tokens beginnen met om_ en worden verstuurd als Authorization: Bearer om_….

Kom je er nog steeds niet uit? Mail naar [email protected].