セットアップとツール
PartsPlan MCPはStreamable HTTP(ステートレスJSONモード)のMCPサーバーです。API keyをヘッダーに付けて接続します。
AIエージェント向けガイド (skill.md)サーバーURL
https://worker.partsplanai.com/mcpPOSTのみです(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 に接続 — PartsPlan の名前と URL が入力済みの、Claude のコネクタ追加画面が開きます ↗ChatGPT
chatgpt.com/plugins → + → Add custom MCP server → URL を入力、認証は OAuth → 注意事項を確認(I understand and want to continue) → Create as a plugin → インストール → PartsPlan にログインして許可。
OpenAI の現在の案内では、カスタム MCP サーバーはプラグイン画面から追加します。会社・学校のワークスペースでは管理者が無効にしている場合があります。
ChatGPT のプラグイン画面を開く — サーバー URL を貼り付けてください ↗Gemini
gemini.google.com → 設定 → 接続済みアプリ → カスタムアプリを追加 → URLを入力 → ログインしてPartsPlanを許可します。
Googleの現在のポリシーでは、米国在住の18歳以上の方の個人用Googleアカウントで、「Keep Activity」(アクティビティの保存)をオンにしている場合に利用できます。Gemini Enterpriseでは、管理者がカスタムMCPサーバーとして追加します。
Grok
grok.com/connectors → New Connector → Custom → URLを入力 → ログインしてPartsPlanを許可します。
Grok のコネクタ画面を開く — サーバー URL を貼り付けてください ↗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 mcp add --transport http --scope user partsplan https://worker.partsplanai.com/mcp --header "Authorization: Bearer pk_live_..."{
"mcpServers": {
"partsplan": {
"url": "https://worker.partsplanai.com/mcp",
"headers": {
"Authorization": "Bearer pk_live_..."
}
}
}
}ヘッダーに対応していないクライアントは、mcp-remote経由で接続できます(Node.jsが必要です)。
{
"mcpServers": {
"partsplan": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://worker.partsplanai.com/mcp",
"--header",
"Authorization:${PARTSPLAN_AUTH}"
],
"env": {
"PARTSPLAN_AUTH": "Bearer pk_live_..."
}
}
}
}{
"mcpServers": {
"partsplan": {
"serverUrl": "https://worker.partsplanai.com/mcp",
"headers": {
"Authorization": "Bearer pk_live_..."
}
}
}
}{
"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}"
}
}
}
}# PARTSPLAN_API_KEY=pk_live_... (environment variable)
[mcp_servers.partsplan]
url = "https://worker.partsplanai.com/mcp"
bearer_token_env_var = "PARTSPLAN_API_KEY"{
"type": "mcp",
"server_label": "partsplan",
"server_url": "https://worker.partsplanai.com/mcp",
"authorization": "pk_live_...",
"require_approval": "never"
}{
"mcpServers": {
"partsplan": {
"httpUrl": "https://worker.partsplanai.com/mcp",
"headers": {
"Authorization": "Bearer pk_live_..."
}
}
}
}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
1つの文書内を語句や条件で検索し、ページとブロックの位置を返します。
こう聞いてみてください- “REF5025の温度ドリフトと長期安定性の値を探してください。”
- “PT 1,5端子台の文書でディレーティング図を探してください。”
- “中国語版TP4056データシートのピン説明(引脚)を探してください。”
- get_page_blocks
1ページ分の原文ブロック(テキスト、表)を順番どおりに返します。
こう聞いてみてください- “INA219の26ページにある例の表を読んでください。”
- “PCA9685のアドレス設定のセクション(8ページ)の原文を見せてください。”
- get_page_image
1ページ分の画像です。グラフ、図面、ピン図はお使いの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のバッテリー回路向けの基準表と読むべきページを見せてください。”
- “再設計に切り替えて、パッケージのグループを除外してください — ドロップアウトは重み付きの項目にしてください。”
- reference_circuits
データシートで応用回路が印刷されている場所(ページ、キャプション、領域)を示します。回路はAIが図を開いて自ら読み取ります。
こう聞いてみてください- “TPS563200の応用回路を見せてください。”
- check_bom
BOMの各行について、文書の有無と識別を確認します(読み取り専用)。
こう聞いてみてください- “このBOMの30行すべてのデータシートはありますか?”
- request_datasheet_collection
当社が保有していないBOM行のデータシートの収集を依頼します。
こう聞いてみてください- “保有していない行の収集を依頼してください。”
- report_problem
回答が原文と合わなかったときや作業の妨げになったときに、文書、ページ、ブロックを添えて当社に知らせます。
こう聞いてみてください- “この文書はその部品のデータシートではありません — PartsPlanに報告してください。”
推奨の手順
- find_datasheetで文書を選びます
- get_datasheet_mapで該当セクションのページを探します
- search_datasheetで条件や語句を絞り込みます
- get_page_blocksで原文を読み、グラフと図面はget_page_image · get_figure_dataで見ます
応答の読み方
- すべての値を未確認の候補として扱ってください。使う前に、示された文書とページで確認してください。候補と推定値は別々にラベル付けされています — 混ぜないでください。
- no_document · no_candidatesは「当社のデータにない」という意味で、生産終了や入手不可という意味ではありません。
- グラフの値があいまいな場合、サーバーはその値を返しません。代わりにget_page_imageで見てください。
利用上限
- 無料: 月300回(1日最大100回、毎月1日の00:00 KSTにリセット)、1時間100回、1分60回
- 個人: 1日1,000回、1時間1,000回、1分60回
- 全プラン共通: 1アカウントあたり同時4件、有効なキー3個(1分あたりの上限と同時実行の上限は、アカウントのすべてのキーを合算して数えます)
- BOMチェック(check_bom): 1日あたり無料200行 · 個人1,000行 · 企業・団体は協議により決定
- サーバーの混雑で拒否されたリクエスト(too_many_concurrent_requests)は上限に数えません。
- 1日の上限は、1人のユーザーのすべてのキーを合算して数えます(新しいキーを作っても増えません)。
- 数えるのはtools/callのみです。initializeとtools/listは数えません。
エラー
| 401 api_key_required · invalid_api_key | キーがない、失効している、または誤っています。 |
| 403 email_verification_required | 無料キーは、アカウントのメールアドレスを認証すると使えます。partsplanai.comで認証してから再試行してください。 |
| 429 rate_limited | 1分あたりの上限です。Retry-Afterの秒数だけ待ってください。 |
| 429 api_quota_exceeded | 1時間または1日の上限です。アップグレードするか、明日もう一度お試しください。 |
| 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)