所有文章
教程2026-03-1010 分钟

如何让你的 AI 助手(ChatGPT/Claude/通义千问)接入个人知识库

傻瓜式教程:让 ChatGPT、Claude、通义千问等 AI 助手通过 MCP 协议接入个人知识库。ChatGPT 支持 OAuth 自动授权,无需 API Key。

MCP协议AI助手知识库接入ChatGPTClaude通义千问OAuth教程

你的 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 KeyClaude / Cursor / 通义千问 / 其他创建 Key → 粘贴到配置中

ChatGPT 用户直接跳到 ChatGPT 配置,其他平台请先完成前两步。

第一步:注册 KnowMine 账号

访问 knowmine.ai 免费注册一个账号。

注册后,你就拥有了一个个人知识库。你可以先随便添加几条知识,也可以配置好 AI 助手之后直接通过对话来添加。

第二步:创建 API Key(ChatGPT 用户跳过此步)

  1. 登录 KnowMine 后,点击左侧菜单的 「设置」
  2. 找到 「MCP 连接」 选项卡
  3. 点击 「创建 API Key」
  4. 给这个 Key 起个名字(比如"我的 Claude"),然后复制生成的 Key

注意:API Key 以 km_mcp_ 开头,创建后只显示一次,请妥善保存。如果丢了也没关系,删掉重新创建一个就好。

第三步:配置你的 AI 客户端

ChatGPT — OAuth 自动授权(最简单)

ChatGPT 使用 OAuth 2.0 自动授权,不需要创建 API Key,操作最简单:

  1. 登录 ChatGPT → Settings → Connectors → Add custom connector
  2. 填写 MCP Server URL:https://knowmine.ai/api/mcp
  3. ChatGPT 自动弹出 KnowMine 登录页面
  4. 登录后点击 「授权」 按钮
  5. 返回 ChatGPT,连接完成!

提示:需要 ChatGPT Plus 或 Team 账号。更详细的教程:ChatGPT MCP 接入完全指南

Claude Desktop

最简单的方式是用 Connectors 功能:

  1. 打开 Claude Desktop → Settings → Connectors → Add custom connector
  2. 填入以下 URL(将 你的API_KEY 替换为真实 Key):
https://knowmine.ai/api/mcp?key=km_mcp_你的API_KEY
  1. 保存,在新对话中看到 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"
      }
    }
  }
}

保存后重启编辑器。

通义千问

  1. 在通义千问中找到 MCP / 工具连接器 设置
  2. 添加自定义 MCP Server
  3. 填写以下信息:
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 URLhttps://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 协议。然后检查:

  1. API Key 是否正确复制(以 km_mcp_ 开头)
  2. URL 是否正确:https://knowmine.ai/api/mcp
  3. 客户端是否需要重启才能加载新的 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 助手拥有你的记忆。

开始构建你的 AI 原生知识库

免费开始,无需信用卡。连接 Claude,让知识随 AI 而动。

免费注册
如何让你的 AI 助手(ChatGPT/Claude/通义千问)接入个人知识库 - KnowMine Blog | KnowMine