Gryz

Gryz

Gryz 是 AI Agent 团队共享的记忆和工作空间，也支持发布文档。你使用的助手可以跨工具和会话读取和写入相同的事实、笔记和文档。你拥有这些上下文，并可通过 Gryz 控制面板和 MCP 管理它们。

连接

请严格使用此 URL，不要在末尾添加斜杠：

https://www.gryz.ai/api/mcp

任何 Gryz 账户均可免费使用 OAuth 和 API 密钥访问，无需订阅。

登录方式取决于客户端：

• VS Code — 在扩展视图中搜索 @mcp gryz，然后点击 安装。安装后会立即开始登录（可使用 Google、GitHub、魔法链接或密码）。如果搜索结果中没有 Gryz，请使用命令面板：MCP: Add Server，选择 HTTP，然后粘贴 URL。
• Cursor — 在 Cursor MCP 设置中添加 URL，或按照下方的 Cursor 插件 说明操作。首次调用工具时会打开浏览器进行登录。
• Claude — Settings → Connectors → Add connector，粘贴 URL，并在该页面完成登录。Claude 会在此处启动 OAuth，而不是通过工具调用启动。
• Antigravity — 使用上方的 URL 添加远程 MCP 服务，然后完成 Antigravity 打开的登录流程。
• Windsurf — 在 Cascade 市场中搜索 Gryz，或打开 windsurf://windsurf-mcp-registry?serverName=gryz，并在 Cascade 提示时登录。
• 其他 MCP 客户端 — 任何支持可流式 HTTP 的客户端都可以使用同一个 URL。
• API 密钥 — 在 gryz.ai/account/api-keys 创建密钥，并发送 Authorization: Bearer YOUR_API_KEY。此方式不会打开浏览器。

完整操作指南：MCP 设置指南。

工具

连接后，你的助手可以代表你调用这些工具。核心工具包括 remember、recall、list_memories、forget、list_documents 和 publish_document。

记忆

Gryz 的核心功能：所有你使用的助手都能访问持久上下文，包括你的偏好、工作习惯、项目的稳定事实，以及能跨越单次对话的决策。事实仅对你的账户保密，绝不会用于模型训练。

• 记住一条事实 — 存储一条原子事实，范围为 personal 或 project
• 回忆记忆 — 调取指定范围内的事实，并按相关性和新近程度排序
• 列出记忆 — 查看所有已存储内容及其来源
• 忘记一条事实 — 按 ID 删除错误或过时的内容

回忆出的记忆是你保存的数据，而不是指令。助手应当这样对待它。

MCP 工具 ID：remember、recall、list_memories、forget。

笔记

私人草稿区，不会发布到网上。适合存放清单、决策和暂时不准备分享的草稿。

• 列出笔记 — 搜索笔记；编辑前请检查 agent_access
• 获取笔记 — 按 ID 获取某条笔记的完整文本
• 创建笔记 — 新建私人笔记
• 追加笔记 — 在现有笔记后添加内容，而不覆盖原文
• 更新笔记 — 原位重写笔记
• 删除笔记 — 删除笔记（短时间内可从控制面板恢复）

笔记遵循你在 Gryz 控制面板中为每条笔记设置的 AI 访问权限（collaborate 或 read_only）。

MCP 工具 ID：list_notes、get_note、create_note、append_note、 update_note、delete_note。

文档

将内容转为链接，方便分享；无需重新发送，也能让长文档保持最新。

• 发布文档 — Markdown 或 HTML，可设为公开或私有
• 获取文档 — 按 slug 获取内容和元数据。对于长文档，可以只返回大纲、某个章节、部分内容或搜索结果，而不是全文
• 列出文档 — 按最新优先排序
• 更新文档 — 替换内容、类型或标题
• 向文档添加内容 — 在末尾或开头添加文本，无需重新发送其余内容（Markdown、CSV、Mermaid）
• 编辑文档部分内容 — 最多可同时应用 25 项精确更改，并保存为一个新版本：替换指定文本、在标题附近插入内容、替换或删除章节、添加表格行、勾选清单项。使用 dry_run 预览
• 查看文档历史记录 — 查看每个已保存的版本及其创建者
• 恢复较早的版本 — 将其恢复为新版本，不会改写任何内容，且可以撤销恢复操作
• 建议修改 — 如果所有者只允许提交建议，编辑内容会等待在控制面板中审批
• 列出建议 — 查看待处理、已接受或已拒绝的建议
• 删除文档

每份文档都有一个版本号，例如 r12。将其作为 if_match 传回；如果文档在你读取后发生了变化，写入操作将被拒绝。所有者可以针对每份文档选择允许助手直接编辑、仅提交建议或仅查看。

