Saleor MCP Server

销售MCP服务器

Saleor Commerce的模型上下文协议（MCP）服务器，提供与AI助手和工具的集成。

入门指南

Saleor MCP服务器允许AI助手与Saleor实例交互，以获取有关产品、客户和订单的数据。MCP是只读的-它不会触发Saleor API的任何突变。

尝试Saleor MCP服务器的最简单方法是访问部署在以下位置的生产实例：

https://mcp.saleor.app/

您可以使用Streamable HTTP连接到服务器，网址为 https://mcp.saleor.app/mcp 终点。有关所需标头的详细信息，请参阅下面的配置部分。生产实例已配置为连接到托管在上的Saleor实例 saleor.cloud 域名，与Saleor 3.22兼容。

安装

以下说明将帮助您在本地设置Saleor MCP服务器，以便进行开发和测试。

先决条件

• Python 3.12或更高版本
• 紫外线 包管理器

设置

1. 克隆仓库

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

1. 安装依赖项

   uv sync

1. 在本地运行MCP服务器

   uv run saleor-mcp

服务器将于启动 http://localhost:6000

配置

X-Saleor-API-URL 和 X-Saleor-Auth-Token 标头

Saleor MCP服务器使用两个头来配置与Saleor API的连接：

• X-Saleor-API-URL -Saleor API终结点的URL。
• X-Saleor-Auth-Token -用于访问Saleor API的身份验证令牌。令牌必须具有 MANAGE_PRODUCTS 和 MANAGE_ORDERS 访问可用工具的权限。

请确保在向MCP服务器发出的请求中包含这些标头。

ALLOWED_DOMAIN_PATTERN env变量

这 ALLOWED_DOMAIN_PATTERN 环境变量用于为MCP服务器可以连接到的允许的API域指定regex模式。设置后，服务器将验证 X-Saleor-API-URL 与此模式相反。如果未设置，则允许使用任何域。Patten必须包括特殊角色的转义。

例子： https:\/\/.*\.saleor\.cloud\/graphql\/ -允许任何子域 saleor.cloud 和那个 /graphql/ 路径。

与AI助手集成

Saleor MCP可以在AI助手中启用，这些助手支持使用Streamable HTTP和设置适当的标头与自定义MCP服务器集成。

以下是VSCode/Copilot的示例配置，使用 mcp.json 文件：

{
  "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/"
      }
    }
  }
}

发展

此项目使用 阿里阿德涅密码子 以从GraphQL模式生成Saleor API客户端代码。看 pyproject.toml 用于配置。 要在本地重新生成客户端，请运行：

ariadne-codegen