Conecte seus agentes de IA

Início rápido

O OwlMem dá a todos os agentes de IA da sua equipe uma base de conhecimento e uma memória compartilhadas, via MCP. Conectar um agente leva cerca de um minuto.

1. Crie seu espaço. Entre em owlmem.com/app com seu e-mail. Seu primeiro espaço é grátis.
2. Adicione o OwlMem à sua IA. Use este endereço onde quer que seu app peça um servidor MCP remoto ou um conector personalizado:
   Copiar

   https://mcp.owlmem.com/mcp

3. Aprove. Seu app abre uma página do OwlMem. Escolha um nome para o agente e clique em Allow. Pronto — nenhuma chave para copiar.

Depois, explique aos seus agentes como usá-lo — veja Como orientar seus agentes. Cada app conectado aparece no console em AI agents & tokens → Connected apps, onde você pode desconectá-lo a qualquer momento.

Claude (web, desktop e celular)

1. Abra Settings → Connectors e escolha Add custom connector.
2. Dê o nome OwlMem e cole a URL:
   Copiar

   https://mcp.owlmem.com/mcp

3. Clique em Connect, entre no OwlMem e clique em Allow.

Os conectores adicionados na web também funcionam no Claude Desktop e nos apps para celular. Nos planos Team e Enterprise, talvez um administrador precise adicionar o conector para a organização primeiro.

Claude Code

Adicione o servidor (use --scope user para deixá-lo disponível em todos os projetos):

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

Depois, inicie o Claude Code, digite /mcp, selecione owlmem e escolha Authenticate. Seu navegador abre a página de aprovação do OwlMem.

Codex

Ao adicionar o servidor, o login começa na hora:

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

Se a etapa no navegador expirar, rode codex mcp login owlmem. Ou adicione-o manualmente a ~/.codex/config.toml e depois faça login:

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

O Codex pede confirmação antes de chamar ferramentas MCP, a menos que você as libere nas configurações de aprovação dele.

ChatGPT

1. Abra Settings → Apps & Connectors. Em Advanced settings, ative o Developer mode.
2. Escolha Create, dê o nome OwlMem, cole a URL e escolha OAuth como autenticação:
   Copiar

   https://mcp.owlmem.com/mcp

3. Entre no OwlMem e clique em Allow.

A disponibilidade de conectores personalizados depende do seu plano do ChatGPT e das configurações do workspace.

Cursor

Adicione isto a ~/.cursor/mcp.json (ou a .cursor/mcp.json em um projeto):

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

Abra Cursor Settings → MCP. O OwlMem mostra Needs login — clique e aprove no navegador.

VS Code (GitHub Copilot)

Rode MCP: Add Server na paleta de comandos, escolha HTTP e cole a URL, ou adicione-o a .vscode/mcp.json:

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

O VS Code pede que você faça login na primeira vez que o Copilot usar o servidor.

Windsurf, Gemini CLI e outros

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

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

Gemini CLI — ~/.gemini/settings.json, depois rode /mcp auth owlmem:

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

Qualquer outro cliente com suporte a servidores MCP remotos com OAuth funciona do mesmo jeito: informe a URL e aprove. O OwlMem segue a especificação de autorização do MCP (OAuth 2.1 com PKCE e registro dinâmico de clientes).

Usando um token

Algumas ferramentas não conseguem fazer o fluxo de login — scripts, jobs de CI, clientes mais antigos. Para elas, crie um token no console em AI agents & tokens → Connect an AI e envie-o como bearer token:

Authorization: Bearer om_…

Exemplo com o Claude Code:

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

Para um cliente que só roda servidores locais (stdio), faça a ponte com o mcp-remote:

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

Os tokens não expiram; revogue um no console quando não precisar mais dele. Um agente é você mais o nome dele, então criar um token novo para um nome que você já usa substitui o token antigo — o antigo para de funcionar na hora. O mesmo vale para reconectar um app pelo login.

Um token de convite para a IA de outra pessoa

Para deixar o agente de um parceiro usar sua organização sem ter conta, a conta principal cria um token de convite (omi_…) em AI agents & tokens. O parceiro adiciona o OwlMem no app dele e cola o token na página de login do OwlMem, em vez de entrar com uma conta. A primeira IA que usar o token fica vinculada a ele; qualquer outra que tentar depois é recusada. A lista mostra se cada token está vinculado, e revogar um desconecta aquela IA.

Ferramentas que seus agentes recebem

O conhecimento é para páginas que pessoas e agentes leem de novo (tutoriais, decisões, notas de projeto). A memória é para fatos isolados que um agente consegue recuperar pelo significado.

Buscar e consultar a memória é ilimitado em todos os planos. Guardar memórias conta para as gravações de memória mensais do seu plano; escrever documentos conta para o armazenamento.

Como orientar seus agentes

Os agentes usam o OwlMem muito melhor com algumas linhas nas instruções permanentes — CLAUDE.md, AGENTS.md, regras do Cursor ou as instruções de um projeto do 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.

Espaços novos começam com quatro pastas — lessons/, projects/, reference/, archive/ —, cada uma com um README curto. Os agentes podem criar outras pastas com até três níveis de profundidade.

O cofre e o comando owlmem

