æŠèŠ
çºéè åãã®UPS API: ãã©ããã³ã°çªå·ãŸãã¯åç §ã§ããã±ãŒãžã远跡ããç±³åœã®äœæãæ€èšŒããæéãšèŒžéæéãæ¯èŒãããããããªãããã³ã¢ã¯ã»ã¹ãã€ã³ãã®ãã±ãŒã·ã§ã³ãèŠã€ããçå°ã³ã¹ããèŠç©ãããã©ãã«ãå埩ããããã¯ã¢ãããèŠç©ãããŸããåºè·ã®äœæãç¡å¹åãããã¯ã¢ããã¯å«ãŸããŸããããªãã«ãªã£ãŠããŸããUPSéçºè ããŒã¿ã«ããã®OAuthã¯ã©ã€ã¢ã³ãIDãšã·ãŒã¯ã¬ããã
ã¬ã€ãä»ãã»ããã¢ãã
UPS ã ClaudeãChatGPTãCopilot ã« 2 åã§æ¥ç¶
AnythingMCP Cloud ã®ç¡æãã©ã€ã¢ã«ãå§ããã¬ã€ãä»ãã»ããã¢ããã§ UPS ãæ¥ç¶ããŠãMCP URL ã AI ã¢ã·ã¹ã¿ã³ãã«è¿œå ããŸããã³ãŒãããµãŒããŒã®éçšãäžèŠã§ãã
ã¯ã¬ãžããã«ãŒãäžèŠ Â· 7æ¥éã®è©Šçš · ã»ã«ããã¹ãã®éžæè¢ãã
ããèããŠã¿ãã
UPS ã®ãµã³ãã«ããã³ãã
ããã³ãããã¯ãªãã¯ã§ã³ããŒãClaude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw ã«è²Œãä»ããŠããã®ã³ãã¯ã¿ãŒã§å®è¡ã§ããŸãã
Claude 㯠AI ã®ãã誀ãããšããããŸããåçãã確èªãã ããã
ð¡ ã€ã³ã¹ããŒã«äžèŠïŒcloud.anythingmcp.comã«çŽæ¥ã¢ã¯ã»ã¹ããŠãã ããã ãµã€ã³ã€ã³ããŠãConnectors â UPSãã¯ãªãã¯ããèªèšŒæ å ±ã貌ãä»ããMCP APIããŒãäœæããã°å®äºã§ããDockerã
git cloneãããŒã«ã«ãµãŒããŒãäžèŠã§ãã
UPS
çºéè åãã®UPS API: ãã©ããã³ã°çªå·ãŸãã¯åç §ã§ããã±ãŒãžã远跡ããç±³åœã®äœæãæ€èšŒããæéãšèŒžéæéãæ¯èŒãããããããªãããã³ã¢ã¯ã»ã¹ãã€ã³ãã®ãã±ãŒã·ã§ã³ãèŠã€ããçå°ã³ã¹ããèŠç©ãããã©ãã«ãå埩ããããã¯ã¢ãããèŠç©ãããŸããåºè·ã®äœæãç¡å¹åãããã¯ã¢ããã¯å«ãŸããŸããããªãã«ãªã£ãŠããŸããUPSéçºè ããŒã¿ã«ããã®OAuthã¯ã©ã€ã¢ã³ãIDãšã·ãŒã¯ã¬ããã
ã»ããã¢ãã
ã»ããã¢ããã«ã¯çŽ10åããããŸãã
- https://developer.ups.com ã«ãµã€ã³ã€ã³ããçºéè ã¢ã«ãŠã³ããææããups.comãããã¡ã€ã«ã§ã¢ããªã±ãŒã·ã§ã³ãäœæããããŒãžãéããŸãïŒå¿ èŠã«å¿ããŠæåã«ç»é²ããŠãã ããïŒã
- UPSæè¡ãèªåã®ããžãã¹ã«çµ±åããããšäŒããã¢ããªãè«æ±ããUPSã¢ã«ãŠã³ãçªå·ãéžæããã¢ããªã®ååãä»ããŸãã
- ã³ãã¯ã¿ã䜿çšãã補åã远å ããŸã: ãã©ããã³ã°ãäœææ€èšŒãæéã茞éæéããã±ãŒã¿ãŒãããã³ãªãã«ãªã£ãŠããããŒã«ã®ããã®åºè·ãããã¯ã¢ãããçå°ã³ã¹ãèŠç©ãããæ¬ ããŠãã補åã¯ããã®ããŒã«ã«å¯ŸããŠ401ãŸãã¯403ã®å¿çãè¿ããŸãã
- ã¯ã©ã€ã¢ã³ãIDã
UPS_CLIENT_IDã«ãã¯ã©ã€ã¢ã³ãã·ãŒã¯ã¬ãããUPS_CLIENT_SECRETã«ã³ããŒããŸãã - 6æ¡ã®UPSã¢ã«ãŠã³ãçªå·ïŒçºéè
çªå·ïŒã
UPS_ACCOUNT_NUMBERã«å ¥åããŸãã
ã³ãã¯ã¿ã¯ãhttps://onlinetools.ups.com/security/v1/oauth/tokenïŒã¯ã©ã€ã¢ã³ãè³æ Œæ
å ±ãHTTP BasicïŒã§ã¯ã©ã€ã¢ã³ãIDãšã·ãŒã¯ã¬ããã亀æããçåœã®ãã¢ã©ãŒããŒã¯ã³ãååŸããèªåçã«æŽæ°ããŸãããããã¯æ¬çªçšã®è³æ Œæ
å ±ã§ã; UPSãã¹ãã·ã¹ãã ïŒwwwcie.ups.comïŒã¯äœ¿çšãããŸããã
éå§ããå Žæ: ups_track_packageããã©ããã³ã°çªå·ã§ãæéãç¥ãããå Žåã¯ãups_shop_ratesã2ã€ã®äœæéã®ãã¹ãŠã®ãµãŒãã¹ãæ¯èŒããups_get_rateã1ã€ã®ãµãŒãã¹ã®æéãæäŸããŸã; ups_get_time_in_transitã¯äŸ¡æ Œãªãã§é
鿥ãæäŸããŸãã
ãã©ããã³ã°: ups_track_packageïŒä»»æã®ãã©ããã³ã°çªå·ïŒãups_track_by_referenceïŒèªåã®åç
§ãäŸãã°æ³šæçªå·ãã¢ã«ãŠã³ãå
ïŒããã³ups_track_shipment_packagesïŒè€æ°ããã±ãŒãžã®åºè·ã®ãã¹ãŠã®ããã±ãŒãžïŒãæ¥ä»ã¯YYYYMMDDãæéã¯ã¹ãã£ã³ã®ããŒã«ã«æéã§HHMMSSã§ã; gmtDateãgmtTimeããã³gmtOffsetã¯UTCã§åãç¬éã瀺ããŸããcurrentStatus.descriptionããç¶æ
ãèªã¿åããactivityããã¹ãã£ã³ãååŸããŸãïŒæ°ãããã®ããé ã«ïŒã
äœæãšãã±ãŒã·ã§ã³: ups_validate_addressã¯ãç±³åœããã³ããšã«ããªã³ã®ã¹ããªãŒãã¢ãã¬ã¹ã®ã¿ãã«ããŒããŸããups_find_locationsã¯ãUPSããµãŒãã¹ãæäŸããä»»æã®åœã®äœæè¿ãã®ãããããªãå Žæããã³UPSã¢ã¯ã»ã¹ãã€ã³ãã®ãã±ãŒã·ã§ã³ãèŠã€ããŸãã
æé: ups_shop_ratesããã³ups_get_rateã¯ãçºéè
çªå·ãšããŠã¢ã«ãŠã³ãçªå·ãéä¿¡ããŸããå
¬éæéã¯ããã©ã«ãã§è¿ãããŸã; NegotiatedRatesIndicatorã䜿çšããŠrating_optionsãæž¡ããšãã¢ã«ãŠã³ãã®å¥çŽæéãNegotiatedRateChargesã«è¡šç€ºãããŸããéé¡ã¯é£ã«èšèŒãããéè²šã®æååã§ããééã¯LBSãŸãã¯KGSã寞æ³ã¯INãŸãã¯CMã§ãåç£åœã®åäœã䜿çšããŸããups_quote_landed_costã¯ãåœå¢ãè¶ããåºè·ã®é¢çšããã³çšéãèŠç©ãããã¢ã€ãã ããšã«HSã³ãŒãããããšæé©ã§ãã
ã©ãã«ãšåºè·: ups_recover_labelã¯ãæ¢åã®åºè·ã®ã©ãã«ãå床è¿ããè²»çšã¯ããããŸãããups_create_shipmentã¯ãUPSãã¢ã«ãŠã³ãã«è«æ±ããåºè·ãäœæããups_void_shipmentã¯ããã¯ã¢ããåã«åºè·ããã£ã³ã»ã«ããŸã; äž¡æ¹ãšããªãã«ã€ã³ã¹ããŒã«ãããŠããŸããã¢ã·ã¹ã¿ã³ããå®éã®åºè·ãäœæããå¿
èŠãããå Žåã®ã¿ãã³ãã¯ã¿ã§ãªã³ã«ããŸããUPSã®ãã£ãŒã«ãåã¯åŒã³åºãããšã«ç°ãªããŸã: æéããŒã«ã¯ããã±ãŒãžã³ã°ãPackagingTypeãšåŒã³ãåºè·ããŒã«ã¯PackagingãšåŒã³ãŸãã
ããã¯ã¢ãã: ups_get_pickup_rateã¯ãªã³ã³ãŒã«ããã¯ã¢ããã®èŠç©ãããè¡ããups_get_pending_pickupsã¯äºçŽããããã®ããªã¹ãããŸããups_create_pickupã¯æéãæ¯æã£ãŠãã©ã€ããŒãäºçŽããups_cancel_pickupã¯PRNã§ãã£ã³ã»ã«ããŸã; äž¡æ¹ãšããªãã«ã€ã³ã¹ããŒã«ãããŠããŸãã
ãšã©ãŒ: UPSã¯response.errorsã§å¿çããcodeãšmessageã®ãªã¹ããæäŸããŸãã401ã¯è³æ Œæ
å ±ãŸãã¯ããŒã¯ã³ãæåŠãããããšãæå³ãã403ã¯ã¢ããªããã®è£œåã«ã¢ã¯ã»ã¹ã§ããªãããUPSãã¢ã«ãŠã³ãããããã¯ããããšã瀺ããŸãã404ã¯ãUPSããã®çªå·ã«å¯ŸããããŒã¿ããŸã æã£ãŠããªãããšã瀺ããŸãïŒã©ãã«ã¯æåã®ã¹ãã£ã³åŸãŸãã¯äœæåŸæ°æéã§è¡šç€ºãããŸãïŒã429ã¯ã¢ããªã®ã¯ã©ãŒã¿ã䜿ãæããããããšã瀺ããŸãã
å¶é: UPSã¯ã¢ããªããã³è£œåããšã«ã¯ã©ãŒã¿ãèšå®ãããã®æ°å€ãAPIãã¡ã€ã«ã«å ¬éããŸãã; 429ã¯åŸ æ©ããŠåŸã§å詊è¡ããããšãæå³ããŸãã1åã®åŒã³åºãã§1ã€ã®çªå·ããã©ããã³ã°ããã®ãææžåãããäœ¿çšæ³ã§ã: é·ããªã¹ããããã«ã«ãŒãããªãã§ãã ããã
åææ¡ä»¶: UPS_CLIENT_IDãUPS_CLIENT_SECRETãUPS_ACCOUNT_NUMBER
ã³ãã¯ã¿ãããŒã«ã«ã«ã€ã³ã¹ããŒã«ãã
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/storeãéããUPSãéžæããåææ¡ä»¶ã®äžã«ãªã¹ããããç°å¢å€æ°ã貌ãä»ããŸãã
å©çšå¯èœãªããŒã«
| ããŒã« | äœãããã |
|---|---|
ups_track_package | ãã©ããã³ã°çªå·ã§1ã€ã®UPSããã±ãŒãžã远跡ããŸã: çŸåšã®ã¹ããŒã¿ã¹ïŒã³ãŒããšèª¬æïŒããã¹ãŠã®ã¹ãã£ã³ïŒæ¥æã¯YYYYMMDDãããŒã«ã«æéã¯HHMMSS⊠|
ups_track_by_reference | ããªãã®UPSã¢ã«ãŠã³ãã®åºè·ããåºè·ã«ä»ããåç §çªå·ïŒæ³šæçªå·ãè«æ±æžçªå·ïŒã§èŠã€ããŠè¿œè·¡ããŸããåã⊠|
ups_track_shipment_packages | è€æ°ããã±ãŒãžã®UPSåºè·ã®ãã¹ãŠã®ããã±ãŒãžãããã®ãã©ããã³ã°çªå·ã®1ã€ãã远跡ããŸã: ããã±ãŒãžããšã«ãã©ããã³ã°çªå·ãçŸåšã®ã¹ããŒã¿ã¹ãæåŸã®âŠ |
ups_validate_address | ç±³åœãŸãã¯ããšã«ããªã³ã®ã¹ããªãŒãã¢ãã¬ã¹ãUPSããŒã¿ãšç
§åããŸããValidAddressIndicatorãAmbiguousAddressIndicator⊠|
ups_get_rate | åºè·ã®ããã®1ã€ã®UPSãµãŒãã¹ã®æéãèŠç©ãããŸããRateResponse.RatedShipmentãè¿ãããµãŒãã¹ã³ãŒããè«æ±ééã茞éããµãŒãã¹âŠ |
ups_shop_rates | 2ã€ã®äœæéã§å©çšå¯èœãªãã¹ãŠã®UPSãµãŒãã¹ãæ¯èŒããŸãããµãŒãã¹ããšã«1ã€ã®RatedShipmentãè¿ãããã®ã³ãŒããè«æ±âŠ |
ups_get_time_in_transit | 2ã€ã®å Žæéã§å©çšå¯èœãªUPSãµãŒãã¹ãemsResponse.servicesã®äžã«ãªã¹ãããŸã: serviceLevelããã³serviceLevelDescription⊠|
ups_find_locations | äœæè¿ãã®UPSãããããªãå ŽæãèŠã€ããŸã: UPSã¢ã¯ã»ã¹ãã€ã³ãã®ãã±ãŒã·ã§ã³ãUPSã¹ãã¢ã顧客ã»ã³ã¿ãŒãããããããã¯ã¹ãè¿ããã⊠|
ups_quote_landed_cost | åœéåºè·ã®ããã®é¢çšãçšéãä»²ä»ææ°æãåºè·åã«èŠç©ãããŸãïŒUPSçå°ã³ã¹ãèŠç©ããïŒãååããšã«è¿ããã⊠|
ups_recover_label | æ¢åã®åºè·ã®ã©ãã«ãå床ååŸããŸãããã©ããã³ã°çªå·ã§ãLabelRecoveryResponse.LabelResultsãè¿ããã©ãã«ã⊠|
ups_get_pickup_rate | äœæã§ã®ãªã³ã³ãŒã«UPSããã¯ã¢ããã®æéãèŠç©ãããŸãããäºçŽã¯ããŸãããPickupRateResponse.RateResultãè¿ããæéã¿ã€ã⊠|
ups_get_pending_pickups | ãŸã 宿œãããŠããªãUPSã¢ã«ãŠã³ãã§äºçŽãããããã¯ã¢ããããªã¹ãããŸããPickupPendingStatusResponse.PendingStatusãè¿ããããã¯ã¢ãã⊠|
ups_create_shipment | UPSåºè·ãšãã®ã©ãã«ãäœæããŸãããã®åŒã³åºããæåãããšãUPSã¯åºè·ãããªãã®ã¢ã«ãŠã³ãã«è«æ±ããŸãã®ã§ããã®ããŒã«ã¯âŠ |
ups_void_shipment | äœæãããããŸã ããã¯ã¢ãããããŠããªãUPSåºè·ããŸãã¯ãã®åäžããã±ãŒãžãç¡å¹ã«ããŸããå ã«æ»ãããšã¯ã§ããŸãã: ã©ãã«ã¯âŠ |
ups_create_pickup | ãªã³ã³ãŒã«UPSããã¯ã¢ãããäºçŽããŸã: ãã©ã€ããŒãæå®ãããæ¥ã«äœæã«æ¥ãŸããUPSã¯ããªãã®ã¢ã«ãŠã³ãã«ããã¯ã¢ããæéãè«æ±ããŸãã®ã§ããã®ããŒã«ã¯âŠ |
ups_cancel_pickup | ããã¯ã¢ãããªã¯ãšã¹ãçªå·ïŒPRNïŒã§äºçŽãããUPSããã¯ã¢ããããã£ã³ã»ã«ããŸããå ã«æ»ãããšã¯ã§ããŸãã; æ°ããããã¯ã¢ãããäºçŽããå¿ èŠããããŸããè¿ããã⊠|
äŸã®ããã³ãã
- "UPSããã±ãŒãž1Z999AA10123456784ã¯ã©ãã§ããïŒ"
- "ã·ã«ãŽ60601ãããªãŒã¹ãã£ã³78701ãŸã§ã®5ãã³ãã®ç®±ã®UPSæéãæ¯èŒããŠãã ããã"
- "1600 Amphitheatre Pkwy, Mountain View, CA 94043ã¯æå¹ãªäœæã§ããïŒ"
- "仿¥çºéããå Žåãã¢ãã©ã³ã¿ããUPSã°ã©ãŠã³ãããã±ãŒãžãã·ã¢ãã«ã«å°çããã®ã¯ãã€ã§ããïŒ"
- "10115ãã«ãªã³è¿ãã®UPSã¢ã¯ã»ã¹ãã€ã³ãã®ãã±ãŒã·ã§ã³ãèŠã€ããŠãã ããã"
次ã®ã¹ããã
ãã®ã¬ã€ãã¯åœ¹ã«ç«ã¡ãŸããã?