Packy Tracking MCP

आधिकारिक

मल्टी-कैरियर पैकेज ट्रैकिंग

GitHub

Packy Tracking MCP के साथ आप क्या कर सकते हैं?

ट्रैकिंग बनाएं — trackings_create के माध्यम से नई शिपमेंट पंजीकृत करने का अनुरोध करें, जिसमें बैच ट्रैकिंग नंबर शामिल हैं, ताकि पार्सल की निगरानी शुरू की जा सके।
ट्रैकिंग सूचीबद्ध करें और प्राप्त करें — सभी शिपमेंट देखने या किसी विशिष्ट ट्रैकिंग आईडी का विवरण प्राप्त करने के लिए trackings_list और trackings_get का उपयोग करें।
वेबहुक प्रबंधित करें — इवेंट सूचनाओं के लिए webhooks_create, webhooks_update, webhooks_list, और webhooks_delete के साथ वेबहुक एंडपॉइंट बनाएं, अपडेट करें, सूचीबद्ध करें या हटाएं।
समर्थित कूरियर सूचीबद्ध करें — अपने खाते के लिए उपलब्ध शिपिंग वाहक देखने हेतु couriers_list क्वेरी करें।
कूरियर स्वचालित रूप से पहचानें — ट्रैकिंग नंबर से वाहक की पहचान करने के लिए courier_detections_create का उपयोग करें।
ट्रैकिंग हटाएं — अपनी ट्रैकिंग सूची को साफ करने के लिए trackings_delete के माध्यम से अवांछित शिपमेंट रिकॉर्ड हटाएं।

दस्तावेज़

Packy Tracking MCP

Packy Tracking MCP संगत AI क्लाइंट्स को मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) के माध्यम से Packy Tracking API से जोड़ता है।

इस रिपॉजिटरी में सार्वजनिक एकीकरण दस्तावेज़ और कॉन्फ़िगरेशन उदाहरण शामिल हैं। MCP कार्यान्वयन स्वयं एक होस्टेड सेवा है; किसी स्थानीय सर्वर स्थापना की आवश्यकता नहीं है।

MCP सर्वर जुड़े Packy खाते की ओर से कार्य करता है। यह OAuth प्राधिकरण के दौरान चयनित API कुंजी के लिए उपलब्ध अनुमतियों से परे कोई अनुमति प्रदान नहीं करता है।

एंडपॉइंट

प्रोडक्शन MCP एंडपॉइंट:

https://mcp.parceltracking.app/mcp

प्रमाणीकरण

OAuth अनुशंसित प्रमाणीकरण विधि है। क्लाइंट Packy प्राधिकरण पृष्ठ खोलता है, जहाँ आप साइन इन करते हैं और एक सक्रिय API कुंजी चुनते हैं। एक्सेस स्वीकृत करने के बाद, MCP एप्लिकेशन उस कुंजी से जुड़ जाता है।

OAuth अनुमतियाँ MCP सर्वर द्वारा जाँची जाती हैं और उत्पाद API को अग्रेषित नहीं की जाती हैं। उत्पाद अनुरोध चयनित खाता API कुंजी के साथ किए जाते हैं।

एक्सेस मॉडल

OAuth सहमति के दौरान, उपयोगकर्ता वर्तमान Packy खाते से संबंधित एक सक्रिय API कुंजी चुनता है।
Allow के बाद MCP एप्लिकेशन उस चयनित कुंजी से बंध जाता है।
कई MCP एप्लिकेशन एक ही API कुंजी से बंधे हो सकते हैं; प्रत्येक एप्लिकेशन का अपना OAuth प्राधिकरण होता है।
एक एप्लिकेशन को डिस्कनेक्ट करने से केवल उस एप्लिकेशन का OAuth एक्सेस रद्द होता है और API कुंजी निष्क्रिय नहीं होती या अन्य एप्लिकेशन प्रभावित नहीं होते।
MCP सर्वर Packy API को कार्रवाई अग्रेषित करने से पहले OAuth प्राधिकरण और कुंजी स्थिति को मान्य करता है।

