Cin7 Core MCPサーバー：在庫・販売・仕入れ

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

Cin7 Core

Cin7 Core（旧DEAR Inventory）をExternal API v2経由で使用: ロケーションごとの製品と在庫の可用性、注文、履行、請求書および支払い（読み取り専用）、購入、顧客、サプライヤー、在庫調整および移動を管理。販売、購入、顧客、サプライヤー、移動を作成。アカウントIDとアプリケーションキー。

セットアップ

セットアップには約2分かかります。Integrations → APIにアクセスできるCin7 Coreアカウント（旧DEAR Inventory; inventory.dearsystems.comでサインイン）を用意してください。コネクタにはアカウントIDとアプリケーションキーが必要です。

CoreまたはOmni？ Cin7は2つの異なる製品を販売しています。Cin7 Core（このコネクタ、旧DEAR Systems）はアカウントIDとアプリケーションキーを使用します。Cin7 Omni（元のCin7、go.cin7.com）はAPIユーザー名とキーを持つ別のAPI v1を持っています: それにはCin7 Omniコネクタを使用してください。一方の認証情報はもう一方では使用できません。

1. Cin7 CoreでAPI設定ページを開き、Integrations → API（inventory.dearsystems.com/ExternalAPI）にアクセスします。
2. **+**をクリックしてAPIアプリケーションを追加し、名前を付けます。
3. Account ID（GUID）をCIN7_CORE_ACCOUNT_IDに、Application KeyをCIN7_CORE_APPLICATION_KEYにコピーします。
4. コネクタをインストールします。接続を確認するためにcin7_core_get_meを実行します: 会社名、基本通貨、アカウントのタイムゾーンが返されます。

クラウドとセルフホストは同じように動作します: 認証情報は同じで、設定するリダイレクトURLはありません。コネクタはapi-auth-accountidとapi-auth-applicationkeyヘッダーにそれらを送信します。Cin7 CoreでAPIアプリケーションを削除すると、キーが無効になります。

どこから始めるか: 基本通貨にはcin7_core_get_me、ロケーション名にはcin7_core_list_locations、次にcin7_core_list_salesとcin7_core_get_product_availabilityを使用します。これらはほとんどの質問に答えます。

読み取る内容: 製品の価格階層、製品およびロケーションごとの在庫の可用性（手元、割り当て済み、利用可能、注文中）；見積もり、注文、履行（ピック、パック、出荷、キャリアおよび追跡）、請求書および支払いを含む販売；注文を含む購入；顧客、サプライヤー、税ルールおよび支払い条件；在庫調整および在庫移動。

販売を作成するには2回の呼び出しが必要です: cin7_core_create_saleがヘッダー（顧客、ロケーション）を作成し、そのIDを返します。次にcin7_core_create_sale_orderが行を追加します。行には名前、数量、価格、税金および税ルールに加えてSKUまたはProductIDが必要です。AIは、承認を希望しない限り、注文をDRAFTのままにします: AUTHORISEDは在庫を割り当て、不足分を警告なしにバックオーダーし、さらなるAPI編集に対して注文をロックします。購入も同様に機能し、cin7_core_create_purchaseとcin7_core_create_purchase_orderを使用します。

他の書き込み: cin7_core_create_customer、cin7_core_update_customerおよびcin7_core_create_supplier（これらは支払い条件と税ルールの名前およびアカウントコードが必要で、cin7_core_list_payment_termsとcin7_core_list_tax_rulesでリストされます）、およびcin7_core_create_stock_transfer（デフォルトでDRAFT）。これらはすべて有効になっています。

インストール時にオフになっているもの: cin7_core_create_stock_adjustment（在庫調整を作成）。COMPLETED調整は在庫の動きと会計エントリを一度に投稿し、その数量は新しい手元の値であり、差分ではありません。AIが使用する必要がある場合は、コネクタページでオンにしてください; AIは変更を確認するように求めます。

お金のやり取りと削除はなし: コネクタは支払い、請求書またはクレジットノートを記録、変更または削除することはなく、削除または無効化のツールもありません。

識別子: レコードはGUID（ID、SaleID、TaskID）を使用します。ロケーション、税ルール、支払い条件および価格階層は名前で参照されます。

ページング: リストはpage（1から）とlimit（デフォルト100、最大1,000）を取ります; 応答にはTotalが含まれます。updated_sinceまたはmodified_sinceは変更されたもののみを返します。日付はUTCで、yyyy-MM-ddTHH:mm:ss形式です。

レート制限: APIアプリケーションごとに1分あたり60回の呼び出し; それを超えるとCin7 Coreは429で応答します（古いアカウントは503）。大きなページとフィルターは、多くの小さな呼び出しよりも予算をうまく使用します。

一般的なエラー: 拒否された呼び出しは400で応答し、問題を示す[{"ErrorCode": 400, "Exception": "..."}]を返します。例えば、未知の顧客、ロケーションまたは税ルール、またはすでに承認された文書などです。403は誤ったアカウントIDまたはアプリケーションキーを意味します。

前提条件: CIN7_CORE_ACCOUNT_ID、CIN7_CORE_APPLICATION_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 Coreを選択し、前提条件に記載されている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

• "SKU MUG-WHT-350の各ロケーションでの在庫は何ユニットありますか？"
• "今月の承認済みだがまだ完全に履行されていない販売をリストしてください。"
• "注文SO-1042の履行状況をキャリアと追跡番号と共に表示してください。"
• "どの購入がまだ在庫の受領を待っていますか？"
• "顧客Coffee Cornerのために、メイン倉庫でMUG-WHT-350を24ユニット、6.50でドラフト販売を作成してください。"

次のステップ

• Claudeに接続
• ChatGPTに接続