MarkIt

MarkIt MCP - 将 AI 连接到你的资料库

自带 AI。记忆交给 MarkIt。

提示

**最省事的方法（推荐）：**将此仓库的 URL 粘贴到你的 AI 中，并说 “帮我连接到 MarkIt”。它会读取 llms.txt，并为你完成下文的所有操作。

MarkIt 可以保存你原本会弄丢的链接、帖子和笔记，并支持用日常语言搜索。本仓库是官方指南，介绍如何通过开放的 Model Context Protocol，将你自己的 AI（Claude、ChatGPT、Cursor 等）连接到 MarkIt 资料库。

连接后，你的 AI 可以搜索资料库、阅读搜索结果、保存新内容，还能设置提醒。用你自己的话，而不是关键词。

Server URL:  https://mark-it.co/api/mcp
Transport:   Streamable HTTP
Auth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)

---

选择连接方式

选项 1 - 登录（OAuth）。 无需管理密钥。仅适用于 Claude、ChatGPT 网页版和 Claude Code：MarkIt 会拒绝来自其他应用的登录，因此外观相似的应用无法诱骗你登录。

选项 2 - API 密钥。 在 Settings > Integrations 中生成密钥（仅显示一次，请妥善保管）。适用于其他所有应用：Cursor、VS Code、Codex CLI、Windsurf、Cline、Zed、脚本和 ChatGPT 桌面应用。

---

选项 1 - 在应用中登录

应用	步骤
Claude（claude.ai + Claude Desktop）	Settings > Connectors（位于 Customize 下）> Add custom connector > 粘贴 https://mark-it.co/api/mcp > Connect > 登录 MarkIt > Allow。所有套餐均可使用（Free 套餐允许添加一个自定义连接器）。
ChatGPT（网页版）	chatgpt.com/plugins > + > Add custom MCP server。**图标：**上传 MarkIt 图标（可选，可让插件列表显示 MarkIt 徽标，而不是拼图图标）。名称：MarkIt。服务 URL：https://mark-it.co/api/mcp。**身份验证：**OAuth。勾选 I understand and want to continue > Create as a plugin > 登录 MarkIt > Allow。
Claude Code	运行 claude mcp add --transport http markit https://mark-it.co/api/mcp，然后在会话中运行 /mcp 并选择 Authenticate。添加 --scope user 可在每个项目中使用。

其他任何应用：请使用选项 2。

选项 2 - 使用 API 密钥

1. 在 MarkIt Settings > Integrations 中，打开 Connect Your AI 并生成密钥。密钥以 mkt_ 开头，且仅显示一次。
2. 从 clients/ 获取你的应用配置，并替换 mkt_your_key_here：

应用	配置
Claude Code	clients/claude-code.md
Cursor	clients/cursor.json
VS Code	clients/vscode.json
Codex CLI + ChatGPT 桌面应用	clients/codex.toml（它们共用 ~/.codex/config.toml）
Windsurf	clients/windsurf.json
Cline	clients/cline.json
Zed	clients/zed.json
仅支持 stdio 的应用	clients/mcp-remote.json

密钥使用规则：每个账户一个密钥，将其视为密码，切勿粘贴到聊天中；可随时在 Settings 中撤销或重新生成。

AI 能获得什么

工具	功能
search	使用自然语言搜索你的资料库，并可按类别、平台、类型、作者、标签和日期筛选。
fetch	根据 ID 获取一项内容的完整存储内容。
list_categories	查看你的类别及各类别的项目数量。
save_item	将 URL 或文本笔记保存到你的资料库。MarkIt 会抓取、分类并编入索引。每次保存会消耗一个月度抓取额度；重复保存已有的 URL 不会消耗额度，也不会执行任何操作。
create_reminder	为某个项目设置或重新安排提醒（所有用户都可通过电子邮件接收；Pro 用户还可使用 WhatsApp/Telegram）。
list_reminders	查看待处理的提醒。
cancel_reminder	根据 ID 取消一条提醒。不会触及项目本身；与 Google-Calendar 同步的提醒仍由网站管理。
send_feedback	仅在你要求时，向 MarkIt 的创始人直接发送简短留言。每条留言都会由真人阅读。每天最多 3 条。

根据设计，它无法执行以下操作：删除项目、修改你的账户、访问其他人的数据。保存的页面内容会被视为数据，而非指令。

一句话了解隐私

你的 AI 使用你的身份与 MarkIt 通信，并且只能看到你的项目。你连接的任何 AI（Claude、ChatGPT 等）都是你在其自身条款下使用的工具——MarkIt 不会主动将你的资料库发送到任何地方。OAuth 授权可在你的 AI 应用中撤销；API 密钥可在设置中撤销。详情请见：隐私政策。

故障排除

• 使用密钥连接后立即出现 401：请求头必须严格为 Authorization: Bearer mkt_...——请检查是否漏了空格或密钥被截断（在设置中重新生成密钥会使旧密钥失效）。
• Windsurf：远程服务字段应为 serverUrl，而非 url。
• Cline：请明确设置 "type": "streamableHttp"。
• VS Code 提示无法启动服务：包含 url 的条目还需要 "type": "http"。
• 批准后 Claude 立即提示“Authorization with MarkIt failed”：请重试一次。如果再次失败，请使用 Claude Code（选项 1）或任何支持 API 密钥的应用（选项 2）。较早的 Anthropic 端错误曾导致此问题；我们在 2026-10-21 的测试中，claude.ai 登录已恢复正常。
• 提示“This app is not supported. Use an API key instead.”：登录仅支持 Claude、ChatGPT 网页版和 Claude Code。请使用 API 密钥（选项 2）。
• 登录窗口一直没有返回：请在它打开的浏览器标签页中完成登录，然后从应用中重试；有些应用需要在首次授权后重试。
• mcp-remote 垫片：请保持为最新版本（mcp-remote@latest；早于 0.1.16 的版本存在已知的严重漏洞）。在 Windows 上，Authorization:${AUTH_HEADER} 中的冒号两侧不要加空格。
• 仍未解决？请联系 [email protected]。

供 AI 使用

将助手指向 llms.txt——这是一份纯文本使用指南，可指导它连接你的账户并妥善使用这些工具。同一文件也有品牌网址：mark-it.co/mcp/llms.txt。

Claude Code 用户还可以更进一步：将 skill/ 文件夹复制到 .claude/skills/markit/，Claude 就会自动获取完整的 MarkIt 使用指南（包括何时搜索或保存、笔记规范以及提醒处理方式）。

许可证

MIT。MarkIt 名称和徽标归 MarkIt 所有。