MCP

通过 MCP 连接 AI 之后,它就获得了操作您知识层的十个工具。本页介绍每个工具的作用、 适用的上限,以及一次典型的使用流程。

连接之后能得到什么

Contextick 连上以后,您的 AI 就有了十个工具。您不用自己去调用它们——用平常的话提出要求,AI 会挑对 的那个。“这个先留着”会走保存,“定价页面我们当时怎么定的?”会走找回。

一切都限定在您的账户范围内。每个人都有自己的私有存储,而 AI 只在连接期间才够得着它。

一次典型的流程

  1. 保存下来。“记住这份迁移方案。”您的 AI 会把它整理成标题、一段自成一体的笔记和 一句简短摘要,然后调用 Save
  2. 找回来。几天后,在另一个对话里——也可能是另一个 AI——您说“用我们写的那份迁移 方案”。您的 AI 调用 Search,拿回意思最接近的若干条摘要。
  3. 读全文。要原样引用或修改,AI 会用该条目的 id 调用 Get。检索结果 是摘要,所以这是读到整篇笔记的唯一途径。
  4. 保存修订版。您的 AI 再次调用 Save,传的是整篇更新后的 笔记——是改动已经落进去的完整内容,不是只有改动的那部分。
  5. 收尾。只有在那次保存成功之后,才对旧 id 调用 Delete。先删会把 原件弄丢。

十个工具

Save

把值得回头查的东西留下来——一段代码、一个想法、一项设计或决定、一份报告、一些调研笔记。您的 AI 会 先整理成标题、一段自成一体的笔记和一句简短摘要,并且被要求忠实保留内容,而不是为了塞进去而删减。

输入:标题、笔记和摘要。

返回:新条目的 id,以及您总共存了多少。

把您先前保存的内容找回来。您的 AI 传入一个主题、一个问题或几个关键词,拿到的是意思最接近的条目—— 不只是和查询共用某个词的那些。

每条结果以摘要的形式返回,并附上保存时间、保存者,以及——对开始记录以来保存的内容——它来自 哪个 AI。最后这一点正是共享层的意义所在:您从 ChatGPT 保存的笔记,会带着来源出现在 Claude 里。

输入:要找回什么,以及可选的结果条数。

返回:id、标题、摘要、被打开过几次,以及它是怎么 保存的——何时、由谁、来自哪个 AI。

Get

把某一条保存的内容整篇打开。您的 AI 用它来原样引用一段笔记,或者在修改之前通读一遍。既然检索结果 是摘要,这就是够到全文的唯一途径。

Get 算写入,不算读取。打开一个条目会让它的打开次数加一,正是这一点让 Least openedMost 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 询问其中任何一项,它会先读取对应主题,因此答案来自当前契约而非猜测。

这就是你能在对话中问"笔记保存后怎么收到通知?"并得到可用答案的原因,无需离开去访问本站。

接受:一个主题——apiwebhooksupload

返回:该契约的全文——端点、负载、签名校验、重试 与错误码。密钥和签名密钥绝不在其中,只说明它们在哪个页面。

上限

对象上限超出之后
每次保存的笔记正文 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 决定,而不是由您决定。

无论哪条路,都是同一个账户、同一个私有存储——连上两个 AI,它们看到的是同一份知识。各自的分步指南在 连接指南里。

您的数据

您保存的内容会进入一个专属于您的数据库——不是和别人的笔记挤在一张共享表里。单个条目或整个数据库, 您随时可以在账户页面删除;断开某个 AI 的连接,它的访问权立即中止。完整细节见 我们的隐私政策

更多

要把已经存成文件的内容直接放进您的知识层,请看 文档上传。要从您自己的脚本保存,请看 REST API。常见问题的答案在 FAQ 里。套餐和上限在价格页。如果有不清楚 或者用不了的地方,联系我们——每一封来信都由真人阅读。