(freight Marketplace) Api Cargoffer

欧州貨物マーケットプレイス運用向け MCP レイヤー

貨物マーケットプレイス向け MCP サーバーです。AI エージェント（Claude Desktop、Cursor、Cline、Continue など）を Cargoffer Bolsa de Carga の貨物マーケットプレイス API に接続し、LLM が自然言語だけで貨物の検索、オークションの管理、貨物への入札、配送の追跡、CMR 運送状の作成を行えるようにします。

どのような問題を解決しますか？ 貨物ブローカーや運送業者は、荷物掲示板のウェブサイトを何時間も更新し続け、タブ間でデータをコピーし、オークションの更新情報を手作業で投稿しています。この MCP サーバーは Cargoffer の貨物マーケットプレイス全体を呼び出し可能な AI ツールに変えます。エージェントは、利用可能な貨物の検索、オークションの作成、入札の受諾、トラックの登録、法的文書の作成を、ひとつの会話の流れで行えます。

何が異なりますか？ 画面スクレイピング型の荷物掲示板や単一目的の API とは異なり、マーケットプレイスのライフサイクル全体を構造化された MCP ツールとして公開します。オークション（11 ツール）、住所（4）、トレーラー／トラック運転手（4）、車両（4）、配送（6）、認証（2）に対応しています。AI エージェントはデータを読み取るだけでなく、取引も実行できます。オークションの公開、入札の受諾、CMR PDF の作成が可能です。読み取り専用のダッシュボードではなく、読み書き可能な運用レイヤーです。

どのような連携が可能になりますか？ MCP 対応クライアントであれば、35 種類以上の貨物マーケットプレイスツールを呼び出して、貨物の検索、企業リソースの管理、オークションへの参加、出荷書類の作成をすべて LLM との自然言語での会話を通じて行えます。

「簡単な連携」とは、具体的にはどういう意味ですか？ リポジトリをクローンし、API_KEY=your-key を設定して node src/server.js を実行し、MCP クライアントに JSON ブロックをひとつ設定するだけです。SDK のインストール、データベースのセットアップ、OAuth の複雑な手順は不要です。AI エージェントはすぐに欧州の荷物掲示板へ荷物を投稿し、入札できます。

---

この MCP が存在する理由

欧州の貨物スポット市場は、互いに互換性のない数十もの荷物掲示板を通じて運営されており、それぞれに独自のログイン、UI、データ形式があります。配車担当者は複数の掲示板を手作業で確認し、貨物の詳細をスプレッドシートにコピー＆ペーストし、WhatsApp やメールで交渉を調整しています。このプロセスは遅く、ミスが起こりやすく、自動化からも見えません。

この MCP サーバーは、統合された欧州道路輸送貨物マーケットプレイスである Cargoffer Bolsa de Carga API を、LLM のファーストクラスツールとして公開します。AI エージェントは、利用可能な貨物の検索、オークションの作成と公開、入札の管理、企業の車両や運転手の登録、配送状況の追跡、CMR 運送状の作成を行えます。AI アシスタントを、物流書類の自動化とマーケットプレイスでの取引を実行できる、運用可能な貨物業務デスクへと変えます。

AI エージェントの機能

機能	AI ができること
貨物の監視	稼働中の貨物オークションをリアルタイムで検索・絞り込み
入札管理	利用可能な貨物に自動で入札
住所関連業務	配送先住所と場所を管理
車両群のマッチング	利用可能な車両とトラック運転手を貨物にマッチング
配送追跡	すべての出荷の配送状況を追跡

---

MCP の機能

• 6 つの機能領域にわたる 35 個以上の MCP ツール — オークション、住所、トレーラー、車両、配送、認証
• オークションのライフサイクル全体 — 作成、公開、一覧表示、更新、削除、入札の受諾、お気に入りの管理
• アドレス帳の管理 — 再利用可能な会社所在地（集荷、配送、デポ）
• トレーラー／トラック運転手の登録管理 — 車両群の輸送能力とドライバーの割り当てを管理
• 車両の管理 — 寸法、積載量、認証情報を含むトラックの登録
• 配送の追跡 — 配送の一覧表示、詳細の取得、CMR PDF のダウンロード、配送メッセージの送信
• CMR 運送状の生成 — 配送記録から直接、運送契約に署名してロック
• JWT ベースの認証 — サーバーがログイントークンを透過的に処理
• HTTP 上の JSON-RPC 2.0 — 標準の MCP トランスポート
• Node.js 18+ 以外の実行時依存関係なし — Docker、データベース、ビルド手順は不要

---

ツール

オークション（11 個のツール）

有効なオークションの一覧表示、オークションの取得／作成／更新／削除、オークションの公開、入札の受諾、CMR への署名、お気に入りの管理。

|| ツール | 説明 | |------|-------------| | bolsa_auctions_active | 有効な貨物オークションを一覧表示 | | bolsa_auctions_get | ID でオークションの詳細を取得 | | bolsa_auctions_create | 新しいオークションを作成 | | bolsa_auctions_update | 既存のオークションを更新 | | bolsa_auctions_delete | オークションを削除 | | bolsa_auctions_publish | オークションをマーケットプレイスに公開 | | bolsa_auctions_accept_bid | オークションの入札を受諾 | | bolsa_auctions_sign_cmr | オークションの CMR 運送状に署名 | | bolsa_auctions_favorites | お気に入りのオークションを管理 |

国（1 個のツール）

検索前に、マーケットプレイスでの操作が有効になっている国を確認します。

|| ツール | 説明 | |------|-------------| | bolsa_countries_enabled | 検索で有効な国を一覧表示 |

住所（4 個のツール）

ツール	説明
bolsa_addresses_list	すべての住所を一覧表示
bolsa_addresses_create	新しい住所を作成
bolsa_addresses_update	住所を更新
bolsa_addresses_delete	住所を削除

トレーラー／トラック運転手（4 個のツール）

ツール	説明
bolsa_trailers_list	すべてのトレーラーを一覧表示
bolsa_trailers_create	新しいトレーラーを登録
bolsa_trailers_update	トレーラー情報を更新
bolsa_trailers_delete	トレーラーを削除

車両（4 個のツール）

ツール	説明
bolsa_vehicles_list	すべての車両を一覧表示
bolsa_vehicles_create	新しい車両を追加
bolsa_vehicles_update	車両の詳細を更新
bolsa_vehicles_delete	車両を削除

配送（6 個のツール）

ツール	説明
bolsa_deliveries_list	すべての配送を一覧表示
bolsa_deliveries_get	配送の詳細を取得
bolsa_deliveries_download_cmr	CMR PDF をダウンロード
bolsa_deliveries_send_message	配送メッセージを送信

認証（2 個のツール）

ツール	説明
bolsa_auth_login	認証して JWT トークンを受け取る
bolsa_auth_register	新しいアカウントを登録

---

ディレクトリ構成

bolsa_de_carga-mcp/
├── package.json            # Node.js 18+, ES module, bolsa-de-carga-mcp
├── .env.example            # Environment variable template
├── src/
│   └── server.js           # MCP server entry point (35+ tools, JSON-RPC 2.0)
└── README.md

---

---

認証

この MCP サーバーを使用するには、Bolsa de Carga プラットフォームの API キーが必要です。

登録： https://cia.cargoffer.com

アカウントを作成し、プロフィール設定から API キーを取得してください。その後、次のように設定します。

export API_KEY="your-api-key"

または、MCP クライアントの設定で指定します。

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "...",
      "env": {
        "API_KEY": "your-api-key-from-cia"
      }
    }
  }
}

クイックスタート

# Clone
git clone https://github.com/cargoffer/bolsa_de_carga-mcp.git
cd bolsa_de_carga-mcp

# Configure with your API key
export API_KEY="your-api-key"

# Run
node src/server.js

サーバーは http://localhost:3000 で起動し、JSON-RPC 2.0 エンドポイントを提供します。

---

インストール

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "node",
      "args": ["/path/to/bolsa_de_carga-mcp/src/server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Cursor Settings → Features → MCP Servers → Add New で設定します。

Name:   bolsa-de-carga
Type:   command
Command: node /path/to/bolsa_de_carga-mcp/src/server.js
Env:    API_KEY=your-api-key

HTTP への直接接続（カスタム統合向け）

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {"limit": 10}
  }'

---

MCP プロトコルの実例

有効な貨物オークションを検索する：

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {
      "limit": 10,
      "from": "Madrid",
      "to": "Barcelona"
    }
  }'

レスポンス：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": 200,
    "data": {
      "docs": [
        {
          "serviceCode": "MADBCNnT4FN",
          "from": { "city": "Madrid", "country": "ES" },
          "to": { "city": "Barcelona", "country": "ES" },
          "goods": { "description": "General cargo", "weight": 1000 },
          "status": "active"
        }
      ]
    }
  }
}

新しい貨物オークションを作成して公開する：

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "bolsa_auctions_create",
    "params": {
      "fromAddressId": "addr_123",
      "toAddressId": "addr_456",
      "goods": {
        "description": "Industrial machinery",
        "weight": 5000,
        "palletCount": 4
      },
      "pickupDate": "2026-06-01",
      "deliveryDate": "2026-06-03"
    }
  }'

---

AI エージェント向けのプロンプト

「マドリードからバルセロナまでの、10トン未満の有効な貨物案件をすべて表示してください。」

「バレンシアからセビリアまでの5トンの機械輸送について、来週月曜日の集荷で新しいオークションを作成してください。」

「オークション MADBCNnT4FN の最高額の入札を承諾し、CMR 運送状を生成してください。」

「最大積載量24トンの冷蔵トレーラー付きトラックを新たに車両群に登録してください。」

「CMR 署名待ちの配送をすべて一覧表示し、運送状の PDF をダウンロードしてください。」

「今月の現在のオークション落札率はどのくらいですか？終了済みと有効なオークションを表示してください。」

---

環境変数

変数	説明	デフォルト
API_KEY	Cargoffer API キー（本番環境で必須）	-
API_URL	API のベース URL	https://api.pro.cargoffer.com
PORT	サーバーのポート	3000

ローカル開発

# Use local backend
API_URL=http://localhost:8090 API_KEY=your-key node src/server.js

# Or copy .env.example
cp .env.example .env
# Edit .env with your values
node src/server.js

.env.example ファイルにテンプレートが含まれています。

API_KEY=your-key
API_URL=https://api.pro.cargoffer.com
PORT=3000

---

API エンドポイント

エンドポイント	メソッド	説明
/health	GET	ヘルスチェック
/tools	GET	利用可能なツールの一覧
/	POST	JSON-RPC 2.0 エンドポイント

---

セマンティックタグ

freight marketplace MCP load board API MCP server Model Context Protocol European road transport logistics document automation Bolsa de Carga freight auction load board truck brokerage CMR waybill freight matching AI agents LLM tools supply chain spot market Cargoffer trucking freight logistics Spain cargo easy MCP integration

---

API キーの取得

本番環境で使用する API キーを取得するには、Cargoffer にお問い合わせください。

• メール： [email protected]
• または、Cargoffer ダッシュボードからリクエストしてください

---

ライセンス

MIT — 詳細は LICENSE ファイルをご覧ください。

---

リンク

• リポジトリ： github.com/cargoffer/bolsa_de_carga-mcp
• イシュー： github.com/cargoffer/bolsa_de_carga-mcp/issues
• MCP プロトコル： modelcontextprotocol.io