MCP：连接 AI 工具与 Dinox

使用 API Token 在 OpenClaw、Hermes、豆包工作和 WorkBuddy 中连接 Dinox，搜索、阅读和创建笔记；ChatGPT 连接器使用 OAuth。

Dinox MCP 让 AI 工具直接搜索、阅读和创建你的笔记，也能管理标签、Zettel 笔记盒与模板。使用托管服务即可，无需安装 Dinox MCP Server。

日常接入推荐 API Token。 按下面的顺序操作：获取 Token → 配置你使用的工具 → 执行一次搜索。ChatGPT 的 OAuth 连接方式放在文末。

1. 获取 Token

打开 Dinox App → 设置 → 同步设置 → API Token，复制完整 Token。

所有 Token 接入都使用下面这组参数：

配置项	填写内容
名称	`dinox`
服务地址	`https://mcp.chatgo.pro/mcp`
传输方式	Streamable HTTP（部分界面叫 HTTP）
请求头名称	`Authorization`
请求头值	复制的完整 API Token

本文示例中的 粘贴你的Token 必须替换为实际值；表单中不需要额外加引号。Token 直接作为 Authorization 的值即可，上游也兼容 Bearer Token，不要重复添加前缀。不要把 Token 填进 URL、模型 API Key 或 OAuth 登录框。

Token 可以访问你的 Dinox 数据。只填入自己的客户端配置，不要发送到聊天中或提交到共享仓库。下面的配置示例会将 Token 保存在本机文件中。

2. 配置你使用的工具

只需阅读对应工具的小节。修改已有配置时，保留其他服务；如果已经有 dinox，更新原来的条目。

OpenClaw

先在运行 OpenClaw 的机器上执行：

openclaw mcp --help

如果帮助中有 set、probe，使用下面的原生配置。在 ~/.openclaw/openclaw.json 中合并以下内容（使用独立 profile 或自定义配置路径时，编辑该实例实际使用的文件）：

{
  "mcp": {
    "servers": {
      "dinox": {
        "url": "https://mcp.chatgo.pro/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "粘贴你的Token"
        }
      }
    }
  }
}

如果之前配置过 OAuth，移除 dinox 条目中的 auth: "oauth" 和 oauth 配置；启用 OAuth 时，OpenClaw 会忽略手动填写的 Authorization。

保存后检查连接：

openclaw mcp probe dinox --json

工具列表中应出现 search、fetch 等 Dinox 工具。重启正在运行的 Gateway / Agent，再新开会话，执行下一节的搜索测试。如果工具仍未出现，检查是否使用了隐藏 MCP 的 minimal 工具配置，或在 tools.deny 中禁用了 bundle-mcp。OpenClaw 官方说明

旧版本或已使用 MCPorter 的 OpenClaw： 如果没有上述原生命令，在 Agent 的工作目录下编辑 config/mcporter.json。默认工作目录通常是 ~/.openclaw/workspace，自定义工作目录请使用实际路径。

{
  "mcpServers": {
    "dinox": {
      "baseUrl": "https://mcp.chatgo.pro/mcp",
      "headers": {
        "Authorization": "粘贴你的Token"
      }
    }
  }
}

在该工作目录运行：

mcporter list dinox
mcporter call dinox.search query="复盘" limit=3

若提示找不到 mcporter，先按 MCPorter 官方安装说明安装。然后在 OpenClaw 对话中说：“请通过 mcporter 调用 dinox.search，搜索‘复盘’，最多 3 条。”Agent 需要具备执行 MCPorter 的能力。

原生 MCP 和 MCPorter 使用不同配置文件，选择与你的运行环境对应的一种即可。

Hermes Agent

编辑 ~/.hermes/config.yaml，在已有的 mcp_servers 下添加 dinox：

mcp_servers:
  dinox:
    url: "https://mcp.chatgo.pro/mcp"
    headers:
      Authorization: "粘贴你的Token"

如果原来的 dinox 条目包含 auth: oauth，将它移除。保存后在 Hermes 对话中输入：

/reload-mcp

也可以退出并重新启动 Hermes。在终端检查：

hermes mcp test dinox

然后新开对话执行下一节的搜索测试。若提示缺少 MCP 依赖，按 Hermes 官方 MCP 文档安装对应依赖后重启。

豆包工作

