如何让你的 AI 助手(ChatGPT/Claude/通义千问)接入个人知识库
傻瓜式教程:让 ChatGPT、Claude、通义千问等 AI 助手通过 MCP 协议接入个人知识库。ChatGPT 支持 OAuth 自动授权,无需 API Key。
你的 AI 助手有一个致命的缺陷
你有没有这样的体验?
跟 Claude 聊得热火朝天,突然需要引用上周自己整理的一份技术方案。于是你切到笔记应用,搜索,找到,复制,粘贴回对话框。
或者更痛苦的:你让 AI 帮你分析一个问题,但它完全不知道你之前踩过的坑、做过的决策、积累的经验。每次都像跟一个失忆的天才对话。
问题的根源很简单:你的 AI 助手不知道你知道什么。
它有全世界的知识,却唯独没有你的知识。你的经验、你的笔记、你的洞察——对它来说都是一片空白。
解决方案:通过 MCP 让 AI 接入你的知识库
MCP(Model Context Protocol)是 Anthropic 推出的开放协议,让 AI 能直接读写外部数据源。KnowMine 提供了完整的 MCP Server,你的 AI 助手可以通过它:
- 搜索你的知识 —— "帮我找一下之前关于 K8s 排错的笔记"
- 保存新知识 —— "这个解决方案很有用,帮我存起来"
- 发现关联 —— "这个问题跟我之前记录的哪些知识有关?"
- 获取洞察 —— "根据我的知识库,总结一下我在微服务领域的经验"
整个配置过程只需要 3-5 分钟。
两种认证方式,按平台选择
KnowMine MCP Server 同时支持两种认证方式:
| 认证方式 | 使用平台 | 操作方式 |
|---|---|---|
| OAuth 自动授权 | ChatGPT | 填 URL → 登录 → 点授权,完成 |
| API Key | Claude / Cursor / 通义千问 / 其他 | 创建 Key → 粘贴到配置中 |
ChatGPT 用户直接跳到 ChatGPT 配置,其他平台请先完成前两步。
第一步:注册 KnowMine 账号
访问 knowmine.ai 免费注册一个账号。
注册后,你就拥有了一个个人知识库。你可以先随便添加几条知识,也可以配置好 AI 助手之后直接通过对话来添加。
第二步:创建 API Key(ChatGPT 用户跳过此步)
- 登录 KnowMine 后,点击左侧菜单的 「设置」
- 找到 「MCP 连接」 选项卡
- 点击 「创建 API Key」
- 给这个 Key 起个名字(比如"我的 Claude"),然后复制生成的 Key
注意:API Key 以
km_mcp_开头,创建后只显示一次,请妥善保存。如果丢了也没关系,删掉重新创建一个就好。
第三步:配置你的 AI 客户端
ChatGPT — OAuth 自动授权(最简单)
ChatGPT 使用 OAuth 2.0 自动授权,不需要创建 API Key,操作最简单:
- 登录 ChatGPT → Settings → Connectors → Add custom connector
- 填写 MCP Server URL:
https://knowmine.ai/api/mcp - ChatGPT 自动弹出 KnowMine 登录页面
- 登录后点击 「授权」 按钮
- 返回 ChatGPT,连接完成!
提示:需要 ChatGPT Plus 或 Team 账号。更详细的教程:ChatGPT MCP 接入完全指南
Claude Desktop
最简单的方式是用 Connectors 功能:
- 打开 Claude Desktop → Settings → Connectors → Add custom connector
- 填入以下 URL(将
你的API_KEY替换为真实 Key):
https://knowmine.ai/api/mcp?key=km_mcp_你的API_KEY
- 保存,在新对话中看到 KnowMine 工具即成功
或者编辑配置文件(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"knowmine": {
"url": "https://knowmine.ai/api/mcp",
"headers": {
"Authorization": "Bearer km_mcp_你的API_KEY"
}
}
}
}
Claude Code (CLI)
在终端运行一条命令:
claude mcp add knowmine \
--transport streamable-http \
--url https://knowmine.ai/api/mcp \
--header "Authorization: Bearer km_mcp_你的API_KEY"
重启 Claude Code,输入 /mcp 确认 knowmine 已连接。
Cursor / VS Code
在项目根目录创建 .mcp.json 文件:
{
"mcpServers": {
"knowmine": {
"type": "http",
"url": "https://knowmine.ai/api/mcp",
"headers": {
"Authorization": "Bearer km_mcp_你的API_KEY"
}
}
}
}
保存后重启编辑器。
通义千问
- 在通义千问中找到 MCP / 工具连接器 设置
- 添加自定义 MCP Server
- 填写以下信息:
Server URL: https://knowmine.ai/api/mcp
Transport: Streamable HTTP
Auth Header: Authorization: Bearer km_mcp_你的API_KEY
注意:通义千问的 MCP 功能仍在快速迭代中,具体设置界面可能随版本更新变化。
通用配置(其他支持 MCP 的客户端)
任何支持 MCP 协议的 AI 客户端都可以接入 KnowMine。核心配置信息:
| 配置项 | 值 |
|---|---|
| MCP Server URL | https://knowmine.ai/api/mcp |
| 认证方式 | HTTP Header: Authorization: Bearer <你的API Key> |
| 协议 | Streamable HTTP(JSON-RPC) |
配置完成!你能做什么?
配置成功后,你的 AI 助手将拥有以下 8 个工具:
| 工具 | 功能 | 使用场景 |
|---|---|---|
search_my_knowledge | 语义搜索知识 | "帮我找之前关于 React 性能优化的笔记" |
add_knowledge | 添加新知识 | "把这个方案帮我存到知识库" |
update_knowledge | 更新已有知识 | "帮我补充一下那条 Docker 笔记" |
delete_knowledge | 删除知识 | "那条过时的笔记删掉吧" |
get_knowledge | 获取单条知识详情 | "把那条笔记的完整内容给我看看" |
get_related_knowledge | 发现关联知识 | "跟这个话题相关的我还记录过什么?" |
get_insight | 获取知识洞察 | "总结一下我在前端领域的知识积累" |
list_folders | 列出知识文件夹 | "我的知识库有哪些分类?" |
试试这些对话
配置好之后,直接跟你的 AI 助手说:
"搜索一下我的知识库,看看有没有关于数据库优化的笔记"
"我刚解决了一个 Redis 连接池泄漏的问题,帮我记到知识库里。原因是没有正确关闭连接,解决方案是使用 defer conn.Close()"
"帮我看看跟微服务相关的知识,我之前都记录了什么"
你的 AI 助手现在不只是一个通用的聊天机器人——它是一个了解你、拥有你记忆的个人助理。
常见问题
Q: 配置后 AI 没有反应?
首先确认你的 AI 客户端支持 MCP 协议。然后检查:
- API Key 是否正确复制(以
km_mcp_开头) - URL 是否正确:
https://knowmine.ai/api/mcp - 客户端是否需要重启才能加载新的 MCP 配置
Q: ChatGPT 授权页面打不开?
可能是浏览器拦截了弹出窗口。允许 ChatGPT 的弹出窗口权限,或在浏览器设置中添加例外。
Q: 我的知识数据安全吗?
KnowMine 的 MCP 连接使用 HTTPS 加密传输。API Key 只能访问你自己的知识库,OAuth Token 有过期机制且自动刷新。你可以随时撤销 API Key 或 OAuth 授权来断开连接。
Q: 支持哪些 AI 客户端?
所有支持 MCP 协议(Streamable HTTP 传输)的 AI 客户端都可以接入。目前已验证:ChatGPT、Claude Desktop、Claude Code、Cursor、VS Code 等。通义千问正在跟进支持中。
Q: API Key 丢了怎么办?
在 KnowMine 设置的「MCP 连接」中,删除旧的 Key,创建一个新的就行。旧 Key 会立即失效。
Q: 可以创建多个 API Key 吗?
可以。建议为不同的客户端创建不同的 Key,方便管理。比如一个给 Claude Desktop,一个给 Cursor,需要撤销某个客户端的访问时不影响其他的。
Q: 知识库是空的,配置了也没用吧?
恰恰相反!配置 MCP 之后,你可以直接在 AI 对话中添加知识。觉得有价值的信息,直接说"帮我存到知识库",比手动记笔记方便多了。你的知识库会在日常使用中自然地丰富起来。
现在就开始 → 注册 KnowMine,让你的 AI 助手拥有你的记忆。