MCP
通过 MCP 连接 AI 之后,它就获得了操作您知识层的十个工具。本页介绍每个工具的作用、 适用的上限,以及一次典型的使用流程。
连接之后能得到什么
Contextick 连上以后,您的 AI 就有了十个工具。您不用自己去调用它们——用平常的话提出要求,AI 会挑对 的那个。“这个先留着”会走保存,“定价页面我们当时怎么定的?”会走找回。
一切都限定在您的账户范围内。每个人都有自己的私有存储,而 AI 只在连接期间才够得着它。
一次典型的流程
- 保存下来。“记住这份迁移方案。”您的 AI 会把它整理成标题、一段自成一体的笔记和 一句简短摘要,然后调用 Save。
- 找回来。几天后,在另一个对话里——也可能是另一个 AI——您说“用我们写的那份迁移 方案”。您的 AI 调用 Search,拿回意思最接近的若干条摘要。
- 读全文。要原样引用或修改,AI 会用该条目的 id 调用 Get。检索结果 是摘要,所以这是读到整篇笔记的唯一途径。
- 保存修订版。您的 AI 再次调用 Save,传的是整篇更新后的 笔记——是改动已经落进去的完整内容,不是只有改动的那部分。
- 收尾。只有在那次保存成功之后,才对旧 id 调用 Delete。先删会把 原件弄丢。
十个工具
Save
把值得回头查的东西留下来——一段代码、一个想法、一项设计或决定、一份报告、一些调研笔记。您的 AI 会 先整理成标题、一段自成一体的笔记和一句简短摘要,并且被要求忠实保留内容,而不是为了塞进去而删减。
输入:标题、笔记和摘要。
返回:新条目的 id,以及您总共存了多少。
Search
把您先前保存的内容找回来。您的 AI 传入一个主题、一个问题或几个关键词,拿到的是意思最接近的条目—— 不只是和查询共用某个词的那些。
每条结果以摘要的形式返回,并附上保存时间、保存者,以及——对开始记录以来保存的内容——它来自 哪个 AI。最后这一点正是共享层的意义所在:您从 ChatGPT 保存的笔记,会带着来源出现在 Claude 里。
输入:要找回什么,以及可选的结果条数。
返回:id、标题、摘要、被打开过几次,以及它是怎么 保存的——何时、由谁、来自哪个 AI。
Get
把某一条保存的内容整篇打开。您的 AI 用它来原样引用一段笔记,或者在修改之前通读一遍。既然检索结果 是摘要,这就是够到全文的唯一途径。
Get 算写入,不算读取。打开一个条目会让它的打开次数加一,正是这一点让 Least opened 和 Most opened 有了意义。因为这个工具如实把自己申报为 写入而不是读取,所以在那些写入前会请您确认的 AI 客户端里,Get 也在确认之列。(包括 ChatGPT 在内的 一些客户端,连保存之前也会确认。)除了次数,没有任何东西被改动。
输入:一个 id。
返回:该条目的全文。
Delete
按 id 删除保存的条目——一次一条或多条。这是永久的、无法撤销,所以工具会让您的 AI 先和您确认要删 哪些,再动手。当它要用修订版替换某个条目时,被要求先保存新的,成功之后才删掉旧 id。
输入:一个或多个 id。
返回:删掉了什么、哪些没找到,以及之后的存储总量。
Usage
回答“我到底存了多少”——您知识层里的条目数,以及它们占用的总空间。
输入:无。
返回:条目数和以字节计的总大小。
Least opened
按全文被打开的次数从少到多列出保存的条目——用来看看哪些一直静静躺着。它只排序,不筛选: 如果您存了五条而这五条都被频繁打开,它照样把这五条返回。每条都带着它真实的打开次数。
这个次数只统计全文打开。它只在 Get 运行时增加,别的 都不会。如果您的 AI 在 Search 摘要里就找到了需要的内容并据此作答,它没有调用 Get, 那么这条即使发挥了作用,次数也还是零。次数低不等于没用;一句写得好的摘要,能让一个条目在无人打开的 情况下持续有用。请把这份列表和标题、保存时间放在一起看,别把数字当成全部。
输入:可选的列出条数。
返回:id、标题、打开次数、Search 是否已经能找到它,以及每条是怎么保存的——何时、由谁、来自哪个 AI。为了让列表轻一些,这里不带摘要;摘要在 Search 那边。
Most opened
同一份列表,从另一头看——那些您反复回头去读全文的条目。它们是 AI 为了引用或修改而需要细读的内容, 所以往往正是您真正倚重的笔记。不过反过来并不成立:不在这份列表里的条目,也可能只是靠摘要就够用了。
输入:可选的列出条数。
返回:与 Least opened 相同的字段, 按打开次数反向排序。
Changes
列出某个时间点之后保存的内容,而不是某条笔记讲了什么——“周一以来我加了些什么?”。您的 AI 在第一次 调用时给出日期和时间,然后沿着拿到的游标继续往下读。
结果始终从旧到新,而且只涵盖新增:您后来删掉的条目不会出现,处理完成的条目也不会再出现一次。如果 希望事情发生时您自己的系统就被告知,而不是靠询问,webhook 会把这些事件 推送到您自己的端点。
输入:起始时间或游标,以及可选的条数。
返回:每个条目的 id、标题和摘要,保存的时间和 来源,是否已经可以搜索,以及一个用于继续的游标。
Get group
列出您上传的某个文件的各个部分。从面板上传的文档会按编号存成若干部分,凡是从中来的条目都带着同一个 分组标签——所以当搜索命中一份报告的第 3 部分时,AI 就靠它把其余部分拿给您看。
文件标题只在整组上给一次,各部分以 id 和状态返回,因此一次大上传目前有多少已经可搜索,一眼就能看出。 列出并不等于打开,所以不会影响它们被打开的次数。
接收:分组标签——只要条目来自上传,其他工具都会一并 返回它。
返回:文件标题、共有多少部分以及其中可搜索、 处理中、失败各多少,还有每个部分的 id 和状态。
Delete group
一次忘掉整个上传的文件,而不是您当时正看着的那一部分。带该分组标签的部分会一起消失,所以 77 个部分的 PDF 不必一片片删。
删除是永久的、无法撤销,而且要么全删要么不删——中途中断不会留下删了一半的文件。您直接保存的笔记, 以及其他上传的部分,标签不同,不受影响。
接收:分组标签。
返回:删掉了哪些部分,以及之后您还存着多少。
Help
把此处任何工具都不做的三件事——HTTP API、出站 webhook、放入文件——的完整契约交给你的 AI。向你的 AI 询问其中任何一项,它会先读取对应主题,因此答案来自当前契约而非猜测。
这就是你能在对话中问"笔记保存后怎么收到通知?"并得到可用答案的原因,无需离开去访问本站。
接受:一个主题——api、
webhooks 或 upload。
返回:该契约的全文——端点、负载、签名校验、重试 与错误码。密钥和签名密钥绝不在其中,只说明它们在哪个页面。
上限
| 对象 | 上限 | 超出之后 |
|---|---|---|
| 每次保存的笔记正文 | 16,000 字符 | 拒绝——您的 AI 会拆成若干完整的部分分别保存,所以不会丢东西 |
| 标题 | 120 字符 | 截断并加省略号 |
| 摘要 | 300 字符 | 截断并加省略号 |
| 检索结果条数 | 1–10(默认 5) | 拉回范围内 |
| Least/Most opened 条数 | 1–20(默认 10) | 拒绝 |
| Changes 条数 | 1–100(默认 50) | 拒绝 |
| Search、Least opened、Most opened、按时间开始的 Changes——每小时 / 每天 | 60 / 300 (Free) · 60 / 600 (Pro) | 在窗口重置之前会被拒绝;错误会告诉您还要等多久 |
| Save——每小时 / 每天 | 60 / 300 (Free) · 200 / 1,000 (Pro) | 在窗口重置之前会被拒绝;已经保存的内容不受影响 |
| Get、Usage、Delete、Get group、Delete group、按游标继续的 Changes——每小时 | 600 | 在这个小时重置之前会被拒绝 |
| Free 套餐的存储空间 | 5 MB——数百页 | 在腾出空间之前,保存会被拒绝 |
标题、摘要和笔记正文都不能留空——留空会被拒绝,而不是由系统猜着填上。Free 套餐包含什么,请看 价格。
连接方式
入口有两个,用哪一个由您连接的那个 AI 决定,而不是由您决定。
- 登录(OAuth)。您在浏览器里登录来批准连接——没有要复制的 API 密钥。在聊天应用里, 您在它的设置中把 Contextick 添加为连接器;在 Claude Code 或 Codex CLI 里,则是执行一次登录命令。 Claude、ChatGPT、Replit、Claude Code 和 Codex CLI 走的是这条路。
- API 密钥。把 Contextick 的端点和一个
Authorization请求头写进工具的 MCP 配置文件。密钥在您的账户页面签发。Cursor 和 Devin(原 Windsurf)走的是这条路。
无论哪条路,都是同一个账户、同一个私有存储——连上两个 AI,它们看到的是同一份知识。各自的分步指南在 连接指南里。
您的数据
您保存的内容会进入一个专属于您的数据库——不是和别人的笔记挤在一张共享表里。单个条目或整个数据库, 您随时可以在账户页面删除;断开某个 AI 的连接,它的访问权立即中止。完整细节见 我们的隐私政策。
更多
要把已经存成文件的内容直接放进您的知识层,请看 文档上传。要从您自己的脚本保存,请看 REST API。常见问题的答案在 FAQ 里。套餐和上限在价格页。如果有不清楚 或者用不了的地方,联系我们——每一封来信都由真人阅读。