Optimizely Dxp MCP

🚀 Optimizely DXP MCP Server

Optimizely DXPのためのAIパワードな自動化ツールです。自然な会話を通じてコードのデプロイ、環境の管理、操作の監視を行えます。

🚀 クイックスタート (2分で完了)

# インストール
npm install -g jaxon-optimizely-dxp-mcp@latest

# Claudeに追加
claude mcp add optimizely "jaxon-optimizely-dxp-mcp"

# テスト
Claudeに質問: "Run setup wizard for Optimizely"

💻 このツールができること

AIアシスタントに次のような要求をすればOKです。

• "Deploy Integration to Production"
• "Show deployment dashboard"
• "Export Production database"
• "Copy Production content to Preproduction"
• "Monitor deployment abc-123"

PowerShellコマンドやポータルのナビゲーションは必要ありません。

✨ 主な機能

🚀 v3.6.0のハイライト

• スマート実行: 指数バックオフによる自動リトライ
• デプロイダッシュボード: 分析機能付きのリアルタイム監視
• 明確なエラー表示: コピー&ペーストで修正可能なアクションメッセージ
• セットアップウィザード: 対話型の設定ヘルパー
• バッチ操作: 複数のコマンドを効率的に実行

コア機能

• 環境間でのコードとコンテンツのデプロイ
• データベースのエクスポートとインポート
• 進行状況追跡付きのデプロイ監視
• 大きなパッケージ（>100MB）のインテリジェントな処理
• 複数プロジェクトのシームレスな管理
• パフォーマンス向上のためのレート制限とキャッシュ

📋 前提条件

• Node.js 16以上
• PowerShell Core（自動でインストールされます）
• APIアクセスが可能な Optimizely DXP プロジェクト

🗝️ APIキーの取得方法

1. DXPポータルにログインします。
2. 組織 → プロジェクト → APIタブを選択します。
3. "Add API Credentials"をクリックします。
4. 環境の権限（Integration, Preproduction, Production）を選択します。
5. 保存して、Project ID、API Key、API Secretをコピーします。

⚙️ 設定方法

オプション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: PreproductionからProductionへのデプロイを開始します。
AI: 準備ができたら検証URLを表示します。
あなた: "Complete the deployment"

データベースのエクスポート

あなた: "Export Production database"
AI: エクスポート（.bacpacファイル）を開始します。
AI: 進行状況を監視し、ダウンロードリンクを提供します。

コンテンツの同期

あなた: "Copy Production content to Integration"
AI: CMSコンテンツとメディアを下方向に同期します。

🔧 アーキテクチャ

このMCPは、直接のREST APIではなく、PowerShell + EpiCloud（Optimizelyの公式モジュール）を使用しています。

ユーザー → MCPサーバー → PowerShell → EpiCloudモジュール → Optimizely API

なぜPowerShellを使うのか？

• Optimizelyの公式サポート
• 完全な機能カバレッジ
• 堅牢なエラーハンドリング
• クロスプラットフォーム互換性

🐞 トラブルシューティング

一般的な問題と解決策

デバッグモード

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

📌 既知の制限事項

デプロイAPIに関する制限

• 詳細な進行状況が表示されない（大まかなステータスのみ）
• 90%で手動検証が必要
• キューの可視性や優先順位付けがない

技術的な制限

• 各操作で新しいPowerShellプロセスが起動される
• 大きなアップロード（>100MB）には特別な処理が必要
• コンテンツ同期のフィードバックが少ない

🛠️ サポート

• メール: support@jaxondigital.com
• 問題報告: GitHub
• ドキュメント: Wiki

📄 ライセンス

MIT - あなたのプロジェクトで自由に使用できます。

Built by Jaxon Digital - Optimizely Gold Partner