本文へ移動

JTLGO Commerce MCP

公開検索からアカウントの作業まで、一つのMCP接続で

JTLGO Commerce MCPは、AIクライアントと購入・物流ツールをつなぐコネクタです。公開接続では商品検索、中国発の送料概算、追跡を利用し、アカウント接続ではOAuth後に許可された個別情報を扱います。

公開エンドポイント https://jtlgo.com/api/mcp

MCPの接続を確認しています…

プロトコル
—
ツール数
—
応答時間
—

二つの接続方法を比較

まず必要なアクセス方法を選ぶ

公開情報だけを使うか、OAuthでアカウントの作業も行うかを選びます。URL入力と設定ファイルは、同じ接続先を指定する方法です。

アカウントコネクタ

このURLで公開ツールと権限付きのアカウントツールを使えます。必要なときにMCPクライアントがOAuthを開始し、このWebページはトークンを扱いません。

10ツール・アカウント利用時のみOAuth

https://jtlgo.com/api/mcp/account

どちらのURLも同じ6つの公開ツールを提供します。アカウントが必要なら、そのURLだけを設定してください。二つのコネクタを登録する必要はありません。

使用するクライアントを選ぶ

匿名の検索だけなら公開URLを使います。アカウントを使う場合は、公開ツールも含むアカウントURLを一つ設定します。

このURLを設定に入力

公開ツールの確認と一般的な検索にはログインが不要です。

https://jtlgo.com/api/mcp

JSON設定

クライアントの接続先欄、または設定ファイルに同じURLを入力してください。

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

TOML設定

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp"

このURLを設定に入力

このURLで公開ツールと権限付きのアカウントツールを使えます。必要なときにMCPクライアントがOAuthを開始し、このWebページはトークンを扱いません。

https://jtlgo.com/api/mcp/account

JSON設定

クライアントの接続先欄、または設定ファイルに同じURLを入力してください。

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp/account"
    }
  }
}

TOML設定

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp/account"

アカウント接続の設定

このURLで公開ツールと権限付きのアカウントツールを使えます。必要なときにMCPクライアントがOAuthを開始し、このWebページはトークンを扱いません。

https://jtlgo.com/api/mcp/account

認可後のアカウントツール

この4ツールは、クライアントでOAuthを完了した後に使えます。

get_account_summary

コネクタに許可されたアカウント概要と顧客の状態を取得します。

list_customer_work_items

顧客が対応する必要のある作業を一覧にします。

get_customer_work_item

一つの作業の詳細を取得し、アシスタントが続きを確認します。

create_support_ticket

許可された範囲でサポートへの問い合わせを作成します。

6つの公開ツール

JTLGOの公開コネクタで利用するツールです。

ツール用途主な入力取得する内容
search_products 商品を検索 keyword, site, limit 公開可能な項目に限定した商品候補
quote_shipping_rates 中国発送料を概算 countryCode, weight, dimensions ルートと課金重量の選択肢
track_shipment 配送を追跡 追跡番号一つ、または番号の一覧 最新の配送履歴と確認が必要な状態
get_product_detail 商品詳細を確認 id、または商品URL 公開可能な商品詳細
human_handoff 担当者へ相談 language, reason メールとWhatsAppの相談先
get_mcp_config 接続設定を確認 入力なし 接続メタデータとツール一覧

認可後のアカウントツール

仕組みを詳しく知る

以下は英語の記事です。エージェントによる購買、調達自動化の限界、物流ツールの接続を説明します。

接続前によくある質問

公開ツールなのに接続確認でPOSTを使うのはなぜですか?

JTLGOのMCPエンドポイントはJSON-RPCをPOSTで受け付け、同じURLへGETでアクセスすると405を返します。initialize、notifications/initialized、tools/listの順で行う接続確認は、購入や支払いの実行ではありません。

接続確認の順序 POST initialize → notifications/initialized → tools/list

アカウントコネクタはいつ使いますか?

個別のアカウント情報や許可された問い合わせ作成をアシスタントに頼む場合に使います。クライアントがOAuthを行い、account:read、work_items:read、support:writeの範囲でアクセスします。このWebページはトークンを受け取りません。

二つのURLを両方設定する必要がありますか?

ありません。公開情報だけなら公開URLを選びます。アカウントを使う場合は、そのURL一つで6つの公開ツールも利用できます。