本文へスキップ
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 に接続 — 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 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

    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に報告してください。”

推奨の手順

  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回(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_limited1分あたりの上限です。Retry-Afterの秒数だけ待ってください。
429 api_quota_exceeded1時間または1日の上限です。アップグレードするか、明日もう一度お試しください。
429 too_many_concurrent_requests同時リクエストが多すぎます。少し待ってから再試行してください。
400 batch_not_supportedJSON-RPCの配列(バッチ)は受け付けません。
503 auth_unavailable · quota_unavailable一時的な障害です。少し待ってから再試行してください。
503 free_capacity_reached無料サービス全体が現在、容量の上限に達しています。後でもう一度お試しください。

権利者(メーカー)の方へ: 文書の削除や修正をご希望の場合は、型番または文書のリンクを添えてhello@partsplanai.comまでメールでご連絡ください。ご依頼には速やかに対応します。

セキュリティに関する報告: hello@partsplanai.com (security.txt)

MCP利用規約