连接你的 AI

开启本地 MCP 后，你电脑上的 AI 助手（例如 Claude、Codex、Cursor）可以搜索你允许的大千卡片，并在自己的空间里记笔记。数据只在你电脑上的浏览器和 AI 之间传递。

一分钟设置好

1. 如果还没有 Node.js，先安装 18 或更高版本（nodejs.org，选 LTS）。
2. 在大千里打开设置 → AI 连接，开启本地 MCP，浏览器询问时点“允许”。
3. 填写 AI 名称，例如 Claude，点连接 AI。
4. 复制那段话发给你的 AI。它会下载一个小助手、完成注册，并把大千加到自己的 MCP 里。
5. 保持浏览器开着。设置里的状态会显示小助手是否已连上。

那段话里有只属于这个 AI 的令牌，只显示一次。AI 会按照这份写给 Agent 的说明一步步完成设置。

AI 能做什么

主动权在你

• 在你为它打开可以读我的卡片之前，Agent 只能看到自己的空间。
• 上锁的卡片永远不会交给 Agent，它只知道有这么一张卡片。
• Agent 只能修改或删除自己写的卡片，你会看到它们显示为 Agent 卡。
• 换新令牌会替换 Agent 的令牌；移除会切断它，并把它的卡片移到回收站。
• 大千只保存令牌的哈希值，数据不经过我们的服务器。

手动设置

想自己动手？下载 uni3k-mcp.mjs（一个文件，没有依赖，可以先读一遍）并注册。macOS 或 Linux：

mkdir -p "$HOME/.uni3k/mcp"
curl -fsSL https://uni3k.com/uni3k-mcp.mjs -o "$HOME/.uni3k/mcp/uni3k-mcp.mjs"
node "$HOME/.uni3k/mcp/uni3k-mcp.mjs" install

Windows（PowerShell）：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.uni3k\mcp" | Out-Null
Invoke-WebRequest https://uni3k.com/uni3k-mcp.mjs -OutFile "$env:USERPROFILE\.uni3k\mcp\uni3k-mcp.mjs"
node "$env:USERPROFILE\.uni3k\mcp\uni3k-mcp.mjs" install

然后在设置里点“连接 AI”，展开手动设置，把设置粘贴到你的 AI 里，大致是这样：

{
  "mcpServers": {
    "uni3k": {
      "command": "node",
      "args": ["/Users/you/.uni3k/mcp/uni3k-mcp.mjs"],
      "env": { "UNI3K_TOKEN": "u3k_…" }
    }
  }
}

在 Claude Code 里，一条命令就行：

claude mcp add uni3k --scope user --env UNI3K_TOKEN=u3k_… -- node "$HOME/.uni3k/mcp/uni3k-mcp.mjs"

配置文件里请写主目录的完整路径，那里不会展开 ~ 和 $HOME。要卸载小助手，用 uninstall 运行一次。

连不上怎么办