常见问题

本页集中说明威科先行 MCP 在安装、连接、认证和工具调用中的常见问题。

安装与连接

WorkBuddy 商城中搜索不到威科先行

确认客户端已升级到支持连接器商城的版本，并尝试搜索“威科先行”或“Wolters Kluwer”。企业或团队工作区可能需要管理员先允许安装该连接器。

是否需要手工复制官方连接器的 Server 地址或应用凭证

不需要。WorkBuddy 的官方连接器已经配置 integrated 服务地址，添加连接器后按提示完成登录授权即可。

已连接但没有显示工具

确认配置类型为远程 Streamable HTTP，并检查 Server 地址是否完整且保留末尾的 /：

text
https://mcp.wkinfo.com.cn/mcp-servers/integrated/

保存后重新加载 MCP Server；仍未恢复时，重启客户端。

客户端只有 SSE 选项

当前服务使用 Streamable HTTP，不是旧版 SSE。请升级客户端，或安装明确支持 Streamable HTTP 的 MCP 扩展。不要把当前地址填写到仅支持 SSE 的配置项中。

Dify 连接测试超时

确认 Dify 服务端能够访问公网 HTTPS，并检查容器网络、代理和防火墙。MCP 请求由 Dify 服务端发出，不是由浏览器直接发出。

Cursor 项目配置没有加载

确认文件路径为 .cursor/mcp.json，并检查 JSON 语法。保存后重新加载 Cursor 窗口或重启 MCP Server。

Claude Code 配置更新后没有生效

结束当前 Claude Code 会话并重新启动，再执行 /mcp 检查连接状态。需要重新添加时，可以先执行：

bash
claude mcp remove wk-mcp

OAuth 与应用凭证

客户端再次显示授权页面

OAuth 客户端会持续使用默认应用的应用凭证。删除默认应用或轮换默认应用的应用凭证后，原凭证失效，客户端会在下一次访问时重新发起授权。按页面提示完成授权即可。

Claude Code 的 /mcp 显示需要认证

首次连接时，在 /mcp 中选择 wk-mcp 并完成 OAuth 授权。使用应用凭证认证时，检查请求头是否为 Authorization: Bearer <YOUR_TOKEN>。

Cursor 显示 Needs login

点击对应的登录操作并完成威科先行 OAuth 授权。使用应用凭证认证时，确认凭证仍然有效。

codex mcp login 无法完成授权

确认 wk-mcp 已经使用 --url 添加，并且当前环境能够打开授权页面。无浏览器或无交互环境可以改用应用凭证认证。

Codex 提示缺少应用凭证环境变量

在启动 Codex 的同一 shell 或桌面应用启动环境中设置 WK_MCP_CREDENTIAL，然后重新启动 Codex。

配置应用凭证后仍返回 401

检查以下内容：

  • 请求头名称必须是 Authorization。
  • 请求头值必须以 Bearer 开头，中间有一个空格。
  • 应用凭证前后不能包含引号、换行或多余空格。
  • 应用没有被删除，应用凭证没有被轮换，并且复制内容完整。
  • Dify 等服务端平台使用的 MCP 提供器会转发自定义 Header。

轮换应用凭证后客户端如何恢复访问

直接配置应用凭证的客户端需要替换为新凭证，然后重新加载 MCP Server。OAuth 客户端使用默认应用；轮换默认应用的应用凭证后，客户端会在下一次访问时自动发起重新授权。

如何切换 OAuth 与应用凭证认证

先删除客户端中的旧 Server 配置，再使用目标认证方式重新添加。Codex 可以执行：

bash
codex mcp remove wk-mcp

应用凭证泄露怎么办

立即进入威科先行 MCP 网站的“我的服务”，轮换对应应用的应用凭证。原凭证失效后，为直接使用该凭证的客户端配置新凭证；OAuth 客户端会按默认应用重新发起授权。

工具与额度

已连接，但模型没有调用威科先行工具

确认当前助手或 Agent 模式已启用 MCP 工具。在提示中明确写出“使用威科先行 MCP”，并检查客户端是否需要人工确认工具调用。

返回 quota_exhausted

当前工具所需的服务额度已经用完、过期或尚未开通。integrated 会展示全部工具，但不同工具分别使用对应套餐额度：

工具类别所需套餐Scope
法规和法条检索法规检索law
案例检索案例检索case
法律引用识别智能验证verify

请前往“我的服务”检查对应套餐的剩余次数和有效期。

OAuth 成功但只有部分工具可用

OAuth 使用默认应用的应用凭证。请检查默认应用是否已开通法规检索、案例检索或智能验证套餐，以及对应套餐的剩余额度。

Dify Workflow 很快用完额度

每次工具调用都会使用对应套餐的额度。检查循环、自动重试和并行分支，避免同一问题被重复调用。

查询没有结果

根据输入类型选择合适工具：

  • 完整法律问题使用 search_law。
  • 明确法规关键词使用 search_law_keyword。
  • 法规名和具体条号使用 search_law_article。
  • 完整案情和争议焦点使用 search_case。
  • 案号、案由和明确关键词使用 search_case_keyword。
  • 已有文本中的法律引用使用 legal_citation。

日期参数必须使用 YYYY.MM.DD，不限制日期时传 *。

仍未解决

反馈问题时，请提供以下非敏感信息：

  • 使用的平台和版本。
  • Server 地址及传输方式。
  • 工具名称。
  • 错误码或脱敏后的错误信息。
  • 问题发生时间。

不要提供完整应用凭证、OAuth 授权信息或包含个人敏感信息的请求内容。

相关文档