AI エージェントを接続する

クイックスタート

OwlMem は、チームのすべての AI エージェントに、ひとつの共有ナレッジベースとメモリーを MCP 経由で提供します。エージェントの接続にかかるのは一分ほどです。

1. スペースを作成する。owlmem.com/app でメールアドレスを使ってログインします。最初のスペースは無料です。
2. AI に OwlMem を追加する。アプリがリモート MCP サーバーやカスタムコネクタを求める場所に、このアドレスを入力します：
   コピー

   https://mcp.owlmem.com/mcp

3. 承認する。アプリが OwlMem のページを開きます。エージェントの名前を決めて Allow をクリックします。これで完了。キーをコピーする必要はありません。

続いて、エージェントに使い方を教えましょう。エージェントに教えるをご覧ください。接続したアプリはすべて、コンソールの AI agents & tokens → Connected apps に表示され、いつでも切断できます。

Claude（Web、デスクトップ、モバイル）

1. Settings → Connectors を開き、Add custom connector を選びます。
2. 名前を OwlMem にして、URL を貼り付けます：
   コピー

   https://mcp.owlmem.com/mcp

3. Connect をクリックし、OwlMem にログインして Allow をクリックします。

Web で追加したコネクタは、Claude Desktop とモバイルアプリでも使えます。Team プランや Enterprise プランでは、先に管理者が組織にコネクタを追加する必要がある場合があります。

Claude Code

サーバーを追加します（--scope user を付けると、すべてのプロジェクトで使えるようになります）：

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

次に Claude Code を起動し、/mcp と入力して owlmem を選び、Authenticate を選びます。ブラウザーで OwlMem の承認ページが開きます。

Codex

サーバーを追加すると、すぐにログインが始まります：

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

ブラウザーでの手順がタイムアウトした場合は、codex mcp login owlmem を実行してください。または ~/.codex/config.toml に手動で追加してからログインします：

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

Codex は、承認設定で許可しない限り、MCP ツールを呼び出す前に確認を求めます。

ChatGPT

1. Settings → Apps & Connectors を開きます。Advanced settings で Developer mode をオンにします。
2. Create を選び、名前を OwlMem にして URL を貼り付け、認証方式に OAuth を選びます：
   コピー

   https://mcp.owlmem.com/mcp

3. OwlMem にログインして Allow をクリックします。

カスタムコネクタを使えるかどうかは、ChatGPT のプランとワークスペースの設定によって異なります。

Cursor

~/.cursor/mcp.json（プロジェクト単位なら .cursor/mcp.json）に次を追加します：

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

Cursor Settings → MCP を開きます。OwlMem に Needs login と表示されるので、クリックしてブラウザーで承認します。

VS Code（GitHub Copilot）

コマンドパレットから MCP: Add Server を実行し、HTTP を選んで URL を貼り付けます。または .vscode/mcp.json に追加します：

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

Copilot が初めてサーバーを使うときに、VS Code がログインを求めます。

Windsurf、Gemini CLI など

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

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

Gemini CLI — ~/.gemini/settings.json に追加してから、/mcp auth owlmem を実行します：

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

OAuth 対応のリモート MCP サーバーをサポートするほかのクライアントも、同じ手順で使えます。URL を渡して承認するだけです。OwlMem は MCP の認可仕様（PKCE と動的クライアント登録を備えた OAuth 2.1）に対応しています。

トークンを使う場合

スクリプト、CI ジョブ、古いクライアントなど、ログインの手順を実行できないツールもあります。その場合は、コンソールの AI agents & tokens → Connect an AI でトークンを作成し、Bearer トークンとして送信します：

Authorization: Bearer om_…

Claude Code の例：

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

ローカル（stdio）サーバーしか動かせないクライアントは、mcp-remote で橋渡しします：

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

トークンに有効期限はありません。不要になったらコンソールで取り消してください。エージェントは「あなた＋名前」で識別されるため、すでに使っている名前で新しいトークンを作ると古いトークンが置き換えられ、古いほうはすぐに使えなくなります。アプリをログインで接続し直した場合も同じです。

他人の AI のための招待トークン

パートナーのエージェントに、アカウントなしで組織を使ってもらうには、メインアカウントが AI agents & tokens で招待トークン（omi_…）を作成します。パートナーは自分のアプリに OwlMem を追加し、OwlMem のログインページで、ログインする代わりにそのトークンを貼り付けます。最初に使った AI がそのトークンに紐付けられ、後から別の誰かが使おうとしても拒否されます。一覧には各トークンが紐付け済みかどうかが表示され、取り消すとその AI は切断されます。

エージェントが使えるツール

ナレッジは、人やエージェントが繰り返し読むページ（手順書、決定事項、プロジェクトのメモ）のためのものです。メモリーは、エージェントが意味で想起できる個々の事実のためのものです。

検索と想起はどのプランでも無制限です。メモリーの保存はプランの月間メモリー書き込み数に、ドキュメントの書き込みはストレージに計上されます。

エージェントに教える

常設の指示（CLAUDE.md、AGENTS.md、Cursor のルール、Claude プロジェクトの指示）に数行加えるだけで、エージェントは OwlMem をずっと上手に使えるようになります：

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

新しいスペースには最初から四つのフォルダ（lessons/、projects/、reference/、archive/）があり、それぞれに短い README が入っています。エージェントは三階層までほかのフォルダを作成できます。

保管庫と owlmem コマンド

