연결 방법과 도구

서버 주소

https://worker.partsplanai.com/mcp

POST만 받습니다(GET 스트리밍·세션 없음). 배치 JSON-RPC(배열)는 받지 않습니다.

API 키

로그인한 뒤 '내 MCP 키'에서 만듭니다. 키는 만들 때 한 번만 보이며 pk_live_ 로 시작합니다. Authorization: Bearer <키> 또는 x-api-key: <키> 헤더로 보냅니다.

개발 도구·명령창에서 연결 — API 키로

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

  한 문서 안에서 낱말·조건으로 찾아 쪽·블록 위치를 돌려줍니다.

  이렇게 물어보세요

  • “REF5025 에서 온도 드리프트랑 장기 안정성 값 찾아 줘”
  • “PT 1,5 단자대 문서에서 감액(derating) 도표 찾아 줘”
  • “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 RDS(on)–VGS 곡선에서 3.3 V · 125 °C 값은?”
• search_parts

  품번이나 문장으로 후보 부품을 찾습니다. '100V 10A mosfet'처럼 값을 주면 그 값으로 후보를 좁히지만(확인 전 값), 적합성은 판단하지 않습니다. 종류(MOSFET·홀 센서·온도 센서)와 제조사로 둘러볼 수도 있습니다 — 제조사 데이터시트에 그 종류로 인쇄된 부품만, 인쇄된 쪽을 근거로 보여 줍니다(종류만 확인, 정격·적합성 판단 없음).

  이렇게 물어보세요

  • “SOT-23-5 3.3 V LDO, 600 mA 이상 후보 찾아 줘”
  • “아카이브에서 홀 센서를 만드는 제조사 목록 보여 줘”
  • “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회(하루 최대 100회 · 매월 1일 0시 초기화), 시간당 100회, 분당 60회
• 개인: 하루 1,000회, 시간당 1,000회, 분당 60회
• 모든 요금제: 계정당 동시 4건, 활성 키 3개 (분당·동시 한도는 한 계정의 모든 키를 합쳐 셉니다)
• BOM 점검(check_bom): 하루 무료 200줄 · 개인 1,000줄 · 기업·단체는 계약에 따라
• 서버가 붐벼서 거절된 요청(too_many_concurrent_requests)은 한도에서 빠지지 않습니다.
• 하루 한도는 한 사용자의 모든 키를 합쳐 셉니다(키를 새로 만들어도 늘지 않습니다).
• tools/call 만 셉니다. initialize·tools/list 는 한도에 들어가지 않습니다.

오류