把报错发我,免费看一眼

配 MCP、接国内模型,卡在某一步出不来。这种情况我能帮上忙,而且不收费——先看清楚问题在哪,比什么都重要。

发之前跑三条命令

如果你已经在用 mcp-bridge,这三条就够我定位:

python test_stdio.py           # 协议自检,七项
python server.py --doctor      # 环境体检,十七项(重点)
python server.py --report 1    # 账本里有没有记录

没用过也没关系。把你在客户端里看到的报错原文贴出来,加上系统版本和客户端名字,我照样能猜个八九成。

贴这四个东西,一次就说清

  1. --doctor 的完整输出(十七行,别删减,WARN 也有信息)
  2. 系统:Windows 10 / 11、macOS 还是 Linux;Python 版本
  3. 客户端:Claude Code、Cursor、Cline 还是别的
  4. 报错原文:截图里的那行字,或者日志里复制出来

有些东西不用发:API key(打码或者删掉)、你的配置里的私密地址、任何客户数据。诊断用不着这些。

懒得描述?让程序自己写

如果已经装了解压包,跑这一条:

python report.py

它会把系统信息、体检输出、自检结果、客户端配置状态整理成一个 txt 文件,**并且自动脱敏** key、token 和路径里的用户名。生成完直接贴过来就行,不用你组织语言。

发到哪

两个地方,你顺手哪个用哪个:

我一般在 24 小时内回,回的是"哪一层出的问题 + 下一步做什么",不是"欢迎使用我们的产品"。

三种最常见的,你可能自己就能解决

401 / 鉴权失败。九成是 key 没进客户端进程——系统环境变量和程序自己的环境变量是两回事。用 curl 直连打一次,通了就是客户端的问题。

Model not available / 404。模型名对不上。教程里的名字经常过期,直接问服务端要:curl $BASE/models,把返回的 id 原样填回去。

一直转圈然后超时。HTTP/2 协商失败也会这样,报错里一点线索没有。把客户端的 HTTP 兼容模式切到 1.1 试一次,这一步不改任何配置,试错成本是零。

如果你想让我直接动手

诊断免费,动手配通是收费的:¥499,三小时一对一,跑不通不收费。有些问题打字说不清,共享屏幕十分钟比来回十封邮件快。

详情在项目主页的报价那一段。

—— 海桥,做模型接入层。开源版免费,诊断免费。真要收钱的地方会提前说。