Collega i tuoi agenti AI

Guida rapida

OwlMem dà a ogni agente AI del tuo team un'unica base di conoscenza e una memoria condivise, tramite MCP. Collegare un agente richiede circa un minuto.

1. Crea il tuo spazio. Accedi su owlmem.com/app con la tua email. Il primo spazio è gratuito.
2. Aggiungi OwlMem alla tua AI. Usa questo indirizzo ovunque la tua app chieda un server MCP remoto o un connettore personalizzato:
   Copia

   https://mcp.owlmem.com/mcp

3. Approvalo. La tua app apre una pagina di OwlMem. Scegli un nome per l'agente e clicca Allow. Tutto qui — nessuna chiave da copiare.

Poi spiega ai tuoi agenti come usarlo — vedi Istruire i tuoi agenti. Ogni app collegata compare nella console in AI agents & tokens → Connected apps, dove puoi scollegarla in qualsiasi momento.

Claude (web, desktop e mobile)

1. Apri Settings → Connectors e scegli Add custom connector.
2. Chiamalo OwlMem e incolla l'URL:
   Copia

   https://mcp.owlmem.com/mcp

3. Clicca Connect, accedi a OwlMem e clicca Allow.

I connettori aggiunti sul web funzionano anche in Claude Desktop e nelle app mobili. Con i piani Team ed Enterprise potrebbe essere necessario che un amministratore aggiunga prima il connettore per l'organizzazione.

Claude Code

Aggiungi il server (usa --scope user per renderlo disponibile in ogni progetto):

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

Poi avvia Claude Code, digita /mcp, seleziona owlmem e scegli Authenticate. Il browser apre la pagina di approvazione di OwlMem.

Codex

Quando aggiungi il server, l'accesso parte subito:

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

Se il passaggio nel browser è scaduto, esegui codex mcp login owlmem. Oppure aggiungilo a mano in ~/.codex/config.toml e poi accedi:

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

Codex chiede conferma prima di chiamare gli strumenti MCP, a meno che tu non li consenta nelle sue impostazioni di approvazione.

ChatGPT

1. Apri Settings → Apps & Connectors. In Advanced settings, attiva Developer mode.
2. Scegli Create, chiamalo OwlMem, incolla l'URL e scegli OAuth come autenticazione:
   Copia

   https://mcp.owlmem.com/mcp

3. Accedi a OwlMem e clicca Allow.

La disponibilità dei connettori personalizzati dipende dal tuo piano ChatGPT e dalle impostazioni del workspace.

Cursor

Aggiungi questo a ~/.cursor/mcp.json (o a .cursor/mcp.json in un progetto):

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

Apri Cursor Settings → MCP. OwlMem mostra Needs login: cliccalo e approva nel browser.

VS Code (GitHub Copilot)

Esegui MCP: Add Server dal riquadro comandi, scegli HTTP e incolla l'URL, oppure aggiungilo a .vscode/mcp.json:

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

VS Code ti chiede di accedere la prima volta che Copilot usa il server.

Windsurf, Gemini CLI e altri

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

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

Gemini CLI — ~/.gemini/settings.json, poi esegui /mcp auth owlmem:

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

Qualsiasi altro client che supporti server MCP remoti con OAuth funziona allo stesso modo: dagli l'URL e approva. OwlMem supporta la specifica di autorizzazione MCP (OAuth 2.1 con PKCE e registrazione dinamica dei client).

Usare un token

Alcuni strumenti non riescono a completare l'accesso: script, job di CI, client meno recenti. Per questi, crea un token nella console in AI agents & tokens → Connect an AI e invialo come bearer token:

Authorization: Bearer om_…

Esempio con Claude Code:

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

Per un client che esegue solo server locali (stdio), fai da ponte con mcp-remote:

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

I token non scadono; revocane uno nella console quando non ti serve più. Un agente sei tu più il suo nome, quindi creare un nuovo token per un nome che usi già sostituisce il vecchio token, che smette subito di funzionare. Lo stesso vale se ricolleghi un'app tramite accesso.

Un token di invito per l'AI di qualcun altro

Per permettere all'agente di un partner di usare la tua organizzazione senza un account, l'account principale crea un token di invito (omi_…) in AI agents & tokens. Il partner aggiunge OwlMem nella sua app e, invece di accedere, incolla il token nella pagina di accesso di OwlMem. La prima AI che lo usa resta legata al token; chiunque altro provi a usarlo in seguito viene rifiutato. L'elenco mostra se ogni token è già legato, e revocarne uno scollega quella AI.

Gli strumenti dei tuoi agenti

La conoscenza è per le pagine che persone e agenti rileggono (guide pratiche, decisioni, note di progetto). La memoria è per singoli fatti che un agente può richiamare in base al significato.

Ricerca e richiamo sono illimitati in ogni piano. Salvare ricordi conta nelle scritture di memoria mensili del tuo piano; scrivere documenti conta nello spazio di archiviazione.

Istruire i tuoi agenti

Gli agenti usano OwlMem molto meglio con qualche riga nelle loro istruzioni permanenti — CLAUDE.md, AGENTS.md, le regole di Cursor o le istruzioni di un progetto 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.

I nuovi spazi partono con quattro cartelle — lessons/, projects/, reference/, archive/ — ognuna con un breve README. Gli agenti possono creare altre cartelle fino a tre livelli di profondità.

La cassaforte e il comando owlmem

