Skip to main content

​
Claude

Claude Desktop 和 Claude Code 可以将发布的 @socq/mcp 桥作为本地 stdio 服务器运行。该桥将工具发现和调用转发到托管的 SocQ MCP 端点。

​
前置条件

  • SocQ API 密钥；
  • Node.js 20 或更高版本；
  • 当前的 Claude Desktop 或 Claude Code 安装。

​
配置 Claude Desktop

打开 Claude Desktop 开发者配置并添加：
保存后重新启动 Claude Desktop。
此本地配置包含凭据。不要提交或分享它。对于分布式集成，将桥打包为桌面扩展并将 API 密钥字段标记为敏感，以便 Claude 可以使用操作系统安全存储。

​
配置 Claude Code

在启动 Claude Code 的 shell 中设置 SOCQ_API_KEY：
在 macOS、Linux 或 WSL 上为您的用户账户添加 SocQ：
在本机 Windows 上，用 cmd /c 包装 npx：
从同一环境启动 Claude Code，以便桥继承 SOCQ_API_KEY。
将 API 密钥保留在您的环境中。不要通过 --env 传递它，因为它将明文值存储在 Claude Code 的 MCP 配置中。

​
限制工具列表

对于 Claude Desktop，将平台过滤器添加到桥参数：
对于 macOS、Linux 或 WSL 上的 Claude Code，在添加服务器时包含相同的过滤器：
在本机 Windows 上，在 npx 之前插入 cmd /c。有关模式选择和过滤限制，请参阅选择 MCP 工具。

​
验证

对于 Claude Code，首先确认服务器已注册：
然后向 Claude Desktop 或 Claude Code 提问：
当 Claude 发现 SocQ 工具、调用 socq_account、提交采集并使用 socq_get_task 读取返回的任务时，连接正在工作。

​
故障排除

  • Claude Desktop：配置更改后重新启动应用程序，以便刷新工具列表。
  • Claude Code：使用 claude mcp list 检查已配置的服务器，使用 /mcp 查看连接状态。如果在启动后才设置 SOCQ_API_KEY，请重新启动 Claude Code。
请参阅集成故障排除、Anthropic 的Claude Desktop 本地 MCP 指南 和 Claude Code MCP 指南。