跳至主要內容
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 聊天 App (網頁版與行動版) 連線 — 登入即可,無需金鑰

在這些 App 中輸入伺服器 URL https://worker.partsplanai.com/mcp,就會開啟 PartsPlan 的登入與授權畫面 (無需 API key)。PartsPlan 的工具都是讀取工具;只有問題回報工具與蒐集請求工具會留下紀錄。選單名稱可能隨 App 更新而略有不同。

  • 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 → 設定 → 已連結的應用程式 → 新增自訂應用程式 → 輸入 URL → 登入並允許 PartsPlan。

    依 Google 目前的政策,此功能適用於美國 18 歲以上使用者的個人 Google 帳號,且須開啟「保留活動記錄」 (Keep Activity)。Gemini Enterprise 則由管理員將其新增為自訂 MCP 伺服器。

  • Grok

    grok.com/connectors → 新增連接器 → 自訂 → 輸入 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 服務條款