Adobe 商业扩展工具

MCP(模式上下文协议)服务器为Adobe Commerce App Builder扩展开发提供AI动力工具. 与Cursor IDE和其他MCP相容的AI助手合作.

~ 这能做什么 ~

这个 MCP 服务器允许您的 AI 助手( 如 Cursor) 直接访问 Adobe Commerce 开发工具 :

• 部署和管理 Adobe I/O 应用程序
• 订阅商务活动
• 使用 AI 驱动的 RAG 搜索商务文件
• 配置 Adobe I/O 项目
• 上传反馈和聊天历史(带有IMS认证)
• AI 代理技能 用于指导扩展开发(建筑、编码、测试、部署等)

· 先决条件

在安装前,请确定您有:

1. 光标 IDE (或另一种与MCP相容的 IDE)
2. 节点.js 22+ (LTS建议)
3. Adobe I/O 语录 全球安装:

   npm install -g @adobe/aio-cli
   

4. Adobe IMS 认证 (文件搜索和反馈上传需要):

   aio auth login
   

* 安装

第1步:克隆并安装

# Clone this repository
git clone https://github.com/adobe-commerce/commerce-extensibility-tools.git
cd commerce-extensibility-tools

# Install dependencies
npm install

步骤2: 配置光标 IDE

创建或更新 .cursor/mcp.json 在您的商务项目目录中 (不是全球):

{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/commerce-extensibility-tools/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

重要替换 /ABSOLUTE/PATH/TO/ 与您克隆此寄存器的实际路径.

示例 (马克OS/Linux):

{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "/Users/yourname/projects/commerce-extensibility-tools/index.js"
      ]
    }
  }
}

示例 (温道:

{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"
      ]
    }
  }
}

步骤3:复制AI规则(备选但推荐)

将光标规则复制到您的项目中, 以便更好的 AI 帮助 :

# From your Commerce project directory
cp -r /path/to/commerce-extensibility-tools/rules/Cursor/ .cursor/rules/

这些规则教会AI助手关于Adobe Commerce的最佳做法和工作流程.

第4步:设置光标命令(可选但推荐)

将预配置的光标命令复制到您的项目, 以便快速访问 MCP 工具 :

