Cin7 Omni MCP サーバー：在庫・注文管理

💡 インストール不要？cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Cin7 Omniをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerもgit cloneもローカルサーバーも不要です。

Cin7 Omni

Cin7 Omni (go.cin7.com) の在庫および注文管理をAPI v1を通じて: 売上注文、見積もり、購入注文、クレジットノート、連絡先、製品、支店ごとの在庫、支店、支払い（読み取り専用）、在庫調整、支店間移動およびユーザー。注文、購入注文、連絡先、移動を作成します。APIユーザー名とキー。

セットアップ

セットアップには約3分かかります。Cin7 Omniアカウントが必要です（go.cin7.comでサインインします）およびAPI v1接続を追加できる管理者が必要です。コネクタにはAPIユーザー名とAPIキーが必要です。

OmniまたはCore？ Cin7は2つの異なる製品を販売しています。Cin7 Omni（このコネクタ）はgo.cin7.comでサインインし、APIユーザー名とキーを持つAPI v1を提供します。Cin7 Core（以前のDEAR Inventory）はinventory.dearsystems.comでサインインし、アカウントIDとアプリケーションキーを持つ独自のAPIを提供します: それにはCin7 Coreコネクタを使用してください。2つのAPIとその認証情報は互換性がありません。

1. Cin7 Omniでユーザーメニューを開き、設定 → 統合 & API → API v1を選択します。
2. ページの上部に表示されているAPIユーザー名をCIN7_OMNI_API_USERNAMEにコピーします。
3. 新しいAPI接続を追加をクリックし、名前を付けてそのAPIキーをCIN7_OMNI_API_KEYにコピーします。キーを再生成すると、失われたキーを置き換えます。
4. 権限の下で、AIが見るべきすべてのリソースに対して読み取りをチェックし、書き込みツールが必要とするリソースに対して作成または更新をチェックし、次に保存をクリックします。権限のないリソースは403で応答します。
5. コネクタをインストールします。cin7_omni_list_branchesを実行して接続を確認します: それはあなたの支店とそのIDをリストします。

クラウドと自己ホストは同じ方法で動作します: 認証情報は同じで、設定するリダイレクトURLはありません。コネクタはHTTP Basic認証としてユーザー名とキーを送信します。

どこから始めるか: cin7_omni_list_branchesで支店IDを、cin7_omni_list_sales_ordersで最近の注文を、cin7_omni_list_stockで支店ごとの在庫を、cin7_omni_list_contactsで顧客またはサプライヤーを見つけます。

読み取る内容: 売上注文、見積もりおよびクレジットノートとその行アイテム; 注文に対して記録された支払い; 購入注文; 製品、そのオプション（販売可能なSKU）と価格およびカテゴリ; 製品オプションおよび支店ごとの在庫（利用可能、手元にある、オープンセール、入荷中）; 在庫調整および支店間移動; 連絡先およびユーザー。

書き込む内容: cin7_omni_create_sales_order, cin7_omni_update_sales_order（ヘッダーフィールドのみ、ステージ、追跡コード、配達指示など）、cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contactおよびcin7_omni_create_branch_transferが有効になっています。新しい売上注文は、AIがドラフトとして作成しない限り承認されます; 購入注文と移動は承認されない限りドラフトとして保存されます。移動の発送と受領はCin7で行われます。

インストール時に無効になっている: cin7_omni_create_adjustment（1つの支店で在庫調整を作成）。承認された調整は、手元の在庫と在庫価値を一度に変更します。AIが使用する必要がある場合は、コネクタページで有効にしてください; AIはすべての変更を確認するように求めます。

すべての書き込みの応答を確認する: Cin7はHTTP 200で{index, success, id, code, errors}のリストを返します。記録を拒否した場合も同様です。AIは書き込みが完了したと報告する前にsuccessとerrorsを確認します。

支払いは読み取り専用: コネクタは支払いを記録、変更または削除することはなく、注文を発送、請求または無効にすることもありません。

フィルタリング: whereはレコードのフィールドに対してSQLスタイルの条件を取りますが、その行アイテムには適用されません。文字列と日付はシングルクォートで囲み、数字はそのまま: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24)。日付はUTCで、yyyy-MM-ddTHH:mm:ssZ形式です。fieldsは応答をトリムします（id,reference,total,lineItems(code,qty)）、これは注文リストに役立ちます。

ページング: pageは1から始まり、rowsは最大250（デフォルトは50、注文リストでは25）です。AIは次のページを要求し、空のページが返されるまで続けます。

レート制限: Cin7 Omniはアカウントごとに1秒あたり3回、1分あたり60回、1日あたり5,000回の呼び出しを許可します; それを超えると429でRetry-Afterを返します。狭いwhereフィルタを持つ大きなrowsは、多くの小さな呼び出しよりも予算をより良く使用します。

値: 注文のstatusはDRAFT、APPROVEDまたはVOIDで、stageは自由形式のワークフローステージ（新規、支払い待ち、処理中、保留中、発送済み）です。在庫のavailableは手元の在庫からオープンセールを引いたものです。連絡先のtypeは顧客、サプライヤーまたは内部です。書き込みは注文通貨で金額を受け取り、読み取りは基準通貨の値を為替レートとともに返します。新しいユーザーはcin7_omni_list_usersに表示されるまで最大2時間かかることがあります。

一般的なエラー: 403はAPI接続がそのリソースに対して権限を持っていないことを意味します: 権限の下でチェックを入れて保存してください。429はレート制限です: Retry-Afterの時間を待ってください。

前提条件: CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

コネクタをローカルにインストールする

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

http://localhost:3000/connectors/storeを開き、Cin7 Omniを選択し、前提条件の下にリストされている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

• "今週承認されたがまだ発送されていない売上注文はどれですか？"
• "SKU TSHIRT-BLK-Mの在庫は各支店にどれだけありますか？"
• "今月到着予定の購入注文はどれで、どのサプライヤーからですか？"
• "メール[email protected]の顧客を見つけ、その未払い残高を表示してください。"
• "メイン倉庫から市内店舗にTSHIRT-BLK-Mの20ユニットのドラフト移動を作成してください。"

次のステップ

• Claudeに接続する
• ChatGPTに接続する