跳到主要内容
PartsPlan AIPartsPlan AI

设置与工具

PartsPlan MCP 是一个 Streamable HTTP(无状态 JSON 模式)MCP 服务器。在请求头中携带 API key 即可连接。

面向 AI 智能体的指南(skill.md)

服务器 URL

https://worker.partsplanai.com/mcp

仅支持 POST(不支持 GET 流式传输,不使用会话)。不接受批量 JSON-RPC(数组)。

API key

登录后在“我的 MCP 密钥”中创建。密钥仅显示一次,以 pk_live_ 开头。请以 Authorization: Bearer <key> 或 x-api-key: <key> 的形式发送。

我的 MCP 密钥 →

从 AI 聊天应用(网页版和移动版)连接——登录即可,无需密钥

在这些应用中,输入服务器 URL https://worker.partsplanai.com/mcp 即会打开 PartsPlan 的登录与授权页面(无需 API key)。PartsPlan 的工具均为读取类工具,只有问题报告和收集请求这两个工具会留下记录。菜单名称可能会随应用更新而略有不同。

  • Claude.ai(网页版、桌面版、移动版)

    连接器页面(claude.ai/customize/connectors)→ 添加自定义连接器 → 输入 URL → 连接 → 登录并授权 PartsPlan。

    如果添加后立即出现“连接问题——重新连接”,说明您尚未登录,请选择“重新连接”。在每个工具首次出现的权限提示中选择“始终允许”,即可不再重复提示。

    一键连接 Claude —— 打开 Claude 的添加连接器窗口,PartsPlan 的名称和地址已填好 ↗
  • ChatGPT

    chatgpt.com/plugins → + → Add custom MCP server → 输入地址,认证选 OAuth → 确认提示(I understand and want to continue) → Create as a plugin → 安装 → 登录 PartsPlan 并授权。

    按照 OpenAI 目前的说明,自定义 MCP 服务器在插件页面添加。公司或学校的工作区可能已被管理员关闭此功能。

    打开 ChatGPT 插件页面 —— 在那里粘贴服务器地址 ↗
  • Gemini

    gemini.google.com → 设置 → 已连接的应用(Connected Apps) → 添加自定义应用(Add a custom app) → 输入 URL → 登录并授权 PartsPlan。

    按 Google 目前的政策,该功能适用于美国地区年满 18 岁用户的个人 Google 账号,且需开启 Keep Activity(保留活动记录)。Gemini Enterprise 则由管理员将其添加为自定义 MCP 服务器。

  • Grok

    grok.com/connectors → 新建连接器(New Connector) → 自定义(Custom) → 输入 URL → 登录并授权 PartsPlan。

    打开 Grok 连接器页面 —— 在那里粘贴服务器地址 ↗
  • Perplexity

    设置 → 连接器 → 添加自定义连接器 → 输入 URL → 登录 PartsPlan → 在对话中开启 PartsPlan 连接器。

    Pro 及更高级别的方案可用。

  • Mistral Le Chat

    连接器 → 添加自定义 MCP 连接器 → 输入 URL → 认证方式选择 HTTP Bearer,并填入您的 API key(pk_live_…)。

    Le Chat 通过密钥而非登录来连接——请在“我的 MCP 密钥”页面创建。

  • Microsoft 365 Copilot(面向组织)

    由您的 Microsoft 365 管理员在 Microsoft 365 管理中心或 Copilot Studio 中将其添加为 MCP 连接器。

从开发工具和终端连接——使用 API key

Claude Code
claude mcp add --transport http --scope user partsplan https://worker.partsplanai.com/mcp --header "Authorization: Bearer pk_live_..."
一键添加到 Cursor —— Cursor 会显示安装提示,然后登录 PartsPlan 完成连接(无需密钥) ↗
Cursor(~/.cursor/mcp.json)
{
  "mcpServers": {
    "partsplan": {
      "url": "https://worker.partsplanai.com/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_..."
      }
    }
  }
}

不支持设置请求头的客户端可以通过 mcp-remote 连接(需要 Node.js)。

