ecforce Dev MCP Server
セットアップ

ecforce Dev MCP Serverのセットアップ

ecforce Dev MCP Server は、次の AI アプリケーションから利用できます。

  • Cursor
  • Claude Code
  • ChatGPT desktop app / Codex CLI

お使いのアプリケーションの手順だけ実施してください。
設定後はアプリを再起動し、チャットで動作を確認してください。

接続情報

ecforce Dev MCP Server の接続先は、次のとおりです。

項目内容
エンドポイント(接続先 URL)https://mcp.ec-force.com/theme/mcp
接続方式Streamable HTTP
認証不要

以下の各アプリケーションの手順では、https://mcp.ec-force.com/theme/mcp を設定に登録してください。

動作確認

設定後、チャットで「ecforce Dev MCP Server を参照して、ecforce FAQ を検索してください。」と入力し、応答が返ることを確認してください。

アプリの画面やコマンドは更新されることがあります。手順でつまずいた場合は、各節末尾の公式ドキュメントも確認してください。

Cursor

手動で設定する場合は、次のいずれかの mcp.json に登録してください。

  • プロジェクト単位: プロジェクト内の .cursor/mcp.json(チームで共有する場合)
  • ユーザー単位: ホームディレクトリの mcp.json(すべてのプロジェクトで使う場合)
    • macOS / Linux: ~/.cursor/mcp.json
    • Windows: %USERPROFILE%\.cursor\mcp.json

両方ある場合は、プロジェクト単位の設定が優先されます。

  1. Cursor をインストールし、起動してください。

  2. プロジェクト内の .cursor/mcp.json、macOS / Linux の ~/.cursor/mcp.json、または Windows の %USERPROFILE%\.cursor\mcp.json を開いてください。ファイルがない場合は、新規作成してください。

  3. 次の内容を貼り付けて保存してください。既存の設定がある場合は、"ecforce-dev-mcp" の部分だけ追加してください。

    {
      "mcpServers": {
        "ecforce-dev-mcp": {
          "url": "https://mcp.ec-force.com/theme/mcp"
        }
      }
    }
  4. Cursor を再起動してください。

  5. チャットで「ecforce Dev MCP Server を参照して、ecforce FAQ を検索してください。」と入力し、応答が返ることを確認してください。

詳細は Cursor の MCP ドキュメント (opens in a new tab) を参照してください。

Claude Code

リモート HTTP サーバーは、--transport http で追加してください。
デフォルトの scope は local(実行したプロジェクトだけ)です。テーマ改修全般で使う場合は、--scope user を指定してください。

  1. Claude Code が利用できる状態であることを確認してください。

  2. ターミナルを開き、次のコマンドを実行してください。

    claude mcp add --transport http --scope user ecforce-dev-mcp \
      https://mcp.ec-force.com/theme/mcp
  3. 登録を確認する場合は、次を実行してください。

    claude mcp list
  4. Claude Code のセッションでは、/mcp でも接続状態を確認してください。

  5. チャットで「ecforce Dev MCP Server を参照して、ecforce FAQ を検索してください。」と入力し、応答が返ることを確認してください。

プロジェクトで共有する場合は、--scope project を使ってください。リポジトリ直下の .mcp.json に書き出してください。

手動で JSON を書く場合は、type に http を指定してください。

{
  "mcpServers": {
    "ecforce-dev-mcp": {
      "type": "http",
      "url": "https://mcp.ec-force.com/theme/mcp"
    }
  }
}

詳細は Claude Code の MCP ドキュメント (opens in a new tab) を参照してください。

ChatGPT desktop app / Codex CLI

ChatGPT desktop app と Codex CLI は、Streamable HTTP に直接接続できます。
設定ファイルは ~/.codex/config.toml です。ChatGPT desktop app と Codex CLI で共通です。

Codex CLI のコマンドで追加する(推奨)

  1. Codex CLI が利用できる状態であることを確認してください。

  2. ターミナルを開き、次のコマンドを実行してください。

    codex mcp add ecforce-dev-mcp \
      --url https://mcp.ec-force.com/theme/mcp
  3. 登録を確認する場合は、次を実行してください。

    codex mcp list

ChatGPT desktop app と Codex CLI の設定ファイルを編集する

~/.codex/config.toml、またはプロジェクト単位の .codex/config.toml に、次を追加してください。

[mcp_servers.ecforce-dev-mcp]
url = "https://mcp.ec-force.com/theme/mcp"

設定後、ChatGPT desktop app または Codex CLI を再起動してください。
チャットで「ecforce Dev MCP Server を参照して、ecforce FAQ を検索してください。」と入力し、応答が返ることを確認してください。

詳細は Codex CLI のリファレンス (opens in a new tab) と 設定リファレンス (opens in a new tab) を参照してください。

うまく動かないとき

ecforce Dev MCP Server へ接続できないときは、次を確認してください。

  1. アプリを再起動してください。
  2. MCP サーバーが接続済みかを、各アプリの MCP 設定画面で確認してください。
  3. 対象の画面名を具体的に書いて、もう一度依頼してください。