Packy Tracking MCP

公式

マルチキャリアの荷物追跡

GitHub

Packy Tracking MCPで何ができますか？

追跡を作成 — trackings_create を使用して新しい荷物の登録を依頼し、バッチ追跡番号を含めて監視を開始します。
追跡の一覧表示と取得 — trackings_list と trackings_get を使用して、すべての荷物を表示するか、特定の追跡IDの詳細を取得します。
Webhookを管理 — webhooks_create、webhooks_update、webhooks_list、webhooks_delete を使用して、イベント通知用のWebhookエンドポイントを作成、更新、一覧表示、削除します。
対応する運送会社を一覧表示 — couriers_list を照会して、アカウントで利用可能な配送業者を確認します。
運送会社を自動検出 — courier_detections_create を使用して、追跡番号から運送会社を特定します。
追跡を削除 — trackings_delete を使用して不要な荷物記録を削除し、追跡リストを整理します。

ドキュメント

Packy Tracking MCP

Packy Tracking MCP は、Model Context Protocol（MCP）を通じて、対応するAIクライアントを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キーを1つ選択します。
MCPアプリケーションは、許可後に選択されたキーにバインドされます。
複数のMCPアプリケーションを同じAPIキーにバインドできます。各アプリケーションには独自のOAuth認可があります。
1つのアプリケーションを切断すると、そのアプリケーションのOAuthアクセスのみが取り消され、APIキーが無効化されたり、他のアプリケーションに影響したりすることはありません。
MCPサーバーは、アクションをPacky APIに転送する前に、OAuth認可とキーのステータスを検証します。

ClaudeでのOAuth

接続する前に、https://lk.parceltracking.appにサインインし、APIキーを作成して、アクティブであることを確認してください。

Claudeの設定 → コネクタ → カスタムコネクタの追加を開きます。
MCPエンドポイントを入力します:
```
https://mcp.parceltracking.app/mcp
```
OAuth認証を有効にしたまま、Claudeがクライアントを自動登録できるようにします。
ブラウザでPackyにサインインします。短い認可の続行ページが自動的にリダイレクトされます。クリックするものはありません。リンクは一度きりで、2分後に期限切れになります。
**アクセスを許可しますか?**で、この接続で使用するアクティブなAPIキーを選択し、許可を選択します。
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キーを選択し、許可を選択します。

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>

キーがPackyで選択され、クライアント設定にコピーされないため、OAuthフローが推奨されます。

ツール

ツール	Tracking 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のみです。一意の追跡番号ごとに1クレジット（バッチ内の各追跡番号を含む）です。宅配業者、検出、読み取り、削除、およびWebhookツールはクレジットを消費しません。MCPはTracking APIとは別に請求されません。

切断と取り消し

1つのMCPアプリケーションを停止するには:

https://lk.parceltracking.appでPackyアカウントにサインインします。
接続済みアプリケーションを開きます。
アプリケーションを選択し、切断 / 取り消しを選択します。

アプリケーションを取り消すと、そのOAuth接続からの新しいリクエストが停止します。APIキー自体は無効化されず、同じキーに接続されている他のアプリケーションは独立したままです。

APIキーセクションで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キーがあることを確認して、新しい接続試行を開始してください。
アクセスが拒否された場合は、選択したキーがアクティブで、目的のアカウントに属していることを確認してください。
アクセスを直ちに停止する必要がある場合は、接続済みアプリケーションでアプリケーションを切断するか、APIキーを無効化してください。

リンク

Packyウェブサイト: https://packyapp.com
Packyアカウント: https://lk.parceltracking.app
MCPエンドポイント: https://mcp.parceltracking.app/mcp

サポート

アカウントおよびサポートリクエストについては、wasup@clickor.netまでメールでお問い合わせください。

Tracking APIおよびMCP統合に関する技術的な質問については、DiscordのPacky Developer Communityに参加してください。すべての公式連絡先はhttps://packyapp.com/contactsで確認できます。

リポジトリの範囲

このリポジトリには統合ドキュメントのみが含まれています。Packy APIのソースコード、資格情報、APIキー、OAuthトークン、またはデプロイ設定は含まれていません。