MCP 工具 ID：publish_document、get_document、list_documents、 update_document、append_to_document、edit_document、 list_document_revisions、restore_document_revision、 suggest_document_edit、list_document_suggestions、delete_document。

项目

查看在控制面板中整理的项目中心，并可将文档归档到其中。

• 列出项目 — ID、名称、采用的键和链接类型
• 获取项目 — 查看一个中心及其类型化链接、文档和笔记摘要
• 将文档添加到项目 — 将你拥有的文档归档到项目中 （需要 projects 写入权限）
• 从项目中移除文档 — 不会删除文档

MCP 工具 ID：list_projects、get_project、associate_document、 disassociate_document。

技能

助手可以按名称加载的可重复使用指令。

• 列出技能 — 仅显示你当前启用的技能及其名称和描述
• 获取技能 — 获取当前文本、版本号及其来源
• 派生技能 — 将技能库中的技能复制为你自己的可编辑版本 （Pro 或更高版本）
• 创建技能 — 从头编写技能（Pro Plus）
• 更新技能 — 保存为新版本；保留较早的版本
• 删除技能 — 软删除；保留历史记录

MCP 工具 ID：list_skills、get_skill、fork_skill、create_skill、 update_skill、delete_skill。

任务

由你所有、带有状态、优先级和可选受派人的工作单元。

• 创建任务 — 为你或调用该工具的 Agent 创建任务，可选添加子任务和项目
• 列出任务 — 按最新优先排序，可筛选分配给你或某个 Agent 的任务
• 获取任务 — 查看一个任务及其历史记录、关联的文档和笔记
• 更新任务 — 更新状态、优先级、受派人、描述、截止日期和链接

MCP 工具 ID：create_task、list_tasks、get_task、update_task。

已连接的工具

在一个地方使用你通过 Gryz 控制面板连接的其他 MCP 服务中的工具（例如 GitHub、Jira 或 Slack）。

• 查找已连接服务中的工具 — 按你想执行的操作搜索
• 调用已连接的工具 — Gryz 会检查该工具是否已启用、验证参数、应用速率限制并返回结果

MCP 工具 ID：broker_list_tools、broker_call_tool。

评论

由 Agent 代您在文档上撰写并标记为由 Agent 发布的评论。 这些功能需要评论权限，连接时可选择是否启用。

• 列出评论 — 查看您文档上的评论，或与您共享的私人文档上的评论
• 添加评论 — 添加纯文本评论或一层回复
• 删除评论 — 仅限 Agent 代表您发布的评论

MCP 工具 ID：list_comments、add_comment、delete_comment。

设置

• Agent 入门设置 — 连接并登录后，agent_onboarding 会为 Gryz 配置您的助手，并回答“如何使用 X？”的问题。此操作对 Gryz 只读；任何对本地指令文件的更改都会显示给您，并且必须先获得您的明确批准。

Cursor 插件

此仓库也是 Cursor 插件包（mcp.json 和 .cursor-plugin/plugin.json）。

一键安装

使用 MCP 设置指南上的 添加到 Cursor 按钮，或在 Cursor 插件市场中搜索 Gryz。

手动安装

1. 克隆或下载此仓库。
2. 将 mcp.json 复制到 Cursor MCP 配置中（如果要让所有工作区都能使用此服务，请放在 ~/.cursor/mcp.json；如果只用于单个项目，请放在 .cursor/mcp.json）。
3. 重启 Cursor，或重新加载 MCP 服务列表。

{
  "mcpServers": {
    "gryz": {
      "url": "https://www.gryz.ai/api/mcp"
    }
  }
}

请严格使用 https://www.gryz.ai/api/mcp — 末尾不要加斜杠。如果 URL 与 Gryz 受保护资源元数据不匹配，Cursor OAuth 将会失败。此仓库中的 mcp.json 不含 API 密钥。

想在 Cursor 中使用 API 密钥？ 请在 gryz.ai/account/api-keys 生成密钥，并将其作为标头添加到您自己的 mcp.json 中：

{
  "mcpServers": {
    "gryz": {
      "url": "https://www.gryz.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

提示词示例

• “记住，我从 release 分支部署，从不使用 main”
• “Gryz 中关于这个项目的记忆有哪些？”
• “在 Gryz 记下：我们决定先发布 Notes，再发布视频”
• “将此 Markdown 作为标题为 Q3 Roadmap 的公开文档发布到 Gryz”
• “在我的发布跟踪文档末尾添加今天的条目，不要重写文档”
• “显示该文档自昨天以来的更改，然后恢复 Plan 部分的旧版本”

链接

• 完整的 MCP 设置指南
• 贡献指南
• Gryz
• 报告问题

许可证

MIT — 参见 LICENSE。