# 在豆包里用 okdata：豆包工作、扣子和火山方舟

> 豆包的哪些入口能接 okdata：豆包工作可以直接加自定义连接器，普通豆包聊天暂时不行，开发者可以在火山方舟里给豆包模型挂 MCP。

网页版：https://okdata.online/zh/integrations/doubao/

想要的效果：在豆包里说一句“看看今天抖音和微博热搜，有哪些话题适合我们奶茶店蹭一下”，它去取实时榜单，挑出几个话题，告诉你怎么蹭、链接在哪。能不能做到，取决于你用的是豆包的哪个入口，所以先把结论放前面。

## 先说结论

| 入口 | 能不能接 okdata |
|---|---|
| 豆包工作（豆包客户端里的“工作”） | 能。支持新建自定义连接器，可以填 MCP 地址和请求头 |
| 普通豆包聊天（App、网页） | 暂时不能。我们没找到让用户自己添加插件或 MCP 的入口 |
| 扣子智能体“发布到豆包” | 现在扣子的发布渠道里已经没有豆包了 |
| 火山方舟 API 里的豆包模型 | 能，面向开发者：Responses API 可以挂远程 MCP，也可以用 Function Calling |

以上是 2026 年 11 月对照豆包和火山引擎官方文档核对的结果，入口变化很快，以产品里实际看到的为准。

## 准备

- 一个 okdata 的 key，以 `okd_` 开头。新 key 自带 $0.10 额度。怎么拿 key 见[快速开始](/zh/docs/quickstart/)。
- 用豆包工作的话，key 会填进连接器设置里保存；用火山方舟的话，把 key 放进环境变量 `OKDATA_API_KEY`，别写进代码。

## 豆包工作：新建自定义连接器

1. 打开豆包工作客户端，点左侧 **插件·技能·伙伴**，在 **插件** 页面右上角点 **+ 添加**。
2. 点 **新建自定义连接器**，填写：
   - **服务器名称**：`okdata`
   - **传输类型**：HTTP
   - **服务器 URL**：`https://api.okdata.online/mcp`
   - 在 **自定义 Headers** 区域点 **+ 添加**，请求头名称填 `Authorization`，值填 `Bearer okd_...`（`Bearer`、空格、完整的 key）
3. 点 **保存**。
4. 点左侧 **新工作任务** 开一个对话，在输入框里打 `/` 选中 `okdata`，或者直接描述需求，让豆包自己匹配插件。

先问一句“我的 okdata 余额还有多少”，能报出数字就说明连上了，这一步不花钱。自定义连接器对哪些套餐开放，以豆包工作里的实际页面为准。

## 普通豆包聊天和扣子

普通豆包聊天里目前没有添加第三方插件的地方。过去常见的做法是在扣子里搭智能体再“发布到豆包”，但扣子现在的发布渠道是扣子商店、飞书、微信、小程序和 API 等，已经没有豆包。如果你的团队习惯在飞书或微信里用 AI，可以按[扣子接入页](/zh/integrations/coze/)搭一个智能体发布过去。

想让所有豆包用户都能在应用里装上某个插件，要走豆包开放平台的插件上架流程，那是插件开发者的事，普通用户用不到。

## 开发者：在火山方舟里给豆包模型挂 MCP

方舟的 Responses API 支持远程 MCP（只支持 Streamable HTTP，正好是 okdata 用的方式），可以带请求头。测试期需要加 `ark-beta-mcp: true` 这个请求头。

```bash
curl https://ark.cn-beijing.volces.com/api/v3/responses \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "ark-beta-mcp: true" \
  -d @- <<EOF
{
  "model": "doubao-seed-2-1-pro-260915",
  "tools": [{
    "type": "mcp",
    "server_label": "okdata",
    "server_url": "https://api.okdata.online/mcp",
    "require_approval": "never",
    "headers": { "Authorization": "Bearer $OKDATA_API_KEY" }
  }],
  "input": [{ "role": "user", "content": [{ "type": "input_text", "text": "微博热搜现在前五是什么？" }] }]
}
EOF
```

`model` 换成你在方舟里开通的模型。`require_approval` 设成 `never` 意味着模型可以自己发起收费调用，记得在提示里写清预算。不想用 MCP 的话，方舟也支持 Function Calling，你可以把某个接口定义成函数，自己用 HTTP 去调 `https://api.okdata.online`。

## 第一句可以这样说

```text
用 okdata 看看今天抖音热搜和微博热搜，挑出五个适合奶茶店借势的话题，
每个写上排名、热度、怎么蹭，附上链接。先告诉我要花多少钱。
```

## 花多少钱

`find`、`describe`、`account` 免费，只有 `call` 收费。上面这句话要读两个热榜：抖音 $0.002，微博 $0.002，合计 $0.004。要是接着搜笔记，[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)每页 $0.02。调用失败不扣费。豆包和方舟那边的模型用量另算，和 okdata 无关。

## 出问题时

- **返回 `unauthorized`（401）。** 请求头没带上 key，或者格式不对。名称要是 `Authorization`，值要以 `Bearer ` 开头。用方舟时，确认运行命令的终端里设置了 `OKDATA_API_KEY`。
- **返回 `insufficient_balance`（402）。** 余额不够这次调用，没有扣费。充值后再试，价格见[定价页](/zh/pricing/)。
- **返回 `rate_limited`（429）。** 短时间内调用太多。返回里有 `retry_after_seconds`，等这么多秒再调用，不扣费。
- **连接器里没有工具。** 检查地址是不是 `https://api.okdata.online/mcp`、传输类型是不是 HTTP。在浏览器里打开这个地址会看到 “Method not allowed”，这是正常的，它只接受 MCP 请求。

## 接着看

- [MCP 服务说明](/zh/mcp/)：四个工具做什么，以及该怎么叮嘱智能体。
- [抖音热搜榜](/zh/apis/douyin/trends/list/)：字段和价格。