Claude Desktop(claude_desktop_config.json)
{
  "mcpServers": {
    "partsplan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://worker.partsplanai.com/mcp",
        "--header",
        "Authorization:${PARTSPLAN_AUTH}"
      ],
      "env": {
        "PARTSPLAN_AUTH": "Bearer pk_live_..."
      }
    }
  }
}
Windsurf(~/.codeium/windsurf/mcp_config.json——URL 字段名为 serverUrl)
{
  "mcpServers": {
    "partsplan": {
      "serverUrl": "https://worker.partsplanai.com/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_..."
      }
    }
  }
}
一键添加到 VS Code —— VS Code 会显示安装提示,然后登录 PartsPlan 完成连接(无需密钥) ↗
VS Code(.vscode/mcp.json——只询问一次密钥,并以掩码形式保存)
{
  "inputs": [
    {
      "type": "promptString",
      "id": "partsplan-key",
      "description": "PartsPlan API key",
      "password": true
    }
  ],
  "servers": {
    "partsplan": {
      "type": "http",
      "url": "https://worker.partsplanai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:partsplan-key}"
      }
    }
  }
}
OpenAI Codex(~/.codex/config.toml——密钥放在环境变量 PARTSPLAN_API_KEY 中)
# PARTSPLAN_API_KEY=pk_live_...  (environment variable)
[mcp_servers.partsplan]
url = "https://worker.partsplanai.com/mcp"
bearer_token_env_var = "PARTSPLAN_API_KEY"
OpenAI API(Responses API 的 mcp 工具——密钥填在 authorization 字段)
{
  "type": "mcp",
  "server_label": "partsplan",
  "server_url": "https://worker.partsplanai.com/mcp",
  "authorization": "pk_live_...",
  "require_approval": "never"
}
Gemini CLI(~/.gemini/settings.json——URL 字段名为 httpUrl)
{
  "mcpServers": {
    "partsplan": {
      "httpUrl": "https://worker.partsplanai.com/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_..."
      }
    }
  }
}
直接调用(curl)
curl -s https://worker.partsplanai.com/mcp \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

12 个工具

像平常一样询问器件问题即可——您的 AI 会选择合适的工具。每个工具都列出了我们实际问过的问题。

  • find_datasheet

    按型号查找我们收录的数据手册,并将所请求制造商的文档与其他制造商的文档区分开。

    可以这样问
    • “查找 TPS563200 的数据手册。”
    • “MIC5216-3.0BM5TR 的文档是哪家公司发布的?”
  • get_datasheet_map

    哪个页面包含哪个章节、表格或图,并附有依据。

    可以这样问
    • “CSD18540Q5B 数据手册中的 SOA 图在哪里?”
    • “INA219 的寄存器映射从第几页开始?”
  • search_datasheet

    在单个文档内按词语或条件搜索;返回页面和区块位置。

    可以这样问
    • “查找 REF5025 的温度漂移和长期稳定性数值。”
    • “在 PT 1,5 接线端子的文档中查找降额图。”
    • “在 TP4056 的中文数据手册中查找“引脚”说明。”
  • get_page_blocks

    按顺序返回单个页面的原文区块(文本、表格)。

    可以这样问
    • “读取 INA219 第 26 页的示例表格。”
    • “显示 PCA9685 寻址章节的原文(第 8 页)。”
  • get_page_image

    单个页面的图像。您的 AI 可直接查看图表、图纸和引脚图。

    可以这样问
    • “从 Ohmite FA-T220 数据手册第 1 页的图表中读取 7 W 时的温升。”
    • “在页面图像上核对 DRV8833 的电气特性表。”
  • get_figure_data

    图表数值(仅在确定时提供)以及图纸中的文字。

    可以这样问
    • “TPS563200 的电流-环境温度曲线在 85 °C 时的值是多少?”
    • “CSD18540Q5B 的 SOA 在 12 V、10 ms 时允许多大电流?”
    • “BSS138 的曲线上,VGS 3.3 V、125 °C 时的 RDS(on) 是多少?”
  • search_parts

    按型号或文本查找候选器件。给出“100V 10A mosfet”这样的数值时,会按这些数值缩小候选范围(未确认),但不判断适用性。也可以按器件类型(MOSFET、霍尔传感器、温度传感器)和制造商浏览——只列出制造商数据手册中印有该器件类型的器件,并以所在页面作为依据(仅限器件类型;不判断额定值或适用性)。

    可以这样问
    • “查找 SOT-23-5 封装、600 mA 及以上的 3.3 V LDO 候选。”
    • “资料库中有哪些制造商生产霍尔效应传感器?”
    • “列出 Slkor 的全部 MOSFET。”
  • compare_points

    指出原器件与你选定的候选器件(最多 3 个)之间应比较的内容——必须一致的项目、可调整的权重、需要阅读的项目,以及每份数据手册中印有各项目的页面。不查找候选器件,也不给出评分、排名或兼容性结论。

    可以这样问
    • “我为 AP2112K-3.3TRG1 选了 RT9080-33GJ5 和 XC6220B331MR-G 作为比较候选——请给出 3.3 V 电池电路的比较基准表和需要阅读的页面。”
    • “改为重新设计并去掉封装组——把压差(dropout)改为加权项目。”
  • reference_circuits

    数据手册中印有应用电路的位置(页码、图注、区域)。由 AI 打开该图并自行读取电路。

    可以这样问
    • “显示 TPS563200 的应用电路。”
  • check_bom

    检查 BOM 每一行的文档是否收录及文档身份(只读)。

    可以这样问
    • “这份 BOM 的全部 30 行都有数据手册吗?”
  • request_datasheet_collection

    请求我们为尚未收录的 BOM 行收集数据手册。

    可以这样问
    • “为你们没有收录的行提交收集请求。”
  • report_problem

    当回答与原文不符或妨碍了您的工作时,请附上文档、页码和区块告知我们。

    可以这样问
    • “这份文档不是该器件的数据手册——请向 PartsPlan 报告。”