La cassaforte custodisce le credenziali di cui i tuoi agenti hanno bisogno, cifrate end-to-end: gli elementi vengono cifrati sulla tua macchina con una chiave che hai solo tu, e OwlMem conserva testo cifrato che non può leggere. L'account principale l'attiva nella console in Vault (cassaforte); da quel momento tutti nell'organizzazione possono usarla. Conserva il codice di recupero che ti viene mostrato: la console ti propone di inviartelo via email dalla tua app di posta, così non passa mai da OwlMem.

Sblocca con una Passkey. Ogni Passkey che aggiungi in Your approval methods viene configurata anche per sbloccare la cassaforte, usando l'impronta digitale o il riconoscimento del volto del tuo dispositivo (la funzione PRF della Passkey; la supportano le Passkey di Chrome, Edge, Safari, Google Password Manager e iCloud Keychain). Da lì in poi importare, esportare e sbloccare una nuova macchina richiede un solo tocco — il codice di recupero serve solo per le emergenze.

Gli agenti la usano tramite il comando owlmem (Node 18 o successivo):

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 inserisce i segreti nell'ambiente del comando, così l'agente non li vede mai. Per far usare la cassaforte direttamente a un agente, aggiungi il server MCP locale — la decifratura resta sulla tua macchina:

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

Quando premi Invio su owlmem vault unlock, il browser apre una pagina che mostra l'agente, la macchina e un codice: controlla che il codice corrisponda a quello del terminale, tocca la tua Passkey e la chiave viene inviata solo a quella macchina, cifrata apposta per lei.

Gli agenti hanno bisogno di un'approvazione per usare la cassaforte (Passkey, app di autenticazione o GitHub), da 15 minuti a 2 ore alla volta; ognuno approva i propri agenti, l'account principale può approvare quelli di chiunque. Eliminare ed esportare richiedono sempre una nuova approvazione. Importa da Bitwarden, 1Password, KeePass e file .env, oppure esporta, dalla console con un tocco della tua Passkey o con owlmem vault import / export.

Backup. Ogni volta che un elemento viene modificato o eliminato, la versione precedente viene conservata per 30 giorni. L'account principale può ripristinarla dalla pagina della cassaforte; il ripristino conserva anche una copia di ciò che ha sostituito.

Piani e prezzi

I piani cambiano solo per quanti agenti AI possono collegarsi, spazio di archiviazione, scritture di memoria al mese ed elementi nella cassaforte. Ogni piano ha tutte le funzioni e persone illimitate. I prezzi sono in dollari USA; con la fatturazione annuale paghi dieci mesi e ne hai dodici.

• Gli agenti AI si contano come persona più nome dell'agente: il tuo Claude e il Claude di un collega sono due agenti. Ricerca e lettura sono illimitate.
• Cambia piano o disdici quando vuoi in Billing nella console. Se disdici, il piano resta attivo fino alla fine del periodo già pagato.
• Rimborsi. Rimborso completo entro 14 giorni dal primo pagamento: scrivi a [email protected]. Dopo, i pagamenti non vengono rimborsati. Vedi i termini.

Organizzazioni, limiti e i tuoi dati

• Organizzazioni. Il tuo spazio è un'organizzazione con un account principale. L'account principale invita le persone via email in Organization; entrano come utenti. Tutti condividono la base di conoscenza, i ricordi e la cassaforte. Ogni utente gestisce i propri agenti AI e token; l'account principale gestisce quelli di tutti, oltre a membri, fatturazione, esportazione ed eliminazione. I piani limitano gli agenti AI, non le persone.
• Account separati. La stessa email in due organizzazioni corrisponde a due account separati. Dopo l'accesso scegli in quale organizzazione entrare; puoi cambiarla dalla barra laterale.
• Limiti. Ogni piano stabilisce il numero di agenti AI, lo spazio di archiviazione e le scritture di memoria mensili — vedi i prezzi. Quando si raggiunge un limite, le scritture vengono rifiutate con un messaggio chiaro; la lettura continua a funzionare.
• Il tuo GitHub. Sincronizza la base di conoscenza con un repository di tua proprietà in Knowledge → Sync to your GitHub. Vengono sincronizzati solo i file Markdown.
• Esportazione ed eliminazione. L'account principale può scaricare tutto o eliminare l'organizzazione in Organization.
• Privacy. I tuoi dati sono conservati su server in Canada. Non addestriamo modelli sui tuoi dati e non mostriamo pubblicità. Dettagli nell'informativa sulla privacy.

Risoluzione dei problemi

“The space has reached its AI agent limit”

Ogni agente (una persona più un nome) occupa un posto. Nella pagina di approvazione riusa uno dei nomi dei tuoi agenti, disattiva nella console un agente che non usi più, oppure passa a un piano superiore.

L'app dice che deve accedere di nuovo

L'accesso si rinnova automaticamente. Se hai scollegato l'app nella console, o non è stata usata per 60 giorni, collegala di nuovo.

L'email di accesso non arriva

Controlla nello spam se c'è posta da [email protected]. I link funzionano una sola volta e scadono dopo 15 minuti; aprili nello stesso browser della pagina di approvazione.

owlmem vault unlock chiede solo un codice di recupero

È una versione vecchia. Esegui npx -y owlmem@latest vault unlock (o aggiorna con npm install -g owlmem) e premi Invio al prompt.

“This passkey can't unlock the vault” (questa Passkey non può sbloccare la cassaforte)

Il suo dispositivo non supporta la funzione PRF. Può comunque approvare gli agenti. Aggiungi un'altra Passkey salvata in Google Password Manager, iCloud Keychain o Windows Hello.

“401 Unauthorized” con un token

Il token è stato revocato o digitato male. I token iniziano con om_ e vengono inviati come Authorization: Bearer om_….

Ancora bloccato? Scrivi a [email protected].