返回首页

Connect

接入指南

私人知识库智能体。你自己的个人知识智能助理，包罗万象，一网打尽，一站获取。支持 IDE 和第三方工具通过 MCP 调用，以及在个人应用开发中通过 REST API 调用。

1. 架构指南

调用者是谁

  • IDE — 如 Cursor、CodeBuddy 里的 Agent / 项目会话
  • 聊天客户端 — 如 ChatBox
  • 自有应用 — 如 MyPoke.Trade

以上都须自带大模型（或由宿主接入 LLM），用来理解意图、做业务判断、消费检索结果。

kb.agent-mate.ai 提供什么

  • 管理你在各项目中沉淀的知识（一人一库，按 user 隔离）
  • 按输入检索已有知识，返回可引用片段
  • 按需从外部找候选材料；你确认后才入库
  • 归纳整理知识体系（分类、标签、项目归属）

两种调用方式

调用方经 MCP 或 REST，用同一把 Bearer Key 进入 kb.agent-mate.ai，再访问按用户隔离的私人知识库

MCP

IDE · ChatBox

远程 MCP 工具面（检索、提案、确认、列表、内容概述 ≤400 字、外部候选）。IDE 与第三方客户端传输不同，见第 3–4 节。

REST

MyPoke.Trade · App

HTTP /api/v1/kb/*；与 MCP 同一套能力语义。

MCP 与 REST 共用一把 Key、同一知识库；请求体里的用户标识不能覆盖 Key 身份。

大模型怎么分工

你自带的模型

  • 理解意图与任务目标
  • 决定要不要外部补给、如何解读命中
  • 按业务逻辑筛选、组合知识
  • 产出洞察、策略、文案等下游结果

本站内嵌模型

  • 库内检索、列表、体系整理辅助
  • 外部候选检索与正文拉取
  • 入库提案：≤400 字内容概述、分类建议、查重
  • 确认后的持久化与向量化

本站帮你找到并管好知识，不替你做完生意。要投放策略或业务结论，须由你侧模型结合业务数据完成；外部材料须确认后才入库。

外部搜索（Tavily）

kb_external_search 所需的 TAVILY_API_KEY 只配在 kb-agent 服务端（生产由本站运维）。IDE、ChatBox 等客户端一律不配置、不申请 Tavily；只需使用者 API Key。

请用远程 MCP（§3）或 ChatBox SSE（§4）接入，即可使用库内与外部工具。

2. 获取 API Key

管理员在管理台签发使用者 Key；列表可再次「查看」完整明文。MCP 与 REST 使用同一把 Key。

请求头：Authorization: Bearer <api_key>

吊销立即失效；重签换密钥，知识库保留。

3. IDE 接入

一律通过远端 https://kb.agent-mate.ai 接入（Streamable HTTP，客户端不配 Tavily）。以 Cursor 为例；CodeBuddy 字段相同。

Cursor · 远程

  1. 01

    打开 Cursor Settings

    菜单 Cursor → Preferences → Cursor Settings（或 ⌘,）。

    Cursor 菜单打开 Preferences → Cursor Settings
    Cursor 菜单打开 Preferences → Cursor Settings

  2. 02

    进入 Customize

    左侧栏选择 Customize（Plugins、MCPs、Skills 已迁至此）。

    Cursor Settings 左侧栏高亮 Customize
    Cursor Settings 左侧栏高亮 Customize

  3. 03

    MCPs → New MCP Server

    筛选 MCPs，点击 New MCP Server / Add a Custom MCP Server，打开 mcp.json。

    Customize 中 MCPs 分类与 New MCP Server
    Customize 中 MCPs 分类与 New MCP Server

  4. 04

    填写远程 URL 与 Bearer

    用下方模板：url 固定为 https://kb.agent-mate.ai/mcp；headers 里 Authorization: Bearer <使用者 Key>。不要填 /sse，不要加 TAVILY_API_KEY，不要使用本机地址。

    mcp.json 编辑界面（远程配置用 url + headers）
    mcp.json 编辑界面（远程配置用 url + headers）

mcp.json 模板（远端 kb.agent-mate.ai）

{
  "mcpServers": {
    "kb-agent": {
      "url": "https://kb.agent-mate.ai/mcp",
      "headers": {
        "Authorization": "Bearer <paste_plaintext_user_api_key>"
      }
    }
  }
}

CodeBuddy：Remote MCP → https://kb.agent-mate.ai/mcp + Bearer（与上表相同）。

连通后可试：kb_list_knowledge → kb_internal_search →（可选）propose / confirm → kb_external_search。

4. 第三方工具接入

以 ChatBox 为例。须使用 Remote (http/sse) 与远端 /sse，不能填 /mcp，不能使用本机地址。同样不配置 Tavily。

  1. 01

    Settings → MCP

    打开 ChatBox 设置，左侧选择 MCP。

    ChatBox MCP Settings，侧栏 MCP 与 Add Server
    ChatBox MCP Settings，侧栏 MCP 与 Add Server

  2. 02

    Add Custom Server

    Custom MCP Servers → Add Server → 选择 Add Custom Server。

    ChatBox 选择 Add Custom Server
    ChatBox 选择 Add Custom Server

  3. 03

    填写服务器（注意 SSE）

    Type = Remote (http/sse)。URL：https://kb.agent-mate.ai/sse。HTTP Header：Authorization=Bearer <api_key>。

    ChatBox Add MCP Server 表单，Type 为 Remote http/sse，URL 以 /sse 结尾
    ChatBox Add MCP Server 表单，Type 为 Remote http/sse，URL 以 /sse 结尾

点 Test，通过后再 Save；在会话中启用该 MCP。

不要填 /mcp。ChatBox 会对 URL 发 SSE GET，/mcp 会报 404。

只需 Bearer 使用者 Key；Tavily 由 kb-agent 服务端提供。

连通后可试：kb_list_knowledge → kb_internal_search →（可选）propose / confirm → kb_external_search。