跨境独立站_常见的问题

2026-11-17
来源:

(1)返回 HTTP 401,该怎么处理?

检查URL里面的key是不是完整、有效,复制拼接URL的时候有没有编码出错,同时确认网站后台已经打开AI接口开放权限。

鉴权失败常见返回示例:

{

 "error": "unauthorized",

 "message": "missing or invalid key"

}

客户端不要靠固定的提示文字判断错误类型,提示文案有可能调整。不用密钥的能力说明可以访问 /capabilities。

(2)/capabilities 可以打开,为什么MCP调用还是失败?

/capabilities只是公开的功能介绍页面,能打开,不代表API Key有效,也不等于网站开启了AI接口开放。必须用带key的MCP地址做初始化、查工具列表。

(3)工具列表响应里面为什么会出现 event: 和 data:?

代表返回用了SSE流式格式。这次验证的tools/list返回就是SSE,JSON-RPC消息都放在data:内容里面,客户端需要支持SSE解析。

(4)文章分类ID可以传数组吗?

现在addNews里面groupIds是字符串类型,不是数组。具体传什么值、格式怎么写,跟着平台规则来。

(5)新增请求超时了,可以直接重试吗?

建议先查后台或者调用查询工具确认文章有没有新增成功,再决定要不要重试,避免重复创建多篇一样的文章。当前工具没有幂等键,没法自动防重复提交。

(6)工具参数变了怎么办?

重新调用tools/list拿到最新工具定义,跟着最新inputSchema更新参数校验逻辑。这份文档记录的是更新日期当时的接口定义。

九、接入排查信息

如果要找平台技术人员排查问题,建议提供调用时间、工具名称、HTTP状态码、请求id、脱敏之后的参数、报错返回内容,方便定位问题。不要直接发完整API Key或者带秘钥的完整请求链接。