给 AI

在 DeepSeek Harness 里用 okdata:内置 MCP 客户端

通过 DeepSeek Harness 内置的 MCP 客户端,把 okdata 加进配置,DeepSeek 模型就能取 17 个平台的社媒数据。

更新于 2026-11-12

DeepSeek Harness 连接的地址 https://api.okdata.online/mcp

一个地址,一个请求头:你的 API Key,作为 Bearer 令牌。

DeepSeek Harness 让 DeepSeek 模型带着你自己的工具以 agent 方式运行。它内置的 MCP 客户端支持带固定请求头的远程服务,okdata 需要的正是这些。配置好之后直接用大白话提问,模型会自己找接口、报价、一页一页取数据。

接入步骤

  1. 打开添加 MCP 服务的地方。 编辑 $DSH_HOME/profiles/<配置名>/cordis.patch.yml(对所有配置生效则编辑 $DSH_HOME/cordis.patch.yml;$DSH_HOME 默认是 ~/.dsh),给内置的 MCP 客户端加一项。
  2. 粘贴配置。 把 Key 占位符换成你自己的 Key。
    cordis.patch.yml
    - insert:
        - id: mcp-okdata
          name: '@deepseek-ai/dsh-mcp-client'
          config:
            serverName: okdata
            transport: streamable-http
            url: https://api.okdata.online/mcp
            headers:
              Authorization: 'Bearer okd_…'
            toolCallTimeoutMs: 120000
  3. 新生成的文件里只有 []:直接替换掉,不要接在后面。用 dsh --profile <配置名> --dump-config 检查,然后开一个新会话。
  4. 让它列出工具。 回答应该和下面一致。

验证是否接好

“列出 okdata 的工具。”

okdata 已接好,共 5 个工具:find 用一句话说要什么数据,返回最多五个接口,带所需参数、价格和可直接用的调用;不会拿别的平台顶替你问的平台;describe 查看一到五个接口的完整说明:参数、支持的链接、价格和单次最多花费、翻页、字段和示例;call 取一页数据,以文本返回:开头几行写明花了多少、余额还剩多少、怎么翻下一页。失败不扣费;max_price 可以给单次调用封顶;read_more 读完被截断(约 20 KB)的结果,或换一种视图再看同一份结果,24 小时内有效;account 余额和 key 的花费上限、单次调用的账单、按天或按接口的用量;不带 key 也能看哪些接口可用。只有 call 收费。目录里有 17 个平台的 214 个接口。

这一步不花钱。

第一次对话

“微博热搜现在有什么?”

工具调用结果费用
find {"query":"微博热搜"}weibo.trends.list · $0.002/次 · 每页约 50 条榜单免费
call {"capability":"weibo.trends.list"}一页,约 50 条$0.002

2 次工具调用 · 1 次收费 · $0.002

接着试试:“用 okdata 看看微博热搜现在有什么。”

在 DeepSeek Harness 里用的建议

  • 免费工具直接放行。 find、describe、account 设为不用确认;想每笔收费都过目,就把 call 留在“每次询问”。
  • 先问价再动手。 “调用之前先告诉我要花多少钱”这句话在哪个客户端都管用。
  • 每个客户端单独一把 Key。 在控制台给每个应用建一把,以后吊销互不影响。
  • 重试很安全。 带同一个 idempotency_key 重发不会重复扣费,失败的调用也不收钱。

关于 DeepSeek Harness

  • DeepSeek Harness 还是开发者预览版,配置可能会变。
  • 工具调用默认 60 秒超时;上面的配置设成了两分钟。
  • 连不上服务时它照样能启动,只是看不到 okdata 的工具。

来源

根据 DeepSeek Harness 官方文档整理,阅读日期 2026-11-12。菜单可能会变:步骤对不上时,以客户端官方页面为准。

出问题时

现象原因解决
DeepSeek Harness 里看不到 okdata 的工具添加服务之前就已经打开了,或者地址和上面的不一样。检查配置,然后重启 DeepSeek Harness 或新开一个对话。
find 能用,call 报 unauthorizedKey 没有传过去。find 和 describe 不需要 Key,所以照样能用。检查请求头是不是 Authorization,值是 Bearer 加 okd_ 开头的 Key,然后重启。
call 报 insufficient_balance余额不够这次调用的最高费用,没有扣费。让它调一次 account 看余额,然后去控制台充值。

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp