mcpField
M
mcp-coordinadora

mcp-coordinadora

ローカル
github.com/codespar地図・旅行2754 週間前に更新
リポジトリ

mcp-coordinadora について

mcp-coordinadora は、国内外の配送を手がけるコロンビアの宅配・物流会社 Coordinadora 向けの MCP サーバーです。アルファ版で、エンドポイントは実環境で十分に検証されていません。

主な機能

  1. 01荷物（ガイア）の作成、参照、キャンセル
  2. 02追跡と追跡履歴の取得
  3. 03配送料金とサービス種別の照会
  4. 04集荷の予約とキャンセル
  5. 05一括作成と返品伝票の作成

活用シーン

  1. 01エージェントからコロンビア向け注文の出荷と追跡を実行
  2. 02複数の伝票をまとめて作成
  3. 03対応エリアの確認と集荷の手配

MCP 対応

本プロジェクトは MCP サーバーであり、Coordinadora API を呼び出す 19 のツールを MCP クライアントに提供します。出荷、集荷、料金、対応エリアを扱えます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-coordinadora": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coordinadora"
      ],
      "env": {
        "COORDINADORA_API_KEY": "<COORDINADORA_API_KEY>",
        "COORDINADORA_NIT": "<COORDINADORA_NIT>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-coordinadora
設定が必要な環境変数
COORDINADORA_API_KEYシークレットAPI key for Coordinadora
COORDINADORA_NITCompany NIT number

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-coordinadora0.2.0-alpha.3

ツール

19

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
senderobjectはい送信者情報
sender.nitstringいいえ送信者の NIT/CC
sender.namestringはい送信者名
sender.phonestringはい送信者の電話番号
sender.addressstringはい送信元アドレス
packagesarrayはい発送する荷物
recipientobjectはい受取人情報
recipient.nitstringいいえ受取人の NIT/CC
recipient.namestringはい受取人名
recipient.phonestringはい受取人の電話番号
recipient.addressstringはい受取人のアドレス
origin_citystringはい発送元の都市の DANE コード
payment_typestringいいえ支払いタイプ（prepaid、collect、contra_entrega）
service_typestringいいえサービス種別（standard、express、same_day）
destination_citystringはい配送先の都市の DANE コード

詳細

MCP Coordinadora

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

Coordinadora 向けの MCP サーバーです。Coordinadora はコロンビア最大級の宅配・物流企業で、国内および国際配送サービスを提供しています。

クイックスタート

# Set your credentials
export COORDINADORA_API_KEY="your-api-key"
export COORDINADORA_NIT="your-nit"

# Run via stdio
npx tsx packages/colombia/coordinadora/src/index.ts

# Run via HTTP
npx tsx packages/colombia/coordinadora/src/index.ts --http

環境変数

変数必須説明
COORDINADORA_API_KEYはいCoordinadora の API キー
COORDINADORA_NITはい会社の NIT 番号
MCP_HTTPいいえHTTP トランスポートを有効にするには "true" に設定します
MCP_PORTいいえHTTP ポート（デフォルト：3000）

ツール（19）

ツール用途
create_shipment新しい配送を作成します
get_shipmentガイド番号で配送の詳細を取得します
track_shipmentガイド番号で配送を追跡します
get_rates配送料金／見積もりを取得します
list_cities配送可能な都市を一覧表示します
create_pickup指定住所での集荷を予約します
get_coverage場所がサービス提供エリア内か確認します
cancel_shipment配送をキャンセルします
get_guia_pdfguía ラベルを PDF としてダウンロードします（base64 または URL を返します）
get_pickupID で集荷（recolección）の詳細を取得します
cancel_pickup予約済みの集荷（recolección）をキャンセルします
get_tracking_historyguía の追跡イベント履歴全体を取得します
list_shipments_by_date指定した期間内に作成された guías を一覧表示します
validate_coverage都市と郵便番号の組み合わせがサービス提供エリア内か検証します
list_services指定した発送元／配送先で利用可能なサービス種別を一覧表示します
list_officesCoordinadora の支店（oficinas）を一覧表示します
create_return逆物流の返品 guía を作成します
list_returns既存の返品 guías を一覧表示します
create_bulk_guias1 回の一括処理で複数の guías を作成します

認証

API キー＋NIT ヘッダー認証を使用します。API キーと会社の NIT は、すべてのリクエストでカスタムヘッダーとして送信されます。

API リファレンス

エンタープライズ

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

認証

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

  • COORDINADORA_API_KEY (必須、シークレット) — Coordinadora の API キー
  • COORDINADORA_NIT (必須) — 会社の NIT 番号

認証情報はプロバイダーの開発者ポータルで発行してください：https://coordinadora.docs.apiary.io。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。