JinDaGe - optimizely-dxp-mcp MCP Details

article

README

🚀 Optimizely DXP MCP Server

由人工智能驱动的Optimizely DXP自动化工具。 通过自然对话实现代码部署、环境管理和操作监控。

🚀 快速开始（2分钟）

# 安装
npm install -g jaxon-optimizely-dxp-mcp@latest

# 添加到Claude
claude mcp add optimizely "jaxon-optimizely-dxp-mcp"

# 测试
向Claude提问："Run setup wizard for Optimizely"

✨ 主要特性

🚀 v3.6.0亮点

智能执行：采用指数退避算法自动重试
部署仪表盘：实时监控并提供分析功能
清晰的错误提示：提供可操作的消息和复制粘贴即可使用的修复方案
设置向导：交互式配置助手
批量操作：高效执行多个命令

核心功能

在不同环境之间部署代码和内容
导出和导入数据库
监控部署进度
智能处理大型软件包（>100MB）
无缝管理多个项目
采用速率限制和缓存机制提升性能

📦 安装指南

前提条件

Node.js 16+
PowerShell Core（自动安装）
具有API访问权限的 Optimizely DXP 项目

获取API密钥

登录 DXP门户
选择您的组织 → 项目 → API标签页
点击“添加API凭证”
选择环境权限（集成、预生产、生产）
保存并复制：项目ID、API密钥、API密钥密码

配置

选项1：无需配置（最简单）

在被询问时提供凭证：

"Deploy for project MyProject with id UUID, key KEY, secret SECRET"

选项2：环境变量

添加到Claude的配置中：

{
  "mcpServers": {
    "optimizely": {
      "command": "jaxon-optimizely-dxp-mcp",
      "env": {
        "PRODUCTION": "id=UUID;key=KEY;secret=SECRET"
      }
    }
  }
}

选项3：多项目配置

"env": {
  "CLIENT_A": "id=UUID1;key=KEY1;secret=SECRET1;default=true",
  "CLIENT_B": "id=UUID2;key=KEY2;secret=SECRET2"
}

💻 使用示例

部署代码

你："Deploy to Production"
AI：开始从预生产环境部署到生产环境
AI：准备好后显示验证URL
你："Complete the deployment"

数据库导出

你："Export Production database"
AI：开始导出（.bacpac文件）
AI：监控进度并提供下载链接

内容同步

你："Copy Production content to Integration"
AI：向下同步CMS内容和媒体

🔧 技术细节

架构

此MCP使用PowerShell + EpiCloud（Optimizely的官方模块），而非直接的REST API：

用户 → MCP服务器 → PowerShell → EpiCloud模块 → Optimizely API

为什么使用PowerShell？

获得Optimizely官方支持
功能全面覆盖
强大的错误处理能力
跨平台兼容性

常见问题及解决方法

| 错误 | 解决方案 | |-------|----------| | "PowerShell not found" | 安装：brew install --cask powershell（Mac） | | "EpiCloud not installed" | 运行：pwsh -Command "Install-Module EpiCloud -Force" | | "Authentication failed" | 检查DXP门户中的API凭证 | | "Rate limit exceeded" | 等待60秒后重试 | | "Deployment stuck at 90%" | 使用 "Complete deployment" 完成部署 |

调试模式

export DEBUG=true
claude "Show deployment status with debug info"

已知限制

部署API

无详细进度信息（仅提供高级状态）
90%时需要手动验证
无队列可见性或优先级设置

技术方面

每个操作都会启动新的PowerShell进程
大型上传（>100MB）需要特殊处理
内容同步提供的反馈较少

📚 详细文档

支持

邮箱：support@jaxondigital.com
问题反馈：GitHub
文档：Wiki

📄 许可证

本项目采用MIT许可证，可免费用于您的项目。

由 Jaxon Digital 构建 - Optimizely金牌合作伙伴

optimizely-dxp-mcp