#MCP 接入指南

DeepSider 提供远程 MCP 服务，通过 Streamable HTTP 让客户端查询模型目录、比较价格，并调用文本和图片生成工具。

#连接信息

使用根路径，不要自行追加 /mcp 或 /sse。模型 API 地址和 MCP 地址用途不同，不能相互替换。

#Claude Code

先设置 DEEPSIDER_API_KEY，再运行：

claude mcp add --scope user --transport http deepsiderapi-mcp \
  https://mcp.deepsiderapi.com/ \
  --header "Authorization: Bearer $DEEPSIDER_API_KEY"
claude mcp list

--scope user 将配置用于当前用户的所有项目。命令会展开环境变量，客户端保存的配置可能包含真实 Key；不要提交或分享该配置。重启会话后检查工具列表，首次验证先使用只读查询工具。

#Cursor

在用户级 ~/.cursor/mcp.json 中合并配置，保留已有服务：

{
  "mcpServers": {
    "deepsiderapi-mcp": {
      "url": "https://mcp.deepsiderapi.com/",
      "headers": {"Authorization": "Bearer ${env:DEEPSIDER_API_KEY}"}
    }
  }
}

Cursor 支持 ${env:DEEPSIDER_API_KEY} 插值，启动 Cursor 的进程必须能读取该变量。不要把这种变量语法直接复制到不支持它的其他客户端。重新加载服务后检查工具状态。

其他客户端需支持远程 Streamable HTTP 与自定义认证头，按其配置结构填写相同 URL 和认证信息。

#验证与安全

先让客户端调用 search_models 查询模型，再用 get_model 检查调用方式。目录能查询不代表当前 Key 有生成权限，也不代表每个目录模型都能通过 MCP 生成。文本与图片生成会消耗账户额度，详见工具与示例。

401 检查生成工具的认证头；连接失败检查 URL、传输类型和客户端网络。不要将 Key 放进工具参数或普通聊天内容。

客户端配置参考 Claude Code MCP 与 Cursor MCP。