接入指南

通用 MCP 接入

适用于支持远程 MCP 或 HTTP MCP 配置的客户端。

三步配置

入口

打开客户端的 MCP 配置页或 mcp.json 配置文件。

配置

按该客户端字段模型填写 endpoint，并添加 X-MCP-API-Key 请求头。

验证

保存后先执行 tools/list，确认客户端能读取塑库网 MCP 工具。

MCP 参数

Endpoint https://api.plasdata.com/sokoo/mcp

Header X-MCP-API-Key: pd_mcp_xxx

First check tools/list

首次保存后建议先发起 tools/list ，确认客户端已经读到可用工具。

json First check

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

通用 MCP 配置示例

不同客户端可能使用不同字段名，请优先遵循该客户端的 MCP 配置模型；核心信息仍然是接口地址和自定义请求头。

json mcp.json

{
  "mcpServers": {
    "plasdata": {
      "url": "https://api.plasdata.com/sokoo/mcp",
      "headers": {
        "X-MCP-API-Key": "pd_mcp_xxx"
      }
    }
  }
}

安全注意

不要把 pd_mcp_ 开头的完整 Key 写入前端代码。
不要在日志、截图、公开仓库或共享文档中暴露完整 Key。
生产环境建议按应用或环境拆分 Key，便于发现风险后快速停用。