Magento Claude Skills

Magento克劳德技能

对于商店经营者。 用简单的语言向克劳德询问你的Magento商店——查找订单、检查库存、管理客户、更新产品和运行报告。Claude直接使用以下命令调用您商店的REST和GraphQL API curl。无需运行服务器，无需额外进程，无需配置MCP客户端。

______________________________________________________________________

这是给谁的

店铺运营商、商家和支持代理 谁想通过Claude Code与Magento 2/Adobe Commerce商店互动。

______________________________________________________________________

技能

所有读取操作都是开箱即用的。写操作（取消订单、更新库存、生成优惠券等）在执行前要求确认。

______________________________________________________________________

先决条件

• 克劳德代码 安装
• curl, jq，以及 python3 在你的 PATH
• Magento 2.3+或Adobe Commerce，可通过HTTPS访问
• 用于管理操作的集成令牌(如何创建一个)

______________________________________________________________________

快速开始

选项A-- --add-dir （推荐，无需复制）

git clone https://github.com/magendooro/magento-claude-skills.git ~/magento-claude-skills

export MAGENTO_BASE_URL=https://your-store.example.com
export MAGENTO_ADMIN_TOKEN=your-integration-token

claude --add-dir ~/magento-claude-skills

克劳德会自动掌握这些技能。自然提问或直接调用：

Show me the last 10 orders
/magento-inventory check WS03-XS-Red

选项B——根据个人技能进行安装（所有项目）

git clone https://github.com/magendooro/magento-claude-skills.git
cd magento-claude-skills && ./install.sh

将技能复制到 ~/.claude/skills/。可在每个Claude Code会话中使用，无需 --add-dir.

选项C——安装到特定项目

./install.sh --project

复制到 ./.claude/skills/ 仅在当前目录中。

______________________________________________________________________

配置

创建集成令牌

在Magento管理中： 系统→ 扩展→ 集成→ 添加新集成

1. 给它起个名字（例如“克劳德技能”）
2. API tab → 选择所有资源（或根据需要范围）
3. Save → 激活→ 复制 访问令牌

启用承载令牌模式（Magento 2.4+中需要）：

bin/magento config:set oauth/consumer/enable_integration_as_bearer 1
bin/magento cache:flush config

或在管理中： 商店→ 配置→ 服务→ OAuth→ 允许OAuth访问令牌用作独立的承载令牌→ Yes

______________________________________________________________________

用法示例

支持-订单查询和跟踪

Find order #000000042
Has order 42 shipped? What's the tracking number?
Show all orders for roni_cost@example.com

操作——报告和过滤

Show me pending orders from the last 24 hours
What is the revenue for March 2026, excluding canceled orders?
List high-value abandoned carts over €150

目录和库存

Search for products matching "yoga pants" priced under $50
Is SKU WS03-XS-Red in stock? How many units?
Set the special price of WS03-XS-Red to €24.99

内容和促销

What is the store's return policy?
Show all active promotions
Generate 10 coupon codes for the Summer Sale discount rule

写入操作

所有更改都需要确认。Claude确切地展示了它会做什么并等待：

> Cancel order #000000042

I'll cancel order #000000042 (Veronica Costello, €36.39, status: processing).
This cannot be undone if the order has been invoiced. Confirm? (yes/no)

______________________________________________________________________

运作原理

每项技能都包含精确的API模式，因此Claude从不猜测：

• 精确 curl 命令 --正确的标题， -g 旗帜为 searchCriteria 括号，URL编码
• 决策表 -将自然语言请求映射到正确的API操作
• 错误文档 --已知的Magento错误消息及其解释和修复
• PII屏蔽 --显示前屏蔽电子邮件和地址(r***@e***.com)
• 确认门 --所有写入操作暂停以供审批

为什么技能比MCP服务器产生更准确的结果

马金托的API有许多不明显的陷阱。 克劳德的一般培训知识涵盖了官方文件，但不包括陷阱： searchCriteria[filterGroups][0][filters][0][field]= 括号语法与shell glob扩展中断，EAV属性存储整数选项ID而不是标签，Magento 2.4+中默认关闭的Bearer令牌设置， /order/{id}/ship 对 /shipment （后者会创建重复项）等等。技能明确地记录了每个陷阱。克劳德复制已知的好模式，而不是从近似回忆中生成。

每次操作的令牌更少。 MCP工具调用会带来协议开销——JSON-RPC信封、输入模式验证、输出包装、会话启动时的工具列表。有了技能，相关模式就已经在上下文中了，Claude可以执行 curl 直接。没有模式解析，没有工具调用信封。

更少的网络往返。 通过HTTP运行的MCP服务器为每个操作增加了一个完整的跃点：Claude→ MCP服务器→ Magento（每次工具调用两次网络调用）。技能直接调用Magento——一跳。多步操作（例如，查找订单→ 检查装运→ 获取跟踪）可以在单个bash执行中链接，而不是N个连续的工具调用。

在内部，技能使用Magento的公共GraphQL端点（店面读取，无令牌）和管理REST API(/rest/{store_code}/V1/...，不记名代币）。相同的API知识编码在 MageMCP 作为Python MCP服务器——如果需要连接Claude Code以外的AI代理，请使用MageMCP。

______________________________________________________________________

正在更新

cd ~/magento-claude-skills && git pull
# If you used install.sh, re-run it to update copies:
./install.sh

______________________________________________________________________

故障排除

______________________________________________________________________

许可证

麻省理工学院——见 许可证