Claude के साथ OAuth

कनेक्ट करने से पहले, https://lk.parceltracking.app पर साइन इन करें, एक API कुंजी बनाएं, और सुनिश्चित करें कि यह सक्रिय है।

Claude Settings → Connectors → Add custom connector खोलें।
MCP एंडपॉइंट दर्ज करें:
```
https://mcp.parceltracking.app/mcp
```
OAuth प्रमाणीकरण सक्षम रखें और Claude को स्वचालित रूप से क्लाइंट पंजीकृत करने की अनुमति दें।
ब्राउज़र में Packy में साइन इन करें। एक छोटा Continue authorization पृष्ठ स्वचालित रूप से पुनर्निर्देशित होता है; क्लिक करने के लिए कुछ नहीं है। लिंक एकल-उपयोग है और दो मिनट के बाद समाप्त हो जाता है।
Allow access? पर, वह सक्रिय API कुंजी चुनें जिसका उपयोग यह कनेक्शन करेगा और Allow चुनें।
Claude पर लौटें और पुष्टि करें कि कनेक्टर जुड़ा हुआ है।

OAuth एक्सेस टोकन अल्पकालिक होते हैं और स्वचालित रूप से नवीनीकृत होते हैं। यदि प्रवाह विफल हो जाता है, तो पिछले प्राधिकरण URL को फिर से खोलने के बजाय Claude से एक नया कनेक्शन प्रयास शुरू करें।

Codex के साथ OAuth

codex mcp add packy-tracking-mcp \
  --url https://mcp.parceltracking.app/mcp \
  --oauth-resource https://mcp.parceltracking.app/mcp

Codex द्वारा मुद्रित प्राधिकरण URL खोलें, Packy में साइन इन करें, एक सक्रिय API कुंजी चुनें, और Allow चुनें।

API कुंजी के साथ Cursor

प्रलेखित Cursor सेटअप एक API कुंजी का उपयोग करता है। Cursor के प्रोजेक्ट या उपयोगकर्ता mcp.json में सर्वर URL और Authorization: Bearer <YOUR_API_KEY> हेडर जोड़ें, फिर MCP/एजेंट को पुनरारंभ करें। देखें examples/cursor/mcp.json।

API-कुंजी फ़ॉलबैक

जो क्लाइंट MCP OAuth का समर्थन नहीं करते हैं वे सीधे Packy API कुंजी का उपयोग कर सकते हैं। API कुंजी वही कुंजी है जो नियमित Packy Tracking API के साथ उपयोग की जाती है।