# From your Commerce project directory
mkdir -p .cursor/commands
cp /path/to/commerce-extensibility-tools/commands/Cursor/* .cursor/commands/

这有什么作用:

• 在光标 IDE 中创建快捷键命令(例如, @search-commerce-docs, (中文(简体) ), @aio-app-deploy(中文(简体) )
• 提供快速访问所有 MCP 工具而不输入完整工具名称
• 更容易发现和使用可用的多CP工具

可用命令 :

• @search-commerce-docs - 搜索Adobe商业文件
• @aio-app-deploy - 部署Adobe I/O App
• @aio-app-dev - 启动本地开发服务器
• @aio-app-use - 配置运行时命名空间
• @aio-configure-global - 改变全球Adobe I/O配置
• @aio-dev-invoke - 启动本地运行时间行动
• @aio-login - 登录到Adobe I/ 欧
• @aio-where - 显示当前配置
• @commerce-event-subscribe - 订阅商务活动
• @onboard - 配置事件提供者

说明: 其他IDE(VSCode, Claude Desktop)可能在未来支持类似的指令系统. 检查 commands/ iDE特定命令文件的目录.

第5步:重新启动光标

完全退出并重新启动 Cursor IDE 以加载 MCP 服务器 .

步骤6:核查安装

在 Cursor 中,您应该看到 MCP 服务器已激活 。 试问:

"Can you show me the available Adobe Commerce tools?"

可用的工具

MCP 服务器提供 11个工具 财务报告和审定财务报表 2个提示数字 :

说明:所有工具都支持方案使用和互动提示。 提示提供了更方便用户的方式,通过自然语言与工具互动.

Adobe I/O 应用程序管理

Adobe I/ O 配置

商业一体化

文档搜索

反馈和支持

MCP 提示

MCP服务器为增强用户交互提供了以下提示:

AI 代理技能

该项目包括: 7 人工智能代理技能 与集成启动套件捆绑在一起( U)dist/integration-starter-kit/skills/) (中文(简体) ). 这些技能提供了专门的、以角色为基础的指导,AI助理人员可以遵循这些指导,在推广发展的各个阶段提供专家一级的帮助.

现有技能

技能如何运作

每个技能都是结构化的标记下文件(SKILL.md)与YAML前题,定义了技能的名称,描述,角色,以及工作流程. 人工智能代理人读取技能时,采用被定义的人a并遵循规定的程序.

技能的设计是为了在发展工作流程中共同努力:

Product Manager → Architect → Developer → Tester → DevOps Engineer → Technical Writer

这个 一般事务人员(其他职等) 在集成起步器 Kit 中的文件充当了主管弦乐手,引用所有技能,并协调他们之间的交接.

安装技能

复制技能和支持文件到您的商务项目 :

# From your Commerce project directory
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/skills/ skills/
cp /path/to/commerce-extensibility-tools/dist/integration-starter-kit/AGENTS.md AGENTS.md

# Optional: copy reference schemas and examples
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/references/ references/
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/examples/ examples/

技能由支持AGENTS.md常规的AI助手自动使用(Cursor, Claude Code, GitHub Copilot等). 您也可以直接参考个人技能,将您的人工智能助手指向相关 SKILL.md 文档.

文件搜索(RAG系统)

这个 search-commerce-docs 工具提供由 Azure RAG 提供的智能文档搜索 自动选择索引数字 :

可用文档索引

如何运作

1. 自动认证: 使用您的 aio CLI 令牌( 从 aio auth login(中文(简体) )
2. 智能索引选择: 根据您的查询关键字自动选择最佳文档索引
3. IMS 认证: 通过 Adobe IMS 进行安全认证
4. AI 授权搜索: 语义搜索综合文献
5. 即时结果: 在~2秒内返回最相关的前5名

光标中的使用

自动选择索引 (建议): 仅问自然语言问题,工具会自动搜索正确的文档:

"How do I use Edge Delivery Services drop-ins for product listing?"
→ Auto-selects: commerce-storefront-docs

"How do I create a webhook in Adobe Commerce?"
→ Auto-selects: commerce-extensibility-docs

"How to configure product catalog settings?"
→ Auto-selects: commerce-core-docs

"What are App Builder runtime action best practices?"
→ Auto-selects: app-builder-docs

明确的索引选择 (高级): 也可以指定要搜索的索引 :

"Search commerce-storefront-docs for authentication drop-in"
"Using app-builder-docs, how do I deploy runtime actions?"

AI将自动使用搜索工具并用最合适的索引提供相关文档.

使用量

安装后,可以使用两种方式:

备选案文1:自然语言(建议)

用自然语言询问光标, 它会自动使用正确的工具 :

"Deploy my Adobe Commerce extension to production"
→ AI uses: aio-app-deploy

"Start the local development server"
→ AI uses: aio-app-dev

"Subscribe to product save events in Commerce"
→ AI uses: commerce-event-subscribe

"How do I handle Commerce webhooks?"
→ AI uses: search-commerce-docs

"Show me my current Adobe I/O workspace"
→ AI uses: aio-where

"Teach me about Commerce webhooks"
→ AI uses: search prompt

"Provide feedback about my experience"
→ AI uses: feedback prompt

备选案文2:直接工具命令

也可以直接使用斜线命令引用工具:

# Deploy your Adobe Commerce extension
/aio-app-deploy

# Start local development server
/aio-app-dev

# Invoke a runtime action locally
/aio-dev-invoke

# Search Commerce documentation
/search-commerce-docs "How to subscribe to Commerce events"

# Configure event providers
/onboard

# Deep search Commerce documentation
/search "How do webhooks work in Adobe Commerce?"

# Provide feedback about your experience
/feedback

代理文档搜索

这个 search 迅速在 Adobe Commerce 文档中进行迭接、交互式文件研究。 它用精细的查询进行多次搜索,取取链接页面以获取完整内容,并用代码示例和Doc链接提供结果. 当话题广泛时,它会提出澄清问题,让你选择要探索的领域.

用法 :

/search "How do webhooks work in Adobe Commerce?"
/search "storefront drop-in customization"
/search "event subscriptions and commerce events"

反馈收集

这个 feedback 即时帮助收集用户反馈以改善服务:

1. 收集反馈:AI会问你的经验,遇到的任何错误,面临的问题,或改进的建议
2. 自动历史收藏: 对话历史自动从当前聊天会话中收集
3. IMS 认证: 使用您的 Adobe IMS 令牌( 从 aio auth login用于安全上传
4. 本地备份:聊天历史保存在本地 chats/ 带有时间戳文件名的文件夹
5. 服务器上传:反馈和聊天历史都被上传到官方反馈服务

认证:反馈上传需要Adobe IMS认证. 确保你已经运行 aio auth login 在使用反馈特性之前.

数据保密:在上传前,敏感数据会自动从聊天历史中进行消毒. 以下各类敏感信息被删除或被替换为占位符: 1

• API 密钥、访问符和认证证书 ——改为: [API_KEY], (中文(简体) ), [TOKEN]等 (中文(简体) ).
• 密码、密钥和私钥 ——改为: [PASSWORD], (中文(简体) ), [SECRET]等 (中文(简体) ).
• 个人识别信息(PII):电子邮件地址、电话号码、地址、SSN + 替换为 [EMAIL], (中文(简体) ), [PHONE], (中文(简体) ), [ADDRESS]等 (中文(简体) ).
• 信用卡号码和银行账户信息 ——改为: [CREDIT_CARD], (中文(简体) ), [ACCOUNT_NUMBER]等 (中文(简体) ).
• 内部IP地址、主机名或基础设施细节 ——改为: [IP_ADDRESS], (中文(简体) ), [HOSTNAME]等 (中文(简体) ).
• 任何其他机密或专有资料 + 替换为适当的占位符

示例 - 卫生前后:

之前(原文聊天):

[USER]
I'm having trouble with my API key: sk_live_51H8k2jK3mN9pQrS7tUvWxYz1234567890
Can you help me deploy my app? My email is [email protected]
The server is at 192.168.1.100:8080

[ASSISTANT]
I can help you deploy. First, let's check your configuration.

之后( 上传已禁用) :

[USER]
I'm having trouble with my API key: [API_KEY]
Can you help me deploy my app? My email is [EMAIL]
The server is at [IP_ADDRESS]

[ASSISTANT]
I can help you deploy. First, let's check your configuration.

数据隐私:聊天历史在本地保存 chats/ 带有基于时间戳的文件名的文件夹。 已消毒的版本被上传到反馈服务.

* 解决问题

MCP 服务器未装入

检查光标 MCP 设置 :

1. 打开光标设置( Cmd+, 或 Ctrl+, )
2. 搜索“ MCP ”
3. 校验 commerce-extensibility 服务器已列出
4. 检查任何错误消息

验证 mcp.json :

# Check if file exists in your project
cat .cursor/mcp.json

# Verify the path is correct and absolute
ls -la /path/to/commerce-extensibility-tools/index.js

认证错误

文件搜索和反馈上传工具都需要 Adobe IMS 认证:

# Login to Adobe I/O (will open browser)
aio auth login

# Verify you're logged in
aio where

如果遇到认证错误( 401 未经授权) , 请尝试在 :

aio auth logout
aio auth login

高级配置

以非生产环境为目标(仅限生产商)

默认情况下,文档搜索和反馈工具查询 生产 终点 环境从 aio CLI 设置 cli.env数字 :

要将工具指向dev/stage RAG,设置CLI环境并重新认证:

aio config set cli.env stage
aio auth login --force

要恢复生产:

aio config set cli.env prod
aio auth login --force

⚠️ 这个是给你的 整个 aio CLI环境,不只是这个MCP服务器. 每一个 aio 命令和读取的工具 cli.env 现在将锁定目标阶段。 如果你准备好了 stage 并且忘记,文献搜索会默默地查询dev;反之,不设则意味着即使期待dev,你总是会点击prod. 当查询返回出乎意料的结果时, 请检查 aio config get cli.env 首先,环境不匹配是最常见的原因.

说明: 大多数用户应离开 cli.env 取消设置并使用默认的生产终点.

警卫:生产终点由Azure Front Door保护,使用:

• Web 应用程序防火墙( WAF) 有 Microsoft 默认 规则Set 2.1 和 Bot 管理器 规则Set 1.0
• 美国禁运国家(古巴、伊朗、朝鲜、叙利亚、克里米亚、卢甘斯克、顿涅茨克)的地理封锁
• 边缘的 DDoS 保护
• APIM 后端已锁定, 只接受来自前门的流量

未找到工具

如果光标找不到特定工具 :

1. 完全重新启动光标 (退出并重新开放)
2. 检查 MCP 服务器日志 在 Cursor 开发者控制台中
3. 验证安装数字 :

   cd commerce-extensibility-tools
   npm install
   node index.js
   # Should start without errors
   

路径问题(窗口)

在视窗上,使用 前斜线 或者说 逃脱后鞭打数字 :

// ✅ Good
"args": ["C:/Users/yourname/projects/commerce-extensibility-tools/index.js"]

// ✅ Also good
"args": ["C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"]

// ❌ Bad
"args": ["C:\Users\yourname\projects\commerce-extensibility-tools\index.js"]

项目结构

commerce-extensibility-tools/
├── index.js                    # MCP server entry point
├── package.json                # Dependencies and configuration
├── README.md                   # This file
│
├── src/                        # MCP Server Implementation
│   ├── server.js               # MCP server core
│   ├── tools/                  # Tool implementations (11 tools)
│   │   ├── aio-app-deploy.js
│   │   ├── aio-app-dev.js
│   │   ├── aio-app-use.js
│   │   ├── aio-configure-global.js
│   │   ├── aio-dev-invoke.js
│   │   ├── aio-login.js
│   │   ├── aio-where.js
│   │   ├── onboard.js
│   │   ├── commerce-event-subscribe.js
│   │   ├── search-commerce-docs.js
│   │   └── upload-chat-history.js
│   ├── schemas/                # JSON schema definitions
│   ├── prompts/                # MCP prompt definitions and handlers
│   │   ├── index.js
│   │   ├── feedback.json
│   │   ├── search.json
│   │   └── handlers/
│   │       ├── feedback.js
│   │       └── search.js
│   └── utils/                  # Utility functions
│
├── dist/                       # Distributable Assets
│   └── integration-starter-kit/
│       ├── AGENTS.md           # Master orchestrator for AI agents
│       ├── skills/             # AI Agent Skills (7 skills)
│       │   ├── product-manager/SKILL.md
│       │   ├── architect/SKILL.md
│       │   ├── developer/SKILL.md
│       │   ├── tester/SKILL.md
│       │   ├── devops-engineer/SKILL.md
│       │   ├── technical-writer/SKILL.md
│       │   └── tutor/SKILL.md
│       ├── references/         # JSON schemas for architecture, requirements, etc.
│       └── examples/           # Example configurations and templates
│
└── rules/                      # AI Assistant Rules
    ├── Cursor/                 # Cursor IDE rules (19 files)
    │   ├── main-orchestrator.mdc
    │   ├── adobe-commerce-basics.mdc
    │   ├── app-builder-technical-guide.mdc
    │   └── ... (16 more)
    ├── Claude/                 # Claude AI rules
    ├── Copilot/                # GitHub Copilot rules
    └── Gemini/                 # Google Gemini rules

测试

使用 MCP 检查器测试 MCP 服务器 :

# Run the inspector
npm test

# Or manually
npx @modelcontextprotocol/inspector node index.js

检查员提供网络用户界面:

• 用自定义输入测试全部11个工具和2个提示
• 检查工具计划和说明
• 监视服务器日志和回复
• 除错连接问题

反馈上传问题

如果反馈上传失败 :

1. 认证:确保您已经运行 aio auth login - 反馈服务需要IMS认证
2. 网络连接:确保您可以上网,服务器端点可以到达
3. 本地文件: 检查 chats/ 当前目录中的文件夹 - 即使上传失败, 聊天历史也总是保存在本地
4. 限制费率: 如果你看到429个错误, 请稍候, 再试一次
5. 服务器响应: 为服务器侧具体问题审查错误消息

页:1

• 扩展名的 AI 编码工具 - 完整的设置和使用指南
• Adobe 开发者 App 构建器 - App 构建器文档
• Adobe 商务开发者 - 商业开发商资源
• 示范背景协议 - MCP规格
• 光标 IDE - 光标文档

安全隐私

• IMS 认证: 文档搜索和反馈上传使用 Adobe IMS OAuth2 令牌
• 无数据存储: MCP 服务器不存储任何证书或数据
• 本地执行: 所有工具在您的机器上本地运行
• 安全通讯: 所有 API 调用都使用 HTTPS 并带有符号验证
• 本地备份:聊天历史在本地保存 chats/ 上传前的文件夹

++ 辅助

关于议题和问题清单:

• Adobe I/O 语录数字 : Adobe 开发者文档
• Adobe 商业数字 : Adobe 商务开发者文档
• MCP 议定书数字 : 示范背景协议
• 光标 IDE数字 : 光标文档

捐款

这是一个分发存储器。 积极的开发发生在私人仓库中.

如需提出问题或建议,请洽Adobe Commerce扩展小组.

许可证

Adobe Commerce App Builder MCP 许可证条款. 见 自由主义 详细情况。 使用须遵守Adobe企业许可证条款 adobe.com/法律/术语/企业许可。 。 。 .