Saleor MCP
工具清单与参数
端点
POST /api/mcp
Content-Type: application/json
Authorization: Bearer <用户自己的 Saleor token>已登录的 Storefront 会话也可以认证请求。不要在服务端配置全局 SALEOR_TOKEN 来代替用户身份。
初始化
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "my-agent", "version": "1.0.0" }
}
}初始化后发送 notifications/initialized，再调用 tools/list 获取当前版本的工具定义。
search_saleor_products
按名称、slug 或描述搜索商品。first 可选，范围为 1–100，默认 20。
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_saleor_products",
"arguments": { "query": "轴承", "first": 20 }
}
}get_saleor_product
按 Saleor 商品 ID 或 slug 获取详情。参数为必填的 identifier。
list_saleor_categories
获取分类列表。可选参数 first 范围为 1–100，默认 50。
所有工具结果包含 source: "saleor-graphql"、queryVersion: "saleor-mcp-v1" 和 reviewStatus: "pending-engineering-review"。这些字段必须随选型记录保存。