跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Zenkit，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 在 Zenkit 中工作：浏览工作区和集合，读取字段、条目、成员和动态，全局搜索，并在你确认后创建或更新条目、发表评论。
试试这样问
Zenkit 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Zenkit、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Zenkit + Gemini
让你的 AI 在 Zenkit 中工作：浏览工作区和集合，读取字段、条目、成员和动态，全局搜索，并在你确认后创建或更新条目、发表评论。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ZENKIT_API_KEY
步骤 1 — 获取凭证
设置大约需要 2 分钟，只需要你的 Zenkit 账号。
- 在 Zenkit 中点击头像打开个人资料，进入 Integrations。
- 在 API Key 下生成一个新密钥并复制。
- 把它单独粘贴到
ZENKIT_API_KEY，不要带空格或请求头名称。 - 安装连接器并运行
zenkit_get_current_user：它会显示密钥所属的用户。
密钥以你的身份操作：凡是你在 Zenkit 中能打开的内容，它在所有工作区里都能打开。生成新密钥会使旧密钥失效，连接器会停止工作，直到你粘贴新密钥。如果只想让 AI 看到部分工作区，请使用一个只加入这些工作区的单独 Zenkit 用户。
所有 Zenkit 应用共用一个 API：Zenkit Base、Zenkit To Do、Zenkit Projects 和 Hypernotes 共享同一份数据，所以同一个密钥可以访问你的待办清单、项目看板和数据库。
Zenkit 的结构：工作区包含集合（API 中称为列表），集合中有字段和条目。根据视图不同，条目可以是任务、卡片、表格行或笔记。AI 会先调用 zenkit_list_workspaces_with_lists，再用 zenkit_list_fields 读取集合的字段，然后每次 50 条地翻阅条目，或在你能访问的全部内容中按文本搜索。
可读取的内容：工作区及其成员，集合以及有权访问的人，带类型和标签选项的字段，包含所有字段值（标题、文本、数字、日期、复选框、标签、负责人和关联条目）的条目，以及单个条目或整个集合的评论和变更历史。
每次修改前都会询问：zenkit_create_entry 新增条目，zenkit_update_entry 修改字段值（对于标签、负责人和关联条目，可以替换、添加或移除值），zenkit_comment_on_entry 以你的名义发表评论。这些都是共享数据，关注该条目的人可能会收到通知，因此 AI 会先展示将要改变的内容，等你同意后再执行。公式字段以及创建时间、更新时间字段是只读的。
安装时关闭：zenkit_archive_entries。它会把条目移到归档中，之后可以在 Zenkit 应用里恢复。管理员可以有意识地开启它。没有任何工具会永久删除内容。
限制：Zenkit 允许每个用户每分钟 200 次请求，每个 IP 地址每分钟 500 次。AI 会优先读取一页筛选后的结果，而不是多次单条读取。出现错误 D2（Limit reached）时，需要等一分钟再重试。
常见错误：401 表示密钥错误或已被更新的密钥替换。403 表示你无权访问该工作区或集合。404 表示 ID 不存在。C21 表示 Zenkit 不接受某个参数或值，通常是该集合中不存在的字段键。
该连接器不会创建或修改工作区、集合或字段，不会上传文件，不会设置 Webhook，也不会恢复已归档的条目。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Gemini 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp（或在终端运行gemini mcp list），anythingmcp应显示为已连接。 - 开始输入提示，Gemini CLI 现在可以调用
Zenkit的工具。
可用工具
| Tool | What it does |
|---|---|
zenkit_get_current_user | Read the Zenkit user the API key belongs to: id, name, username, emails, locale and timezone |
zenkit_list_workspaces_with_lists | List every workspace the user can open, each with its collections (lists): ids, shortIds, uuids and names |
zenkit_get_workspace | Read one workspace with its name, description, settings and creation date |
zenkit_list_workspace_users | List the members of a workspace with user id, name and username |
zenkit_get_list | Read one collection (list) with its name, workspace, description and settings |
zenkit_list_list_users | List the users who have access to a collection (list), with user id, name and username |
zenkit_list_fields | List the fields (elements) of a collection: id, uuid, name, type (elementcategory), whether it is the primary title field, and for label… |
zenkit_filter_entries | List the entries (items) of a collection with all field values, page by page, optionally filtered |
zenkit_search_entries | Search entries by text across every workspace and collection the user can open |
zenkit_get_entry | Read one entry with all its field values, keyed by field uuid (for example <uuid>_text), plus displayString, comment count and dates |
zenkit_list_entry_activities | List the comments and change history of one entry, newest first, with total for paging |
zenkit_list_list_activities | List the comments and changes across a whole collection, newest first, with total for paging |
zenkit_create_entry | Create an entry (item) in a collection with the given field values |
zenkit_update_entry | Change field values of an entry |
zenkit_comment_on_entry | Post a comment on an entry as the API key's user |
zenkit_archive_entries | Delete entries of a collection by moving them to the archive (Zenkit's soft delete; they can be restored in the Zenkit app) |
示例提示
- “我们的 Marketing 集合里，本周到期的未完成任务有哪些？分别由谁负责？”
- “把‘更新价格页面’这个任务设为已完成，并加上 Website 标签。修改前先给我看。”
- “在 Bugs 集合中新建一个条目：Safari 中结账按钮无法使用，优先级高，分配给 Lisa。”
- “在我所有的 Zenkit 工作区中搜索提到王氏项目的条目。”
- “过去 7 天 Product Roadmap 集合里有哪些变化？谁评论了什么？”
FAQ
Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?
