ecforce Dev MCP Serverのセットアップ
ecforce Dev MCP Server は、次の AI アプリケーションから利用できます。
- Cursor
- Claude Code
- ChatGPT desktop app / Codex CLI
お使いのアプリケーションの手順だけ実施してください。
設定後はアプリを再起動し、チャットで動作を確認してください。
接続情報
ecforce Dev MCP Server の接続先は、次のとおりです。
以下の各アプリケーションの手順では、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
- macOS / Linux:
両方ある場合は、プロジェクト単位の設定が優先されます。
-
Cursor をインストールし、起動してください。
-
プロジェクト内の
.cursor/mcp.json、macOS / Linux の~/.cursor/mcp.json、または Windows の%USERPROFILE%\.cursor\mcp.jsonを開いてください。ファイルがない場合は、新規作成してください。 -
次の内容を貼り付けて保存してください。既存の設定がある場合は、
"ecforce-dev-mcp"の部分だけ追加してください。{ "mcpServers": { "ecforce-dev-mcp": { "url": "https://mcp.ec-force.com/theme/mcp" } } } -
Cursor を再起動してください。
-
チャットで「ecforce Dev MCP Server を参照して、ecforce FAQ を検索してください。」と入力し、応答が返ることを確認してください。
詳細は Cursor の MCP ドキュメント (opens in a new tab) を参照してください。
Claude Code
リモート HTTP サーバーは、--transport http で追加してください。
デフォルトの scope は local(実行したプロジェクトだけ)です。テーマ改修全般で使う場合は、--scope user を指定してください。
-
Claude Code が利用できる状態であることを確認してください。
-
ターミナルを開き、次のコマンドを実行してください。
claude mcp add --transport http --scope user ecforce-dev-mcp \ https://mcp.ec-force.com/theme/mcp -
登録を確認する場合は、次を実行してください。
claude mcp list -
Claude Code のセッションでは、
/mcpでも接続状態を確認してください。 -
チャットで「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 のコマンドで追加する(推奨)
-
Codex CLI が利用できる状態であることを確認してください。
-
ターミナルを開き、次のコマンドを実行してください。
codex mcp add ecforce-dev-mcp \ --url https://mcp.ec-force.com/theme/mcp -
登録を確認する場合は、次を実行してください。
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 へ接続できないときは、次を確認してください。
- アプリを再起動してください。
- MCP サーバーが接続済みかを、各アプリの MCP 設定画面で確認してください。
- 対象の画面名を具体的に書いて、もう一度依頼してください。