概要
販売事業者向けの JTL Fulfillment Network(JTL-FFN)に接続します。商品、倉庫ごとの在庫、配送ステータスと追跡情報付きの出荷注文、入荷、返品、フルフィルメント事業者の倉庫と配送方法を扱い、依頼に応じて出荷の作成やキャンセルも行えます。認証は OAuth2 です。
ガイド付きセットアップ
JTL Fulfillment Network を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで JTL Fulfillment Network を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
JTL Fulfillment Network のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → JTL Fulfillment Network をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
JTL Fulfillment Network + Microsoft Copilot
販売事業者向けの JTL Fulfillment Network(JTL-FFN)に接続します。商品、倉庫ごとの在庫、配送ステータスと追跡情報付きの出荷注文、入荷、返品、フルフィルメント事業者の倉庫と配送方法を扱い、依頼に応じて出荷の作成やキャンセルも行えます。認証は OAuth2 です。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
JTL_FFN_CLIENT_ID, JTL_FFN_CLIENT_SECRET
ステップ 1 — 認証情報を取得
- JTL アカウントで fulfillment.jtl-software.com に一度サインインします。このアカウントには Merchant ロールが必要です。最初のサインインを済ませるまで、API はこのユーザーに対して 404 を返します。
- kundencenter.jtl-software.de/oauth を開き(このページは Kundencenter のメニューにはありません)、スコープ
ffn.merchant.readとffn.merchant.writeを持つ OAuth クライアントを作成します。リダイレクト URI は、AnythingMCP Cloud ではhttps://cloud.anythingmcp.com/api/mcp-oauth/callback、セルフホストの場合は<your AnythingMCP URL>/api/mcp-oauth/callbackです。 - クライアント ID とシークレットを
JTL_FFN_CLIENT_IDとJTL_FFN_CLIENT_SECRETに貼り付けてインストールし、コネクタのページで Authorize with Provider をクリックします。アクセストークンの有効期間は 30 分で、自動的に更新されます。 - まず
jtl_ffn_get_current_userを実行し、次にjtl_ffn_list_warehousesとjtl_ffn_list_productsを使います。注文については、jtl_ffn_get_outboundでステータスを、jtl_ffn_list_outbound_shipping_notificationsで追跡番号付きの荷物を確認できます。
jfsku は JTL の 11 文字の商品 ID(例:MERC01PRDCT)で、お客様自身の SKU(merchantSku)とは異なります。出荷と入荷のツールは、FFN の ID とお客様自身の注文番号のどちらも受け付けます。filter には status eq 'Shipped' のような OData 形式の式を指定します。jtl_ffn_create_outbound と jtl_ffn_cancel_outbound は無効の状態でインストールされます。意図して有効にし、呼び出すたびに内容を確認してください。一覧系のツールは limit(既定値 50)と offset を受け付けます。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
JTL Fulfillment Networkのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
jtl_ffn_get_current_user | Return the JTL-FFN user behind the authorization: user id (your 4-character merchant id), address and roles |
jtl_ffn_list_warehouses | List the fulfiller warehouses authorized for this merchant, with warehouseId, fulfillerId, name, address and the shippingMethodIds each… |
jtl_ffn_list_fulfillers | List the fulfillment providers this merchant works with: 4-character userId (the fulfillerId used elsewhere), active flag and address |
jtl_ffn_list_shipping_methods | List the shipping methods the fulfillers allow this merchant to use: shippingMethodId, name, carrierName, carrierCode, shippingType… |
jtl_ffn_list_products | List the merchant's products in JTL-FFN with jfsku, merchantSku, name, identifiers (EAN, ASIN, MPN), dimensions, weight and attributes |
jtl_ffn_get_product | Get one product by its jfsku with all master data: name, merchantSku, identifiers, specifications (batch, best-before, serial number, bill… |
jtl_ffn_list_stock_levels | List stock for all products across all warehouses: per jfsku the available stockLevel, stockLevelReserved (held by outbounds)… |
jtl_ffn_get_product_stock | Get the stock of one product by jfsku: available, reserved, announced and blocked quantities, split by warehouse and fulfiller, by batch… |
jtl_ffn_list_warehouse_stock | List the stock of all products in one warehouse: per jfsku and merchantSku the available, reserved, announced and blocked quantities |
jtl_ffn_list_outbounds | List outbound orders (shipments the fulfiller sends to customers) with outboundId, merchantOutboundNumber, status (Preparation, Pending… |
jtl_ffn_get_outbound | Get one outbound order with its status, status timestamps, shipping address, items with open quantities, shipping method, notes and cancel… |
jtl_ffn_list_outbound_shipping_notifications | Get the shipping notifications the fulfiller posted for an outbound: shipped items with batch and serial numbers, and the packages with… |
jtl_ffn_list_outbound_changes | Change feed of outbounds modified within a time window (status changes, shipments, cancellations) |
jtl_ffn_list_inbounds | List inbound deliveries announced to the fulfillers' warehouses with inboundId, merchantInboundNumber, status (Preparation, Pending… |
jtl_ffn_get_inbound | Get one inbound delivery with its status, warehouse, supplier, purchase order number, note and items with announced quantities |
jtl_ffn_list_inbound_shipping_notifications | Get the shipping notifications of an inbound delivery, i.e. what is on its way to the warehouse: packages with tracking identifiers… |
jtl_ffn_list_returns | List customer returns with returnId, merchantReturnNumber, state (Announced, Arrived, Completed), warehouse, customer address, returned… |
jtl_ffn_get_return | Get one customer return by returnId with its state, items (condition, linked outbound), labels and notes |
jtl_ffn_list_cancel_reasons | List the standard cancel reasons of JTL-FFN (code and name) |
jtl_ffn_create_outbound | Create a new outbound order: the fulfiller will pick, pack and ship these items to the address, which costs money and cannot be undone once… |
jtl_ffn_cancel_outbound | Cancel an outbound order by setting its status to Canceled |
jtl_ffn_create_inbound | Announce an inbound delivery (Anlieferung, e.g. new stock from a supplier or production) to the fulfiller's warehouse, so the fulfiller can… |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?