O cofre guarda as credenciais de que seus agentes precisam, com criptografia de ponta a ponta: os itens são criptografados na sua máquina com uma chave que só você tem, e o OwlMem armazena um texto cifrado que não consegue ler. A conta principal o ativa no console, em Vault (cofre); a partir daí, todos na organização podem usá-lo. Guarde o código de recuperação exibido — o console oferece enviá-lo por e-mail para você mesmo pelo seu próprio app de e-mail, para que ele nunca passe pelo OwlMem.

Desbloqueie com uma Passkey. Cada Passkey que você adiciona em Your approval methods também é configurada para desbloquear o cofre, usando a digital ou o rosto no seu dispositivo (o recurso PRF da Passkey; Passkeys do Chrome, Edge, Safari, Gerenciador de Senhas do Google e Chaves do iCloud têm suporte). Depois disso, importar, exportar e desbloquear uma máquina nova é só um toque — o código de recuperação fica só para emergências.

Os agentes o usam pelo comando owlmem (Node 18 ou mais recente):

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

O owlmem run coloca os segredos no ambiente do comando, então o agente nunca os vê. Para deixar um agente usar o cofre diretamente, adicione o servidor MCP local — a descriptografia continua na sua máquina:

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

Quando você aperta Enter em owlmem vault unlock, o navegador abre uma página mostrando o agente, a máquina e um código — confira se o código bate com o do terminal, toque na sua Passkey e a chave é enviada só para aquela máquina, criptografada para ela.

Os agentes precisam de aprovação para usar o cofre (Passkey, app autenticador ou GitHub), por 15 minutos a 2 horas de cada vez; cada pessoa aprova os próprios agentes, e a conta principal pode aprovar os de qualquer um. Excluir e exportar sempre exigem uma aprovação nova. Importe do Bitwarden, 1Password, KeePass e de arquivos .env, ou exporte, pelo console com um toque na sua Passkey ou com owlmem vault import / export.

Backups. Sempre que um item é alterado ou excluído, a versão anterior é guardada por 30 dias. A conta principal pode restaurá-la na página do cofre; a restauração também guarda uma cópia do que foi substituído.

Planos e preços

Os planos só mudam na quantidade de agentes de IA que podem se conectar, no armazenamento, nas gravações de memória por mês e nos itens do cofre. Todo plano tem todos os recursos, com quantas pessoas quiser. Preços em dólares americanos; na cobrança anual, você paga dez meses e leva doze.

• Agentes de IA são contados como uma pessoa mais um nome de agente — o seu Claude e o Claude de um colega são dois agentes. Buscas e leituras são ilimitadas.
• Faça upgrade ou cancele quando quiser em Billing, no console. Ao cancelar, o plano continua até o fim do período pago.
• Reembolsos. Reembolso integral em até 14 dias após o seu primeiro pagamento — escreva para [email protected]. Depois disso, os pagamentos não são reembolsados. Veja os termos.

Organizações, limites e seus dados

• Organizações. Seu espaço é uma organização com uma conta principal. A conta principal convida pessoas por e-mail em Organization; elas entram como usuários. Todos compartilham a base de conhecimento, as memórias e o cofre. Cada usuário gerencia os próprios agentes de IA e tokens; a conta principal gerencia os de todos, além dos membros, da cobrança, da exportação e da exclusão. Os planos limitam agentes de IA, não pessoas.
• Contas separadas. O mesmo e-mail em duas organizações são duas contas separadas. Depois de entrar, você escolhe em qual organização quer trabalhar; para trocar, use a barra lateral.
• Limites. Cada plano define o número de agentes de IA, o armazenamento e as gravações de memória mensais — veja os preços. Quando um limite é atingido, as gravações são recusadas com uma mensagem clara; a leitura continua funcionando.
• Seu GitHub. Sincronize a base de conhecimento com um repositório seu em Knowledge → Sync to your GitHub. Só os arquivos Markdown são sincronizados.
• Exportar e excluir. A conta principal pode baixar tudo ou excluir a organização em Organization.
• Privacidade. Seus dados ficam em servidores no Canadá. Não treinamos modelos com seus dados nem mostramos anúncios. Detalhes na política de privacidade.

Solução de problemas

“The space has reached its AI agent limit”

Cada agente (uma pessoa mais um nome) ocupa uma vaga. Na página de aprovação, reutilize um dos nomes de agente que você já tem, desative no console um agente que não usa mais ou faça upgrade.

O app diz que precisa fazer login de novo

O acesso é renovado automaticamente. Se você desconectou o app no console, ou se ele ficou 60 dias sem uso, conecte-o de novo.

O e-mail de login não chega

Procure no spam uma mensagem de [email protected]. Os links funcionam uma vez só e expiram em 15 minutos; abra-os no mesmo navegador da página de aprovação.

owlmem vault unlock só pede um código de recuperação

É uma versão antiga. Rode npx -y owlmem@latest vault unlock (ou atualize com npm install -g owlmem) e aperte Enter quando aparecer o prompt.

“This passkey can't unlock the vault” (esta Passkey não consegue desbloquear o cofre)

O dispositivo dela não tem suporte ao recurso PRF. Ela continua servindo para aprovar agentes. Adicione outra Passkey salva no Gerenciador de Senhas do Google, nas Chaves do iCloud ou no Windows Hello.

“401 Unauthorized” com um token

O token foi revogado ou digitado errado. Os tokens começam com om_ e são enviados como Authorization: Bearer om_….

Ainda com problemas? Escreva para [email protected].