请问怎么设置mcp的host模式

[Tianyue1008]

想把知识库封装成mcp在cline里调用，self-host可以正常检索，但host一直报错 error: api_key。在cline的cline_mcp_setting.json里加了api_key也是一直报同样的error，请问该怎么修改，想通过host模式实现不同的api_key都可以在访问各自的知识库

[dosubot[bot]]

Hi @Tianyue1008! I'm Dosu and I’m helping the ragflow team.

MCP 的 host 模式下，cline 客户端每次请求都必须在 headers 里带上 api_key，否则会报错（即使服务端启动时没指定 api_key 参数）——这是服务端用来区分不同用户和知识库的方式。如果 cline_mcp_setting.json 已经加了 api_key 但还是报错，常见原因有：

1. api_key 必须放在 HTTP 请求的 headers 里，字段名是 api_key，不能只在配置文件里写，cline 代码要确保请求时带上。
2. api_key 的值要和 RAGFlow 主服务端分配给每个用户/知识库的 key 一致，不是随便写的。
3. 配置时不要加引号，比如 --mcp-host-api-key=ragflow-xxxx，不要写成 --mcp-host-api-key="ragflow-xxxx"（虽然 host 模式服务端不校验 key，但客户端必须带，否则会 401）参考。

host 模式启动命令示例（不需要 --api_key 参数）：

uv run mcp/server/server.py --host=127.0.0.1 --port=9382 --base_url=http://127.0.0.1:9380 --mode=host

cline 侧请求示例（以 Python 为例）：

async with sse_client("http://localhost:9382/sse", headers={"api_key": "你的API_KEY"}) as streams:
    ...

这样每个 api_key 就能访问各自的知识库了，服务端会根据 key 做隔离。官方文档说明 和 client 示例。

如果还有问题，可以贴下 cline_mcp_setting.json 的内容和 cline 代码里请求部分，方便进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[Tianyue1008]

我配置了host模式，cline还是访问不了ragflow的知识库，报错srror：api_key. server.py的代码需要做修改吗，我的cline_mcp_setting的配置文件是这样的

{
"ragflow": {
"type": "http-sse",
"url": "http://192.168.xx..xx:9382/sse",
"headers": {
"api_key": "ragflow-xxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}

在client.py写入我的api_key后运行是可以访问成功到知识库的，但cline就是传不进去key

[dosubot[bot]]

你的 cline_mcp_setting.json 配置虽然 headers 里加了 "api_key"，但 ragflow 服务端实际要求 API key 必须放在 HTTP 请求头的 Authorization 字段，格式为 Bearer <你的API_KEY>，而不是 api_key 字段。cline 目前的实现并不会自动把 "api_key" 转换成 Authorization，所以服务端会一直报错。

你可以尝试把 cline_mcp_setting.json 里的 headers 改成：

"headers": {
  "Authorization": "Bearer ragflow-xxxxxxxxxxxxxxxxxxxxxxxx"
}

这样 ragflow 服务端才能正确识别和校验 API key，无需修改 server.py 代码。client.py 能访问成功，是因为它的请求头格式和服务端一致，cline 需要保持一致才行。

相关说明和代码实现细节可参考 这里 和 这里。

如果还有问题，可以贴下 cline 的调用代码片段，进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[ZhenhangTung]

@Tianyue1008 https://ragflow.io/docs/dev/launch_mcp_server

[ZhenhangTung]

@Tianyue1008 Pls use English as your communication language. Or this discussion won't be replied any further.

[ZhenhangTung]

We’ll temporarily close this thread for now, but feel free to reopen or submit a new one in English — we’d love to help!

Thank you for your understanding!