mcp-andreani

MCP Andreani

アルファリリース — alpha npm dist-tag で公開されています。エンドポイントパスは公開ドキュメントおよび BACEN／プロバイダーの規約に準拠していますが、実環境での検証は完了していません。0.x.x-alpha の間は正確なバージョンを固定してください。npm install <pkg>@alpha でインストールしてください。

Andreani 用の MCP サーバーです。国内および国際配送サービスを提供する、アルゼンチン最大の宅配・物流会社です。

クイックスタート

# Set your credentials
export ANDREANI_API_KEY="your-api-key"
export ANDREANI_USER="your-username"
export ANDREANI_PASSWORD="your-password"

# Run via stdio
npx tsx packages/argentina/andreani/src/index.ts

# Run via HTTP
npx tsx packages/argentina/andreani/src/index.ts --http

環境変数

変数	必須	説明
ANDREANI_API_KEY	はい	Andreani の API キー
ANDREANI_USER	はい	認証用のユーザー名
ANDREANI_PASSWORD	はい	認証用のパスワード
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" に設定
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（18）

ツール	用途
create_shipment	新しい配送を作成
get_shipment	ID で配送の詳細を取得
track_shipment	追跡番号で配送を追跡
get_rates	配送料金／見積もりを取得
list_branches	Andreani の支店／営業所を一覧表示
create_label	配送の送り状を生成
get_tracking_history	配送の追跡履歴全体を取得
cancel_shipment	配送をキャンセル
get_label_pdf	送り状を PDF（Base64 エンコード）としてダウンロード
list_tracking_by_date	指定した期間内の契約に関する追跡イベントを一覧表示
validate_postal_code	郵便番号の配送対象範囲を検証し、利用可能なサービスを一覧表示
create_pickup	集荷依頼（retiro）を作成
list_pickups	集荷依頼を一覧表示
cancel_pickup	集荷依頼をキャンセル
create_return	返品配送（逆物流／devolución）を作成
list_returns	逆物流の配送（返品）を一覧表示
list_products	アカウントで利用可能な契約済み商品／サービスを一覧表示
get_invoice	請求情報を取得

認証

Bearer トークン認証を使用します。サーバーはユーザー名とパスワードでログインして JWT トークンを取得し、そのトークンを以降の API 呼び出しで使用します。API キーヘッダーも含まれます。

API リファレンス

• Andreani API ドキュメント

---

エンタープライズ

エージェントの支払いにガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、次の環境変数を設定してください。

• ANDREANI_API_KEY (必須、シークレット) — Andreani の API キー
• ANDREANI_USER (必須) — Andreani のユーザー名
• ANDREANI_PASSWORD (必須、シークレット) — Andreani のパスワード

プロバイダーの開発者ポータルで認証情報を発行してください：https://developers.andreani.com。

ライセンス

MIT