Cin7 OmniとCursorをMCPで連携

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

Cin7 Omni + Cursor

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

前提条件

コネクタに組み込まれた完全なセットアップ手順を参照してください（コネクタを選択したときにアプリ内ストアで表示されます）。このコネクタに必要な環境変数は次のとおりです：

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

ステップ1 — 資格情報を取得する

設定には約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でユーザーメニューを開き、Settings → Integrations & API → API v1を選択します。
2. ページの上部に表示されているAPI UsernameをCIN7_OMNI_API_USERNAMEにコピーします。
3. Add New API Connectionをクリックし、名前を付けてそのAPI keyをCIN7_OMNI_API_KEYにコピーします。Regenerate Keyは失われたキーを置き換えます。
4. Permissionsの下で、AIが見るべきすべてのリソースに対して読み取りをチェックし、書き込みツールが必要とするリソースに対して作成または更新をチェックし、次にSaveをクリックします。権限のないリソースは403で応答します。
5. コネクタをインストールします。cin7_omni_list_branchesを実行して接続を確認します：支店のIDとともに支店をリストします。

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

どこから始めるか：支店IDのためにcin7_omni_list_branches、最近の注文のために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は自由形式のワークフローステージ（New、Awaiting Payment、Processing、On Hold、Dispatched）です。在庫のavailableは手持ちの在庫からオープン販売を引いたものです。連絡先のtypeはCustomer、SupplierまたはInternalです。書き込みは注文通貨で金額を取り、読み取りは為替レートで基準通貨の値を返します。新しいユーザーはcin7_omni_list_usersに表示されるまで最大2時間かかることがあります。

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

ステップ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 — Cursorにコネクタを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう — エージェントが Cin7 Omni のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

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

よくある質問

Cin7 Core（DEAR Inventory）を使用しています。これは正しいコネクタですか？ いいえ。Cin7 Coreには独自のAPIと資格情報があります： Cin7 Coreコネクタを使用してください。1つの製品の資格情報は他の製品では機能しません。

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディングページ
• Claudeに接続する