Packy Tracking MCP

公式

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

GitHubこのMCPを試すスポンサー

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

トラッキングの作成 — trackings_create を使用して新しい配送の登録を依頼し、バッチ追跡番号を含めて配送の監視を開始します。
トラッキングの一覧表示と確認 — trackings_list と trackings_get を使用して、すべての配送を表示したり、特定のトラッキングIDの詳細を取得したりします。
ウェブフックの管理 — webhooks_create、webhooks_update、webhooks_list、webhooks_delete を使用して、配達イベント通知用のウェブフックエンドポイントを作成、更新、一覧表示、削除します。
運送会社の検出 — courier_detections_create を使用して、完全なトラッキングレコードを作成する前に、追跡番号の運送会社を特定します。
対応運送会社の一覧表示 — couriers_list をクエリして、Packy Tracking API で利用可能な配達運送会社を確認します。

ドキュメント

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統合に関する技術的な質問については、Packy Developer Community on Discordに参加してください。すべての公式連絡先はhttps://packyapp.com/contactsで利用できます。

リポジトリの範囲

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