Claude

Claude Desktop 和 Claude Code 可以在本地运行 @socq/mcp stdio 转接程序。它通过标准输入输出（stdio）与客户端通信，并将工具发现和调用转发到 SocQ 托管的 MCP 服务。

前置条件

SocQ API 密钥；
Node.js 20 或更高版本；
已安装新版 Claude Desktop 或 Claude Code。

配置 Claude Desktop

打开 Claude Desktop 开发者配置并添加：

{
  "mcpServers": {
    "socq": {
      "command": "npx",
      "args": ["-y", "@socq/mcp"],
      "env": {
        "SOCQ_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

保存后重新启动 Claude Desktop。

此本地配置包含 API 密钥，请勿提交或分享。发布桌面扩展时，应将转接程序打包进扩展，并将 API 密钥字段标记为敏感字段，以便 Claude 使用操作系统的安全存储。

配置 Claude Code

在启动 Claude Code 的 shell 中设置 SOCQ_API_KEY：

export SOCQ_API_KEY="YOUR_API_KEY"

$env:SOCQ_API_KEY="YOUR_API_KEY"

在 macOS、Linux 或 WSL 上，将 SocQ 添加到当前用户的配置：

claude mcp add socq --scope user -- npx -y @socq/mcp

在本机 Windows 上，用 cmd /c 包装 npx：

claude mcp add socq --scope user -- cmd /c npx -y @socq/mcp

从同一环境启动 Claude Code，以便转接程序读取 SOCQ_API_KEY。

请通过环境变量提供 API 密钥。不要使用 --env 传递密钥，否则明文值会保存在 Claude Code 的 MCP 配置中。

限制工具列表

对于 Claude Desktop，在转接程序的参数中添加平台过滤条件：

"args": ["-y", "@socq/mcp", "--platforms", "youtube"]

对于 macOS、Linux 或 WSL 上的 Claude Code，在添加服务器时包含相同的过滤器：

claude mcp add socq-youtube --scope user -- npx -y @socq/mcp --platforms youtube

在本机 Windows 上，在 npx 之前插入 cmd /c。有关模式选择和过滤限制，请参阅选择 MCP 工具。

验证

对于 Claude Code，首先确认服务器已注册：

claude mcp get socq

然后向 Claude Desktop 或 Claude Code 提问：

请使用 SocQ 检查我的账户，然后采集这个 YouTube 视频最新的 20 条评论。
等待任务完成后，以表格形式返回结果：
https://www.youtube.com/watch?v=VIDEO_ID

当 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 指南。

​Claude

​前置条件

​配置 Claude Desktop

​配置 Claude Code

​限制工具列表

​验证

​故障排除

Claude

前置条件

配置 Claude Desktop

配置 Claude Code

限制工具列表

验证

故障排除