打开桌面端，进入左侧 技能 · 连接器 · 伙伴。
点击 新建 → 新建自定义连接器。
服务器名称填 dinox，传输类型选 HTTP，服务器 URL 填 https://mcp.chatgo.pro/mcp。
在 自定义 Headers 中添加一行：名称填 Authorization，值填完整 Dinox API Token，保存。
新建一个工作任务，在输入框下方的 连接器 中选中 dinox，再执行下一节的搜索测试。

如果你的版本没有自定义连接器或自定义 Headers 入口，先更新桌面端。不要把 Token 拼到地址末尾代替请求头。

界面操作参考 flomo 官方提供的豆包工作接入图示；接入 Dinox 时使用本页的地址和 Token。

WorkBuddy

进入 专家·技能·连接器 → 连接器 → 自定义连接器。部分版本的入口为 插件 → MCP 服务器 → 配置 MCP。
添加名为 dinox 的连接器，将下面的 JSON 填入 MCP 配置编辑器，替换 Token 后保存。

{
  "mcpServers": {
    "dinox": {
      "type": "streamable-http",
      "url": "https://mcp.chatgo.pro/mcp",
      "headers": {
        "Authorization": "粘贴你的Token"
      }
    }
  }
}

启用 dinox，如有信任提示，确认这是你刚添加的服务。
新建任务，执行下一节的搜索测试。连接器未出现时，完全退出并重新打开 WorkBuddy。

优先使用界面打开的配置编辑器，避免改错文件。提供“配置 MCP”入口的版本，其用户级文件为 ~/.workbuddy/mcp.json；项目级为 <项目目录>/.workbuddy/mcp.json。WorkBuddy 官方配置说明

3. 确认真的能用

在已启用 Dinox 的会话中输入：

请调用 Dinox 的 search 工具，搜索“复盘”，最多返回 3 条。
只列出结果，不要创建或修改任何内容。

把“复盘”换成你笔记中实际存在的关键词。看到工具调用成功，并返回搜索结果或正常的空结果，才算完成验证。 仅显示“已连接”或列出工具，不能证明 Token 有效：/mcp 的工具发现不要求先验证账号，真正访问笔记时才会校验凭证。

有结果后，可以继续说：

读取第一条笔记的完整内容，并总结其中的行动项。

确认读取正常，再尝试写入：

把刚才的行动项整理成一篇笔记，先给我草稿，等我确认后再创建到 Dinox。

还可以让 AI 列出模板、按模板生成笔记，或管理标签和 Zettel 笔记盒。目前 MCP 不提供修改、删除已有笔记的工具；如需这类操作，可查看 Dinox Skills。

连接失败怎么查

现象	处理方式
已连接，但搜索报未授权 / 401	检查 `Authorization` 是否填入完整 Token，是否仍是占位文字；重新从 App 复制，去掉多余空格和换行
不断要求浏览器登录	Token 接入应使用 `/mcp`，移除旧 OAuth 配置；不要连接 `/chatgpt-mcp`
找不到工具 / AI 没有调用 Dinox	启用连接器并新开会话；OpenClaw 还需检查工具过滤与 Gateway 是否已重新加载配置
OpenClaw 提示没有 `mcp set` 或 `probe`	使用上面的 MCPorter 配置，或升级到支持原生 MCP 的版本
404、405 或 SSE 连接失败	使用完整 `/mcp` 地址和 Streamable HTTP；不要选旧式 SSE，也不要自行添加 `/sse`
浏览器直接打开 `/mcp` 显示 405	这是 POST 接口，浏览器地址栏发起的 GET 不能用于验证连接；使用客户端搜索测试
超时、DNS 或网络错误	在运行 Agent 的机器上检查网络；可访问 health 和 ready 检查服务状态，它们不验证 Token
搜索返回空列表	换一个已知关键词，先不加日期限制；空列表本身不是认证错误

ChatGPT 连接器：使用 OAuth

在支持创建自定义 MCP 应用的 ChatGPT 设置 → Apps / 连接器 中，开启开发者模式后创建应用：

配置项	填写内容
服务器 URL	`https://mcp.chatgo.pro/chatgpt-mcp`
认证方式	OAuth

按页面提示登录 Dinox 并授权，再在新聊天中启用该应用、执行搜索测试。这里不用手动填写 Dinox API Token。

如果旧连接提示权限不足，先重新授权；仍失败再删除旧连接并重新创建。ChatGPT 的入口和账号可用范围以其官方开发者模式说明为准。

MCP：连接 AI 工具与 Dinox

On this page