# memory_add

> 显式保存一条记忆。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_add

> 显式保存一条记忆。内容必填；kind 和 tags 由调用方定义，可选。不做自动摘要或分类。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/memory/memory_add.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | Core (`core`) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定：显式的 `project` → 请求头 → 凭据默认项目 → 工作区默认项目 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `content` | 是 | `string` | 记忆文本，最多 4096 字节，例如 'Reddit r/SaaS ignores self-promo; reply with help first.' |
| `kind` | 否 | `string \| null` | 你自己定义的可选分类，例如 'insight'、'decision'、'customer'。 |
| `tags` | 否 | `string[]` | 用于过滤的可选标签，例如 ['reddit', 'pricing']。默认没有。 |
| `project` | 否 | `string` | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |

## 示例调用

```json
{
  "content": "Reddit r/SaaS ignores self-promo; reply with help first.",
  "kind": "insight",
  "tags": [
    "reddit",
    "rules"
  ]
}
```

REST:`POST https://service.opennomos.com/v1/tools/memory_add`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "memory_add"`，以上 JSON 作为 `arguments`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "project": {
    "id": "prj_k3Vd9aQx2",
    "slug": "acme-crm"
  },
  "memory": {
    "id": "mem_Zr81nQw3",
    "kind": "insight",
    "content": "Reddit r/SaaS ignores self-promo; reply with help first.",
    "tags": [
      "reddit",
      "rules"
    ],
    "source": "Claude Code",
    "created_at": "2026-10-16T09:00:00.000Z",
    "updated_at": "2026-10-16T09:00:00.000Z"
  }
}
```

## 说明

- 记忆是**显式**的：不调用它就什么都不会保存。没有自动摘要、分类或置信度，`kind` 也没有固定的取值列表。
- 内容上限 4096 字节（UTF-8，所以大约 1,300 个汉字）。长清单请拆成多条，或者把人和帖子作为[机会](https://mcp-docs.opennomos.com/zh/docs/growth-loop/memory-vs-opportunity.md)来登记。
- 写入按工作区限流（每分钟 60 次，按服务实例计）。

## 错误

被拒绝的调用（输入有误、id 未知、触发限流）返回 `message` 和 `code`；走 MCP 时结果带 `isError: true`。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。