推荐流程

  1. 用 find_datasheet 选定文档
  2. 用 get_datasheet_map 找到相应章节的页码
  3. 用 search_datasheet 按条件或词语缩小范围
  4. 用 get_page_blocks 读取原文;用 get_page_image · get_figure_data 查看图表和图纸

如何解读响应

  • 请将所有数值视为未确认的候选值:使用前,请在我们指出的文档和页面上确认。候选值与估算值分别标注——请勿合并。
  • no_document · no_candidates 表示“不在我们的数据中”,并不表示停产或无货。
  • 图表数值不明确时,服务器不会返回该值。请改用 get_page_image 查看。

限制

  • 免费版:每月 300 次调用(每天最多 100 次,每月 1 日 00:00 KST 重置),每小时 100 次,每分钟 60 次
  • 个人版:每天 1,000 次调用,每小时 1,000 次,每分钟 60 次
  • 所有方案:每个账户并发 4 个请求,有效密钥 3 个(每分钟限制和并发限制合并计算同一账户的所有密钥)
  • BOM 检查(check_bom):免费版每天 200 行 · 个人版 1,000 行 · 企业与组织协商约定
  • 因服务器繁忙而被拒绝的请求(too_many_concurrent_requests)不计入您的限额。
  • 每日限额合并计算同一用户的所有密钥(创建新密钥不会提高限额)。
  • 只计算 tools/call。initialize 和 tools/list 不计入。
价格 →

错误

401 api_key_required · invalid_api_key密钥缺失、已撤销或有误。
403 email_verification_required免费密钥需在账户邮箱验证后才能使用。请在 partsplanai.com 上完成验证,然后重试。
429 rate_limited已达每分钟限额。请等待 Retry-After 指定的秒数。
429 api_quota_exceeded已达每小时或每日限额。请升级方案或明天再试。
429 too_many_concurrent_requests并发请求过多。请稍后重试。
400 batch_not_supported不接受 JSON-RPC 数组(批量请求)。
503 auth_unavailable · quota_unavailable暂时性故障。请稍后重试。
503 free_capacity_reached免费服务目前已达到总容量上限。请稍后再试。

权利人(制造商):如需删除或更正文档,请将型号或文档链接发送至 hello@partsplanai.com。我们会及时处理请求。

安全问题报告:hello@partsplanai.com (security.txt)

MCP 服务条款