Magento Cloud MCP Server

mcp-magento-cloud

Adobe Commerce Cloud 向けの MCP（Model Context Protocol）サーバーです。AI エージェントが Magento Cloud プロジェクトとやり取りし、データベースのクエリ、ログの読み取り、環境の一覧表示、アクティビティの調査などを行えます。

PHP CLI は不要です — REST API と SSH を直接使用します。

バージョン

バージョン	説明	要件
v2.x（最新）	REST API と SSH を直接使用します。ブラウザーログインまたは API トークンを使用します。	Node.js 20 以上、ssh バイナリ
v1.x	magento-cloud PHP CLI をラップします。	Node.js 20 以上、magento-cloud CLI のインストール

特定のバージョンを使用する

# Latest (v2.x)
npx -y mcp-magento-cloud

# v1.x (requires magento-cloud CLI)
npx -y [email protected]

前提条件（v2.x）

• Node.js 20 以上
• ssh バイナリ — Linux/macOS ではデフォルトで利用できます

クイックスタート

認証

ブラウザーによる自動ログイン（推奨）

セットアップは不要です。いずれかのツールを初めて使用すると、Adobe/Magento アカウントを使った OAuth2 ログインのためにブラウザーウィンドウが自動的に開きます。認証情報はローカルの ~/.config/mcp-magento-cloud/credentials.json に保存され、自動的に更新されます。

手動でログインすることもできます。

npx -y -p mcp-magento-cloud mcp-magento-cloud-login

API トークン（代替手段）

API トークン（例：CI/CD 用）の使用を希望する場合は、https://accounts.magento.cloud/user/api-tokens で作成し、環境変数（MAGENTO_CLOUD_CLI_TOKEN）として渡します。トークンが設定されている場合、ブラウザーログインはスキップされます。

セキュリティに関する注意： API トークンを使用すると、アカウントがアクセスできるすべてのプロジェクトへの完全なアクセス権が付与されます。機密性の高いシークレットとして扱ってください。トークンが漏えいした場合は、上記の URL で直ちに取り消してください。

MCP クライアントを設定する

Kilo

~/.config/kilo/kilo.json に設定します。

{
  "mcp": {
    "magento-cloud": {
      "type": "local",
      "command": ["npx", "-y", "mcp-magento-cloud"]
    }
  }
}

ブラウザーログインの代わりに API トークンを使用する場合は、environment キーを追加します。

{
  "mcp": {
    "magento-cloud": {
      "type": "local",
      "command": ["npx", "-y", "mcp-magento-cloud"],
      "environment": {
        "MAGENTO_CLOUD_CLI_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に設定します。

{
  "mcpServers": {
    "magento-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-magento-cloud"]
    }
  }
}

Gemini CLI

~/.gemini/settings.json に設定します。

{
  "mcpServers": {
    "magento-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-magento-cloud"]
    }
  }
}

利用可能なツール

REST API ツール

ツール	説明
list_projects	現在のユーザーが利用できるすべてのプロジェクトを一覧表示します
list_environments	プロジェクトのすべての環境を一覧表示します
get_environment_info	環境の詳細情報を取得します
get_environment_urls	環境の公開 URL を取得します
list_activities	フィルターを指定して最近のアクティビティを一覧表示します
get_activity_log	アクティビティの完全なログを表示します
list_variables	プロジェクトまたは環境の変数を一覧表示します
list_services	バージョンとディスク割り当てを含むサービスを一覧表示します

SSH ツール

ツール	説明
execute_sql	リモートデータベースで読み取り専用の SQL クエリを実行します
get_environment_logs	サーバーログ（デプロイ、エラー、cron など）を読み取ります
get_environment_relationships	サービス接続の詳細（ホスト、ポート、認証情報）を取得します
list_log_types	利用可能なログの種類を一覧表示します

書き込みツール

ツール	説明
set_cloud_config	SSH 経由で bin/magento config:set を使い、Magento の設定値を設定します（scope/scope_code および暗号化された値に対応）。production 環境ではブロックされます。
create_branch	integration からクローンした新しい環境ブランチを作成します
push_branch	SSH 証明書認証を使って、ローカルの git ブランチをプロジェクトにプッシュします

セキュリティ

• SQL クエリは検証されます — SELECT、SHOW、DESCRIBE、EXPLAIN のみ許可されます
• インジェクションを防ぐため、SQL コメントは削除され、複数のステートメントはブロックされます
• Production は保護されています — set_cloud_config は production 環境に対する実行を拒否します。このような変更は手動で行う必要があります
• SSH 認証には、Magento Cloud API によって署名された一時的な Ed25519 証明書を使用します
• ブラウザーログインでは、更新トークンをローカルに 0600 権限で保存します
• API トークンは機密性の高いシークレットとして扱ってください — すべてのプロジェクトへの完全なアクセス権が付与されます

MCP Inspector でのテスト

# Browser login will open automatically on first tool use
npx @modelcontextprotocol/inspector node dist/main.js

# Or with API token
MAGENTO_CLOUD_CLI_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/main.js

開発

git clone https://github.com/juan-cinto-infracommerce/mcp-magento-cloud.git
cd mcp-magento-cloud
npm install
npm run build
npm start

ライセンス

MIT