連接你的 AI 代理

快速入門

奧麥透過 MCP，讓團隊裡每個 AI 代理共用同一個知識庫和記憶。連接一個代理大約只要一分鐘。

1. 建立你的空間。到 owlmem.com/app 用電子郵件登入。你的第一個空間免費。
2. 把奧麥加到你的 AI。只要 App 要求填寫遠端 MCP 伺服器或自訂連接器，就使用這個網址：
   複製

   https://mcp.owlmem.com/mcp

3. 核准。你的 App 會開啟一個奧麥頁面。替代理取個名字，然後按 Allow。就這樣——不必複製金鑰。

接著告訴你的代理怎麼使用它——請參考教代理使用奧麥。每個已連線的 App 都會出現在控制台的 AI agents & tokens → Connected apps 底下，你可以隨時在那裡中斷連線。

Claude（網頁版、桌面版和行動版）

1. 開啟 Settings → Connectors，選擇 Add custom connector。
2. 命名為 OwlMem，並貼上網址：
   複製

   https://mcp.owlmem.com/mcp

3. 按 Connect，登入奧麥，再按 Allow。

在網頁版新增的連接器，在 Claude Desktop 和行動 App 裡也能使用。若你使用 Claude 的 Team 或 Enterprise 方案，可能需要管理員先替整個組織新增這個連接器。

Claude Code

新增伺服器（加上 --scope user 就能在每個專案裡使用）：

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

接著啟動 Claude Code，輸入 /mcp，選擇 owlmem，再選 Authenticate。瀏覽器會開啟奧麥的核准頁面。

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，貼上網址，驗證方式選 OAuth：
   複製

   https://mcp.owlmem.com/mcp

3. 登入奧麥，然後按 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 並貼上網址，或把它加到 .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 伺服器的用戶端也都一樣：給它網址，然後核准。奧麥支援 MCP 授權規範（OAuth 2.1，搭配 PKCE 和動態用戶端註冊）。

改用權杖

有些工具無法走登入流程——例如指令碼、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_…" }
    }
  }
}

權杖不會過期；不再需要時，請在控制台撤銷。一個代理等於你加上它的名字，所以替已經在用的名字建立新權杖時，會取代舊權杖——舊的會立刻失效。透過登入重新連接 App 也是一樣。

給別人的 AI 使用的邀請權杖

若要讓合作夥伴的代理在沒有帳號的情況下使用你的組織，主帳號可以在 AI agents & tokens 底下建立邀請權杖（omi_…）。對方在自己的 App 裡新增奧麥，然後在奧麥登入頁面貼上權杖，不用登入。第一個使用它的 AI 會與它綁定；之後其他人再嘗試使用都會被拒絕。清單會顯示每個權杖是否已綁定，撤銷權杖就會中斷那個 AI 的連線。

代理可用的工具

知識用來存放人和代理會反覆閱讀的頁面（操作說明、決策、專案筆記）。記憶則用來存放代理能依語意回想的個別事實。

每個方案的搜尋和回想都不限次數。儲存記憶會計入方案的每月記憶寫入次數；撰寫文件則計入儲存空間。

教代理使用奧麥

在代理的常駐指示裡加上幾行，它們就能把奧麥用得更好——例如 CLAUDE.md、AGENTS.md、Cursor 規則，或 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.

新空間一開始有四個資料夾——lessons/、projects/、reference/、archive/——每個都附有簡短的 README。代理可以另外建立資料夾，最多三層。

保險庫與 owlmem 指令

保險庫以端對端加密保存代理需要的憑證：項目在你的機器上用只有你持有的金鑰加密，奧麥只儲存它無法讀取的密文。主帳號在控制台的 Vault（保險庫）底下啟用它，之後組織裡的每個人都能使用。請保管好它顯示給你的復原碼——控制台可以讓你用自己的郵件 App 把它寄給自己，所以復原碼完全不會經過奧麥。

用 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、驗證器 App 或 GitHub），每次 15 分鐘到 2 小時；每個人核准自己的代理，主帳號可以核准任何人的代理。刪除和匯出一律需要重新核准。你可以在控制台點一下 Passkey，或用 owlmem vault import / export，從 Bitwarden、1Password、KeePass 和 .env 檔案匯入，或者匯出。

備份。每當項目被修改或刪除，前一個版本都會保留 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”

每個代理（一個人加上一個名字）佔用一個名額。你可以在核准頁面沿用你現有的代理名稱、在控制台停用不再使用的代理，或是升級。

App 說需要重新登入

存取權會自動更新。如果你在控制台中斷了這個 App 的連線，或它已經 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]。