保管庫は、エージェントが必要とする認証情報をエンドツーエンド暗号化で保管します。アイテムはあなただけが持つ鍵であなたのマシン上で暗号化され、OwlMem が保存するのは自分では読めない暗号文です。メインアカウントがコンソールの Vault（保管庫）で有効にすると、組織の全員が使えるようになります。表示されるリカバリーコードは必ず保管してください。コンソールから、あなた自身のメールアプリで自分宛てにメールすることもできるので、OwlMem を経由することはありません。

Passkey でロック解除。Your approval methods で追加した Passkey はどれも、デバイスの指紋認証や顔認証を使って保管庫のロックを解除できるように設定されます（Passkey の PRF 機能を使用。Chrome、Edge、Safari、Google パスワード マネージャー、iCloud キーチェーンの Passkey が対応しています）。以後、インポート、エクスポート、新しいマシンのロック解除はワンタップ。リカバリーコードは緊急時専用です。

エージェントは owlmem コマンド（Node 18 以降）を通じて使います：

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 はシークレットをコマンドの環境変数に渡すので、エージェントがそれを目にすることはありません。エージェントに保管庫を直接使わせるには、ローカルの MCP サーバーを追加します。復号はあなたのマシン上で行われます：

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

owlmem vault unlock で Enter を押すと、ブラウザーでエージェント、マシン、コードを表示するページが開きます。コードがターミナルと一致することを確かめて Passkey をタップすると、鍵はそのマシン専用に暗号化され、そのマシンにだけ送られます。

エージェントが保管庫を使うには、Passkey、認証アプリ、または GitHub による承認が必要で、承認ごとに 15 分から 2 時間有効です。各メンバーは自分のエージェントを承認し、メインアカウントは誰のエージェントでも承認できます。削除とエクスポートには、毎回新たな承認が必要です。Bitwarden、1Password、KeePass、.env ファイルからのインポートやエクスポートは、コンソールで Passkey をワンタップするか、owlmem vault import / export で行えます。

バックアップ。アイテムが変更または削除されるたびに、以前のバージョンが 30 日間保持されます。メインアカウントは保管庫のページから復元でき、復元時には置き換えられる側のコピーも保持されます。

プランと料金

プランの違いは、接続できる AI エージェントの数、ストレージ、月間メモリー書き込み数、保管庫のアイテム数だけです。どのプランでも全機能が使え、人数も無制限です。価格は米ドル表示で、年払いは十二か月分を十か月分の料金でご利用いただけます。

• AI エージェントは「人＋エージェント名」で数えます。あなたの Claude とチームメイトの Claude は二つのエージェントです。検索と閲覧は無制限です。
• アップグレードや解約は、コンソールの Billing でいつでも行えます。解約しても、支払い済みの期間が終わるまでプランは継続します。
• 返金。初回のお支払いから 14 日以内なら全額返金します。[email protected] までメールしてください。それ以降のお支払いは返金されません。利用規約をご覧ください。

組織、上限、データ

• 組織。スペースは、メインアカウントをひとつ持つ組織です。メインアカウントは Organization でメールによりメンバーを招待し、招待された人はユーザーとして参加します。全員がナレッジベース、メモリー、保管庫を共有します。各ユーザーは自分の AI エージェントとトークンを管理し、メインアカウントは全員の分に加えて、メンバー、請求、エクスポート、削除を管理します。プランが制限するのは AI エージェントの数で、人数ではありません。
• 別々のアカウント。同じメールアドレスでも、二つの組織にあれば別々のアカウントです。ログイン後にどの組織に入るかを選び、サイドバーから切り替えられます。
• 上限。各プランで AI エージェント数、ストレージ、月間メモリー書き込み数が決まっています。料金をご覧ください。上限に達すると、書き込みはわかりやすいメッセージとともに拒否されますが、読み取りは引き続き使えます。
• あなたの GitHub。Knowledge → Sync to your GitHub で、ナレッジベースを自分のリポジトリに同期できます。同期されるのは Markdown ファイルだけです。
• エクスポートと削除。メインアカウントは Organization で、すべてをダウンロードしたり組織を削除したりできます。
• プライバシー。データはカナダのサーバーに保存されます。あなたのデータでモデルを学習させることも、広告を表示することもありません。詳しくはプライバシーポリシーをご覧ください。

トラブルシューティング

“The space has reached its AI agent limit”

エージェント（人＋名前）ひとつにつき枠をひとつ使います。承認ページで既存のエージェント名を再利用するか、使っていないエージェントをコンソールで無効にするか、アップグレードしてください。

アプリが再ログインを求めてくる

アクセスは自動的に更新されます。コンソールでアプリを切断した場合や、60 日間使われなかった場合は、もう一度接続してください。

ログインメールが届かない

迷惑メールフォルダに [email protected] からのメールがないか確認してください。リンクは一度だけ有効で、15 分で期限切れになります。承認ページと同じブラウザーで開いてください。

owlmem vault unlock がリカバリーコードしか求めてこない

古いバージョンです。npx -y owlmem@latest vault unlock を実行し（または npm install -g owlmem で更新し）、プロンプトで Enter を押してください。

“This passkey can't unlock the vault”（この Passkey では保管庫のロックを解除できません）

その Passkey のデバイスが PRF 機能に対応していません。エージェントの承認には引き続き使えます。Google パスワード マネージャー、iCloud キーチェーン、Windows Hello に保存した Passkey を別に追加してください。

トークン使用時の “401 Unauthorized”

トークンが取り消されたか、入力を誤っています。トークンは om_ で始まり、Authorization: Bearer om_… として送信します。

それでも解決しない場合は、[email protected] までメールしてください。