By name: supermemory-mcp-setup description: 設定 supermemory MCP server 與 Claude Code 整合時使用，包括遇到「Needs authentication」或「Failed to connect」錯誤、設定 mcp-remote 的 API Key header、或排查設定後 MCP 工具未載入等問題。也適用於使用者詢問 supermemory 的 memory/recall/whoAmI 工具或跨對話持久記憶功能。
Supermemory MCP 與 Claude Code 整合設定
Supermemory MCP Server 提供跨對話的持久記憶。唯一穩定的整合方式是 stdio + mcp-remote + API Key 作為 --header 參數。
正確設定
claude mcp add-json supermemory-mcp '{"command":"npx","args":["-y","mcp-remote","https://mcp.supermemory.ai/mcp","--header","Authorization: Bearer sm_YOUR_API_KEY"]}' -s user
API Key 在 app.supermemory.ai 取得，以 sm_ 開頭。設定後必須重啟 Claude Code。
不可行的方式
- HTTP transport（
"type": "http"+headers）：連不上 - headers 放 stdio config 頂層（與
command/args同層）：不會傳給 mcp-remote，工具不載入 - OAuth（
--oauth=yes）：認證常失效，顯示 "Needs authentication"
疑難排解
| 症狀 | 解法 |
|---|---|
| "Needs authentication" | 改用 API Key + mcp-remote |
| 工具未載入 | 確認 --header 在 args 陣列內，非頂層 headers 欄位 |
| "Failed to connect" | 改用 stdio（非 HTTP transport） |
| 舊設定覆蓋 | 清理專案層級 .claude.json 的 mcpServers |
| 設定後沒工具 | 重啟 Claude Code |
可用工具
- memory：
content（必填）、action（save/forget）、containerTag（專案分類） - recall：
query（必填）、includeProfile（預設 true）、containerTag - whoAmI：無參數，回傳用戶資訊
- listProjects：無參數，列出記憶專案
驗證
claude mcp list
# 預期：supermemory-mcp: npx -y mcp-remote ... - ✓ Connected
重啟後測試 whoAmI 確認工具載入。