{
  "mcpServers": {
    "packy-tracking-mcp": {
      "url": "https://mcp.parceltracking.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

<YOUR_API_KEY> को Packy खाते की एक सक्रिय कुंजी से बदलें। कुंजी को कभी प्रकाशित या साझा न करें।

सर्वर समकक्ष हेडर भी स्वीकार करता है:

X-API-Key: <YOUR_API_KEY>

OAuth प्रवाह अनुशंसित है क्योंकि कुंजी Packy में चुनी जाती है और क्लाइंट कॉन्फ़िगरेशन में कॉपी नहीं की जाती है।

उपकरण

उपकरण	ट्रैकिंग API संचालन
`trackings_create`	`POST /v1/trackings`
`trackings_list`	`GET /v1/trackings`
`trackings_get`	`GET /v1/trackings/{id}`
`trackings_delete`	`DELETE /v1/trackings/{id}`
`couriers_list`	`GET /v1/couriers`
`courier_detections_create`	`POST /v1/courier-detections`
`webhooks_list`	`GET /v1/webhooks`
`webhooks_create`	`POST /v1/webhooks`
`webhooks_update`	`PATCH /v1/webhooks/{id}`
`webhooks_delete`	`DELETE /v1/webhooks/{id}`

संग्रहीत डेटा को बदलने वाले संचालन हैं trackings_create, trackings_delete, webhooks_create, webhooks_update, और webhooks_delete। इन्हें केवल तभी चलाएं जब आप स्पष्ट रूप से खाता डेटा संशोधित करने का इरादा रखते हैं।

केवल trackings_create क्रेडिट की खपत करता है: प्रति अद्वितीय ट्रैकिंग नंबर एक क्रेडिट, जिसमें बैच में प्रत्येक ट्रैकिंग नंबर शामिल है। कूरियर, पहचान, पढ़ने, हटाने और वेबहुक उपकरण क्रेडिट की खपत नहीं करते हैं। MCP को ट्रैकिंग API से अलग से बिल नहीं किया जाता है।

डिस्कनेक्ट और निरसन

एक MCP एप्लिकेशन रोकने के लिए:

https://lk.parceltracking.app पर Packy खाते में साइन इन करें।
Connected applications खोलें।
एप्लिकेशन चुनें और Disconnect / Revoke चुनें।

किसी एप्लिकेशन को रद्द करने से उस OAuth कनेक्शन से नए अनुरोध रुक जाते हैं। यह API कुंजी को स्वयं निष्क्रिय नहीं करता है, और उसी कुंजी से जुड़े अन्य एप्लिकेशन स्वतंत्र रहते हैं।

आप API keys अनुभाग में API कुंजी को निष्क्रिय या बदल भी सकते हैं। यह उस कुंजी का उपयोग करने वाले हर एकीकरण को प्रभावित करता है, जिसमें MCP एप्लिकेशन शामिल हैं।

सेवा सत्यापित करें

इन सार्वजनिक लाइवनेस एंडपॉइंट्स को API कुंजी की आवश्यकता नहीं है:

curl -fsS https://mcp.parceltracking.app/health
curl -fsS https://mcp.parceltracking.app/ready

अपेक्षित प्रतिक्रियाएँ:

{"status":"ok"}

{"status":"ok","checks":{"api_gateway":"healthy"}}

/ready यह भी पुष्टि करता है कि MCP सेवा अपने API गेटवे तक पहुँच सकती है।

समस्या निवारण

यदि कोई उपकरण दिखाई नहीं देता है, तो एंडपॉइंट जांचें, सर्वर नाम packy-tracking-mcp का उपयोग करें, और क्लाइंट को पुनरारंभ करें।
यदि OAuth पूरा नहीं होता है, तो इच्छित Packy खाते में साइन इन करें, पुष्टि करें कि उसमें एक सक्रिय API कुंजी है, और एक नया कनेक्शन प्रयास शुरू करें।
यदि एक्सेस अस्वीकृत है, तो सत्यापित करें कि चयनित कुंजी सक्रिय है और इच्छित खाते से संबंधित है।
यदि एक्सेस तुरंत रोका जाना चाहिए, तो Connected applications में एप्लिकेशन को डिस्कनेक्ट करें या API कुंजी निष्क्रिय करें।

लिंक

Packy वेबसाइट: https://packyapp.com
Packy खाता: https://lk.parceltracking.app
MCP एंडपॉइंट: https://mcp.parceltracking.app/mcp

सहायता

खाता और सहायता अनुरोधों के लिए, ईमेल करें wasup@clickor.net।

ट्रैकिंग API और MCP एकीकरण के बारे में तकनीकी प्रश्नों के लिए, Discord पर Packy Developer Community से जुड़ें। सभी आधिकारिक संपर्क विकल्प https://packyapp.com/contacts पर उपलब्ध हैं।

रिपॉजिटरी का दायरा

इस रिपॉजिटरी में केवल एकीकरण दस्तावेज़ शामिल हैं। इसमें Packy API स्रोत कोड, क्रेडेंशियल, API कुंजी, OAuth टोकन या तैनाती कॉन्फ़िगरेशन शामिल नहीं है।