pumaDB

1) 選擇您將如何連接到 pumaDB: 選擇兩種存取方法之一：(a) 適用於代理程式客戶端 (ChatGPT、Claude、Codex 或任何支援 Streamable HTTP MCP 的客戶端) 的託管 MCP，或 (b) 適用於後端/無伺服器/CLI 的伺服器端 REST API。託管 MCP 端點：https://api.pumadb.ai/mcp。REST API 基礎：https://api.pumadb.ai。

2) 如果使用託管 MCP：將您的代理程式客戶端連接到 pumaDB MCP 伺服器: 在您的支援 MCP 的客戶端中，使用 Streamable HTTP 傳輸新增一個新的 MCP 伺服器，並將伺服器 URL 設定為 https://api.pumadb.ai/mcp。根據客戶端的提示透過 OAuth 進行身份驗證。

3) 如果使用 REST：安全地設定伺服器端 API 金鑰: 在受信任的伺服器端環境（後端、無伺服器功能、Worker、CLI）中建立並儲存一個名為 puma_live_* 的 API 金鑰。請勿將 API 金鑰放置在 React 捆綁包、靜態網站、行動應用程式、瀏覽器程式碼或公共儲存庫中。

4) 決定您希望 pumaDB 記住什麼（您的模式）: pumaDB 儲存小型持久 JSON 行。常見的記憶體類型包括：技能 markdown、專案約定、使用者偏好、研究剪輯、任務狀態和類型安全記憶體（作為惰性記錄儲存的資源/程式碼片段/配置範例，供以後審查）。

5) 為您的記憶體建立/選擇一個表格: 將記憶體組織到表格中（例如：preferences、project_conventions、task_state）。每個帳戶最多支援 20 個表格，每個表格 1,000 行，總儲存空間為 25 MB。

6) 寫入記憶體（建議使用託管 MCP：使用整合的記憶工具）: 從透過 MCP 連接的代理程式客戶端，呼叫 pumaDB 記憶工具來儲存一個 JSON 行（例如，儲存使用者偏好，如「保持答案簡短」）。記憶工具儲存帶有惰性安全中繼資料的常見記憶體類型。

7) 寫入記憶體（REST 替代方案：將 JSON 行 POST 到 /v1/{table}）: 從伺服器端程式碼，向 https://api.pumadb.ai 上的 POST /v1/{table} 發送一個經過身份驗證的請求，以在表格中建立一行。使用 bearer API 金鑰。儲存您的應用程式/代理程式稍後將查詢的 JSON 欄位。

8) 在需要時讀取/查詢記憶體: 在您的代理程式客戶端中使用 MCP 查詢式工具呼叫（例如，在回應之前查詢偏好表格），或從伺服器端程式碼使用 REST GET /v1/{table}。小型查詢可以返回內聯 JSON；較大的結果可以返回短期檢視器/下載連結（或請求 includeLink: true）。

9) 當事實改變時明確更新記憶體: 使用 REST 端點更新儲存的行：POST /v1/{table}/update_row 用於有針對性的更新，或 POST /v1/{table}/update_where 用於過濾更新。pumaDB 支援「自然編輯」，因此可以用作過濾更新的純文字更改，而不會產生重複；批量更新需要明確選擇加入。

10) 刪除您不再希望儲存的記憶體: 使用 DELETE /v1/{table} 從表格中刪除行（伺服器端）。刪除和更新會自動封存先前的行內容。

11) 使用版本歷史記錄從錯誤中恢復: pumaDB 會為每次更新和刪除保留自動版本歷史記錄：最後 10 個版本會保留 30 天，並且可以透過單次呼叫恢復。

12) 保持在限制和速率限制內: 根據帳戶限制（20 個表格、每個表格 1,000 行、總計 25 MB）規劃使用。遵守速率限制：每個金鑰每分鐘 30 次寫入和每個金鑰每分鐘 60 次讀取。