通过MCP接入记忆管理

通过控制台快速接入

1. 打开 Qoder Settings。macOS 按Shift+Command+,，Windows 按Ctrl+Shift+,。

2. 导航至MCP 服务 > 我的服务 > + 添加。

3. 选择通过配置添加，粘贴以下 JSON。控制台粘贴的是单个服务片段，不含mcpServers外层。

   {
     "mem0": {
       "type": "http",
       "url": "http://<host>:<port>/mcp",
       "headers": {
         "Authorization": "Token ${MEM0_API_KEY:-apikey}"
       }
     }
   }

4. 在项目根目录的.env文件中设置 API Key。

   MEM0_API_KEY=<API_KEY>

通过配置文件接入

Qoder 支持三种作用域的配置文件，其路径与推荐用途如下：

• 团队共享时使用项目级（共享）作用域，在项目根目录创建.mcp.json：

  {
    "mcpServers": {
      "mem0": {
        "type": "http",
        "url": "http://<host>:<port>/mcp",
        "headers": {
          "Authorization": "Token ${MEM0_API_KEY:-apikey}"
        }
      }
    }
  }

• 个人使用且需要直接写入密钥时，使用项目级（本地）作用域，在.qoder/settings.local.json中填入实际 API Key 并且不提交 Git：

  {
    "mcpServers": {
      "mem0": {
        "type": "http",
        "url": "http://<host>:<port>/mcp",
        "headers": {
          "Authorization": "Token <API_KEY>"
        }
      }
    }
  }

命令行快速添加

1. 在终端执行以下命令，一行完成 MCP 服务注册：

   claude mcp add --transport http mem0 http://<host>:<port>/mcp \
     --header "Authorization: Token <API_KEY>"

2. 验证服务是否添加成功：

   claude mcp list

   进入 Claude Code 交互界面后，输入/mcp可查看连接状态。

项目级配置文件（推荐团队使用）

1. 在项目根目录创建.mcp.json文件并提交到 Git，即可实现团队共享：

   {
     "mcpServers": {
       "mem0": {
         "type": "http",
         "url": "http://<host>:<port>/mcp",
         "headers": {
           "Authorization": "Token ${MEM0_API_KEY:-apikey}"
         }
       }
     }
   }

2. 在终端设置环境变量：

   export MEM0_API_KEY="<API_KEY>"

用户级配置（跨项目生效）

如需让所有项目都能访问PolarDB 记忆管理，使用用户级作用域：

claude mcp add --transport http mem0 --scope user \
  http://<host>:<port>/mcp \
  --header "Authorization: Token <API_KEY>"

命令行快速添加

1. 将完整的认证头值存入环境变量。

   export MEM0_AUTH_HEADER="Token <API_KEY>"

2. 添加 MCP 服务并验证。

   codex mcp add mem0 --url http://<host>:<port>/mcp
   codex mcp list

通过配置文件接入

Codex 使用 TOML 格式配置 MCP 服务，支持两种作用域：

1. 将完整的认证头值存入环境变量。

   export MEM0_AUTH_HEADER="Token <API_KEY>"

2. 编辑~/.codex/config.toml，添加以下配置。

   [mcp_servers.mem0]
   url = "http://<host>:<port>/mcp"
   env_http_headers = { Authorization = "MEM0_AUTH_HEADER" }

3. 验证服务是否添加成功。

   codex mcp list

交互式添加

1. 执行以下命令，通过交互式引导完成添加：

   hermes mcp add mem0 --url "http://<host>:<port>/mcp"

2. 命令会自动完成以下操作：

   • 提示输入 API Key，并保存到~/.hermes/.env。

   • 连接PolarDB 记忆管理服务端验证连接，并发现可用的 MCP 工具。

   • 将配置写入~/.hermes/config.yaml。

3. 启动 Hermes 即可使用：

   hermes

YAML 配置文件

1. 存放 API Key。

   echo 'MEM0_API_KEY=<API_KEY>' >> ~/.hermes/.env

2. 编辑~/.hermes/config.yaml。

   mcp_servers:
     mem0:
       url: "http://<host>:<port>/mcp"
       headers:
         Authorization: "Token ${MEM0_API_KEY}"
       timeout: 180
       connect_timeout: 60

3. 验证连接。

   hermes mcp test mem0

管理命令

（可选）高级配置

如需自定义超时时间、心跳保活、工具过滤或采样能力，可参考以下配置。其中tools.include填写的是 MCP 工具名，取值见常用 MCP 工具参考。

mcp_servers:
  mem0:
    url: "http://<host>:<port>/mcp"
    headers:
      Authorization: "Token ${MEM0_API_KEY}"
    timeout: 180
    connect_timeout: 60
    keepalive_interval: 60    # 心跳保活间隔，单位为秒
    tools:
      include: ["add_memory_v1_memories_post", "search_memories_v2_memories_search_post", "get_all_memories_v2_memories_post"]
    sampling:
      enabled: true
      model: "gpt-4"
      max_tokens_cap: 4096

通过API接入

前三步为一次性配置，Vault与Agent均可被多个Session复用。之后每次开会话只需执行第4步。

1. 创建Vault。

   curl -X POST https://api.qoder.com/api/v1/cloud/vaults \
   -H "Authorization: Bearer $QODER_PAT" \
   -H "Content-Type: application/json" \
   -d '{"display_name": "PolarDB Memory"}'
   

2. 向Vault追加凭证。mcp_server_url 必须与下一步的 mcp_servers[].url 完全一致（含末尾斜杠），平台按该URL精确匹配凭证。

   curl -X POST https://api.qoder.com/api/v1/cloud/vaults/<vault_id>/credentials \
   -H "Authorization: Bearer $QODER_PAT" \
   -H "Content-Type: application/json" \
   -d '{
     "auth": {
       "type": "static_bearer",
       "mcp_server_url": "http://<host>:<port>/mcp",
       "token": "<API_KEY>"
     }
   }'
   

3. 创建Agent，在 mcp_servers 中声明MCP端点。

   curl -X POST https://api.qoder.com/api/v1/cloud/agents \
   -H "Authorization: Bearer $QODER_PAT" \
   -H "Content-Type: application/json" \
   -d '{
     "name": "mem0-agent",
     "model": "ultimate",
     "system": "你可以使用mem0工具读写长期记忆。回答前先检索相关记忆。",
     "tools": [{"type": "agent_toolset_20260401", "enabled_tools": ["Bash", "Read", "Write"]}],
     "mcp_servers": [{"name": "mem0", "type": "url", "url": "http://<host>:<port>/mcp"}]
   }'
   

4. 创建Session时通过 vault_ids 关联Vault，平台会自动注入凭证。

   curl -X POST https://api.qoder.com/api/v1/cloud/sessions \
   -H "Authorization: Bearer $QODER_PAT" \
   -H "Content-Type: application/json" \
   -d '{
     "agent": "<agent_id>",
     "vault_ids": ["<vault_id>"]
   }'