Saleor MCP

🚀 Saleor MCP Server

Saleor Commerce用のモデルコンテキストプロトコル（MCP）サーバーで、AIアシスタントやツールとの統合を提供します。

🚀 クイックスタート

Saleor MCPサーバーは、AIアシスタントがSaleorインスタンスとやり取りし、商品、顧客、注文に関するデータを取得できるようにします。MCPは読み取り専用で、Saleor APIに対するミューテーションをトリガーすることはありません。

Saleor MCPサーバーを試す最も簡単な方法は、以下のURLにデプロイされた本番環境のインスタンスを訪問することです。

https://mcp.saleor.app/

https://mcp.saleor.app/mcp エンドポイントでStreamable HTTPを使用してサーバーに接続できます。必要なヘッダーの詳細については、以下の「設定」セクションを参照してください。本番環境のインスタンスは、saleor.cloud ドメインにホストされたSaleorインスタンスに接続するように設定されており、Saleor 3.22と互換性があります。

📦 インストール

以下の手順で、開発およびテスト目的でSaleor MCPサーバーをローカルにセットアップできます。

前提条件

• Python 3.12以上
• uv パッケージマネージャー

セットアップ

1. リポジトリをクローンする

   git clone git@github.com:saleor/saleor-mcp.git
   cd saleor-mcp
   

2. 依存関係をインストールする

   uv sync
   

3. MCPサーバーをローカルで起動する

   uv run saleor-mcp
   

   サーバーは http://localhost:6000 で起動します。

📚 ドキュメント

X-Saleor-API-URL と X-Saleor-Auth-Token ヘッダー

Saleor MCPサーバーは、Saleor APIへの接続を設定するために2つのヘッダーを使用します。

• X-Saleor-API-URL - Saleor APIエンドポイントのURL。
• X-Saleor-Auth-Token - Saleor APIにアクセスするための認証トークン。このトークンは、利用可能なツールにアクセスするために MANAGE_PRODUCTS と MANAGE_ORDERS の権限を持っている必要があります。

MCPサーバーへのリクエストにこれらのヘッダーを含めるようにしてください。

ALLOWED_DOMAIN_PATTERN 環境変数

ALLOWED_DOMAIN_PATTERN 環境変数は、MCPサーバーが接続できる許可されたAPIドメインの正規表現パターンを指定するために使用されます。設定された場合、サーバーは X-Saleor-API-URL ヘッダーをこのパターンに対して検証します。設定されていない場合、すべてのドメインが許可されます。パターンには特殊文字のエスケープが必要です。

例: https:\/\/.*\.saleor\.cloud\/graphql\/ - saleor.cloud の任意のサブドメインと /graphql/ パスを許可します。

🔧 技術詳細

AIアシスタントとの統合

Saleor MCPは、Streamable HTTPを使用してカスタムMCPサーバーとの統合をサポートするAIアシスタントで有効にすることができ、適切なヘッダーを設定することができます。

以下は、mcp.json ファイルを使用したVSCode / Copilotの例の設定です。

{
  "servers": {
    "saleor-mcp": {
      "type": "http",
      "url": "https://mcp.saleor.app/mcp",
      "headers": {
        "X-Saleor-Auth-Token": "eyJhb...",
        "X-Saleor-API-URL": "https://example.saleor.cloud/graphql/"
      }
    }
  }
}

開発

このプロジェクトは、ariadne-codegen を使用してGraphQLスキーマからSaleor APIクライアントコードを生成します。設定については pyproject.toml を参照してください。 クライアントをローカルで再生成するには、以下のコマンドを実行します。

ariadne-codegen