mcp-melhor-envio

@codespar/mcp-melhor-envio

Melhor Envio 用の MCP サーバー — 複数の配送業者の料金を比較できる配送アグリゲーター

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add melhor-envio -- npx @codespar/mcp-melhor-envio

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}

ツール（18）

ツール	用途
calculate_shipping	複数の配送業者の配送料金を計算します
create_shipment	配送注文を作成します
track_shipment	注文 ID で配送状況を追跡します
generate_label	注文の配送ラベルを生成します
list_agencies	場所の近くにある配送業者の持ち込み拠点を一覧表示します
cancel_shipment	配送注文をキャンセルします
get_balance	現在のアカウント残高を取得します
add_cart	一括決済用に配送注文をカートに追加します
checkout_cart	カート内のすべてのアイテムを決済します
preview_label	生成前に配送ラベルをプレビューします
print_label	ラベルの PDF を印刷／ダウンロードします
get_shipment	ID で配送注文の詳細を取得します
list_shipments	フィルターを指定してすべての配送注文を一覧表示します
get_store	ストア／会社の情報を取得します
search_agencies	サービスと場所で持ち込み拠点を検索します
create_address	送信者／受取人用の保存済み住所を作成します
list_services_available	配送ルートで利用可能な配送サービスを一覧表示します
get_tracking_history	イベントを含む配送追跡履歴全体を取得します

認証

Melhor Envio では、認証に Bearer トークンを使用します。

サンドボックス／テスト

Melhor Envio は sandbox.melhorenvio.com.br にサンドボックスを提供しています。使用するには MELHOR_ENVIO_SANDBOX=true を設定します。

認証情報を取得する

1. Melhor Envio にアクセスします
2. アカウントを作成します
3. API 設定に移動し、トークンを生成します
4. MELHOR_ENVIO_TOKEN 環境変数を設定します

環境変数

変数	必須	説明
MELHOR_ENVIO_TOKEN	はい	Melhor Envio の Bearer トークン
MELHOR_ENVIO_SANDBOX	いいえ	サンドボックスモードを使用するには "true" に設定します

ロードマップ

v0.2（予定）

• create_store — Melhor Envio にストアを作成します
• update_store — ストアの詳細を更新します
• get_receipt — 配送の領収書／ラベルを取得します
• list_companies — 利用可能な配送会社を一覧表示します
• get_invoice — 配送の請求書を取得します

v0.3（予定）

• batch_shipments — 1 回のリクエストで複数の配送を作成します
• detailed_reports — 詳細な配送レポートを生成します
• webhook_management — Webhook の登録、一覧表示、削除を行います

貢献をご希望ですか？PR を送信するか、ツールをリクエストしてください。

リンク

• Melhor Envio のウェブサイト
• Melhor Envio API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT