æŠèŠ
è·äž»åãã®UPS APIïŒè¿œè·¡çªå·ãåç §çªå·ã§è·ç©ã远跡ããç±³åœã®äœæãæ€èšŒããæéã茞éæéãæ¯èŒãããããããªãããã³ã¢ã¯ã»ã¹ãã€ã³ãã®å ŽæãèŠã€ããçéžã³ã¹ããèŠç©ãããã©ãã«ãå埩ããããã¯ã¢ãããèŠç©ãããŸããåºè·ã®äœæãç¡å¹åãããã¯ã¢ããã¯å«ãŸããŸããããªãã«ãªã£ãŠããŸããUPSéçºè ããŒã¿ã«ããã®OAuthã¯ã©ã€ã¢ã³ãIDãšã·ãŒã¯ã¬ããã
ã¬ã€ãä»ãã»ããã¢ãã
UPS ã Claude ã« 2 åã§æ¥ç¶
AnythingMCP Cloud ã®ç¡æãã©ã€ã¢ã«ãå§ããã¬ã€ãä»ãã»ããã¢ããã§ UPS ãæ¥ç¶ããŠãMCP URL ã Claude ã«è¿œå ããŸããã³ãŒãããµãŒããŒã®éçšãäžèŠã§ãã
ã¯ã¬ãžããã«ãŒãäžèŠ Â· 7æ¥éã®è©Šçš · ã»ã«ããã¹ãã®éžæè¢ãã
AnythingMCP 㯠Claude ã®ã³ãã¯ã¿ãã£ã¬ã¯ããªã«æ²èŒãããŠããŸããã¯ã³ã¯ãªãã¯ã§ Claude ã«è¿œå (æ°ããã¿ãã§éããŸã)ãããµã€ã³ã€ã³ã㊠Claude ã䜿ãã MCP ãµãŒããŒãéžãã§ãã ããã
ããèããŠã¿ãã
UPS ã®ãµã³ãã«ããã³ãã
ããã³ãããã¯ãªãã¯ã§ã³ããŒãClaude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw ã«è²Œãä»ããŠããã®ã³ãã¯ã¿ãŒã§å®è¡ã§ããŸãã
Claude 㯠AI ã®ãã誀ãããšããããŸããåçãã確èªãã ããã
ð¡ ã€ã³ã¹ããŒã«äžèŠïŒcloud.anythingmcp.comã«çŽæ¥ã¢ã¯ã»ã¹ã ãµã€ã³ã€ã³ããŠãConnectors â UPSãã¯ãªãã¯ããèªèšŒæ å ±ã貌ãä»ããMCP APIããŒãçæããã°å®äºã§ããDockerã
git cloneãããŒã«ã«ãµãŒããŒãäžèŠã§ãã
UPS + Claude
è·äž»åãã®UPS APIïŒè¿œè·¡çªå·ãåç §çªå·ã§è·ç©ã远跡ããç±³åœã®äœæãæ€èšŒããæéã茞éæéãæ¯èŒãããããããªãããã³ã¢ã¯ã»ã¹ãã€ã³ãã®å ŽæãèŠã€ããçéžã³ã¹ããèŠç©ãããã©ãã«ãå埩ããããã¯ã¢ãããèŠç©ãããŸããåºè·ã®äœæãç¡å¹åãããã¯ã¢ããã¯å«ãŸããŸããããªãã«ãªã£ãŠããŸããUPSéçºè ããŒã¿ã«ããã®OAuthã¯ã©ã€ã¢ã³ãIDãšã·ãŒã¯ã¬ããã
åææ¡ä»¶
ã³ãã¯ã¿ã«çµã¿èŸŒãŸããå®å šãªã»ããã¢ããæé ãåç §ããŠãã ããïŒã³ãã¯ã¿ãéžæãããšã¢ããªå ã¹ãã¢ã«è¡šç€ºãããŸãïŒããã®ã³ãã¯ã¿ã«å¿ èŠãªç°å¢å€æ°ã¯æ¬¡ã®ãšããã§ãïŒ
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
ã¹ããã1 â èªèšŒæ å ±ãååŸ
èšå®ã«ã¯çŽ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ã€ã®çªå·ã远跡ããã®ãææžåãããäœ¿çšæ³ã§ãïŒé·ããªã¹ããè¿ éã«ã«ãŒãããªãã§ãã ããã
ã¹ããã2 â ã¢ããã¿ãŒãã€ã³ã¹ããŒã«
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
ã¹ããã3 â Claudeã«ã³ãã¯ã¿ã远å
ããªãã®ãµãŒããŒURLïŒAnythingMCPã§ãMCPãµãŒã㌠â ãã®ã³ãã¯ã¿ããããµãŒããŒãéãããã®URLãã³ããŒããŸãïŒ
https://cloud.anythingmcp.com/mcp/âŠïŒããã®ã¬ã€ãã§YOUR_SERVER_IDã衚瀺ãããå Žæã§äœ¿çšããŸãã
æšå¥šãã¹ïŒclaude.ai webã§ãèšå®ãã¡ã€ã«ãç·šéããã«åäœããŸãã
- Claudeã§ãPluginsïŒäžéšã®ãã©ã³ã§ã¯ãŸã CustomizeïŒâ ConnectorsãéããŸãã
- + Addãã¯ãªãã¯ããæ¬¡ã«Add custom connectorãéžæããŸãã
- ååãå
¥åããŸãïŒäŸïŒ
UPSïŒãšããªã¢ãŒãMCPãµãŒããŒã®URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDãå ¥åããæ¬¡ã«Continue ãã¯ãªãã¯ããæ€åºãããèšå®ã®ãŸãŸãããäžåºŠ Continue ãã¯ãªãã¯ããŸãã - Sign in now ãéžãã§ Add ãã¯ãªãã¯ããAnythingMCPã«ãµã€ã³ã€ã³ïŒOAuthïŒããŠã¢ã¯ã»ã¹ãèš±å¯ããŸãã
以äžã®ãã¹ãŠã®ããŒã«ããã£ããã«è¡šç€ºãããŸãïŒããã³ãããå ¥åãå§ããŠãã ããã
å©çšå¯èœãªããŒã«
| ããŒã« | æ©èœ |
|---|---|
ups_track_package | 远跡çªå·ã§1ã€ã®UPSããã±ãŒãžã远跡ããŸãïŒã³ãŒããšèª¬æä»ãã®çŸåšã®ç¶æ ããã¹ãŠã®ã¹ãã£ã³ïŒYYYYMMDD圢åŒã®æ¥ä»ãHHMMSS圢åŒã®ããŒã«ã«æé⊠|
ups_track_by_reference | ããªãã®UPSã¢ã«ãŠã³ãã®åºè·ããåºè·ã«ä»ããåç §çªå·ïŒæ³šæçªå·ãè«æ±æžçªå·ïŒã§èŠã€ããŠè¿œè·¡ããŸããåã⊠|
ups_track_shipment_packages | è€æ°ããã±ãŒãžã®UPSåºè·ã®ãã¹ãŠã®ããã±ãŒãžããããããã®è¿œè·¡çªå·ãã远跡ããŸãïŒããã±ãŒãžããšã«è¿œè·¡çªå·ãçŸåšã®ç¶æ ãæåŸâŠ |
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ã¢ã¯ã»ã¹ãã€ã³ãã®å ŽæãèŠã€ããŠãã ããã"
ãããã質å
Claude CodeãšClaude Desktopã®äž¡æ¹ã§åäœããŸããïŒ ã¯ããäž¡æ¹ãšãhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDãæããŸãã
UPSã®èªèšŒæ
å ±ã¯ã©ãããæ¥ãŸããïŒ UPSéçºè
ããŒã¿ã«ïŒdeveloper.ups.comïŒã§ãè·äž»ã¢ã«ãŠã³ããææããups.comãããã¡ã€ã«ã§äœæãããã¢ããªããååŸããŸãã远跡ãäœææ€èšŒãæéã茞éæéããã±ãŒã¿ãŒã®è£œåã远å ããæ¬¡ã«ã¯ã©ã€ã¢ã³ãIDãšã¯ã©ã€ã¢ã³ãã·ãŒã¯ã¬ãããã³ããŒããŸããUPS_ACCOUNT_NUMBERã¯ããªãã®6æåã®è·äž»çªå·ã§ãã
äœãã«ããŒããäœãã«ããŒããªãã®ã§ããïŒ çªå·ãŸãã¯åç §ã«ãã远跡ãç±³åœäœæã®æ€èšŒïŒç±³åœããã³ããšã«ããªã³ã®ã¿ïŒãæéããã³èŒžéæéããããããªãããã³ã¢ã¯ã»ã¹ãã€ã³ãã®å Žæãçéžã³ã¹ãã®èŠç©ãããã©ãã«ã®å埩ããã³ããã¯ã¢ããã®èŠç©ãããã«ããŒããŸããããã¯æ¬çªçšã®è³æ Œæ å ±ã䜿çšããUPSãã¹ãã·ã¹ãã ã¯äœ¿çšããŸããã
åºè·ãäœæããããããã¯ã¢ãããäºçŽãããã§ããŸããïŒ ups_create_shipmentãups_void_shipmentãups_create_pickupãããã³ups_cancel_pickupã¯ãªãã«ã€ã³ã¹ããŒã«ãããŠãããè²»çšãããããŸããAIããããã䜿çšããå¿
èŠãããå Žåã®ã¿ãã¢ããªã«é
éããã³ããã¯ã¢ããã®è£œåã远å ããã³ãã¯ã¿ããŒãžã§ãªã³ã«ããŠãã ããã
次ã®ã¹ããã
- ã³ãã¯ã¿ã®ã©ã³ãã£ã³ã°ããŒãž
- ChatGPTã«æ¥ç¶
- Cursorã«æ¥ç¶
- Geminiã«æ¥ç¶
- Meta Museã«æ¥ç¶
- Microsoft Copilotã«æ¥ç¶
ãã®ã¬ã€ãã¯åœ¹ã«ç«ã¡ãŸããã?