Commerce MCP Studio
iman-suherman/urp-ct-mcp-studio
Painel VS Code para gerenciar Commerce MCP servers commercetools
Ver no GitHubExtensão VS Code para configurar, explorar, testar e usar servidores Commerce MCP com projetos commercetools. Gerencia conexões, descobre ferramentas dinamicamente e sincroniza configurações diretamente no VS Code Chat, eliminando a necessidade de editar JSON manualmente.
Instalação
npx convez-ai iman-suherman/urp-ct-mcp-studio1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Configurar e testar conexões MCP com projetos commercetools
- Descobrir e executar ferramentas MCP em um playground integrado
- Gerenciar credenciais e sincronizar configurações para VS Code Chat
- Debugar e validar integrações de ecommerce sem editar JSON
Veredito

Ferramenta especializada para devs que trabalham com commercetools, integrando MCP servers diretamente no fluxo VS Code. Reduz atrito na configuração e testes, mas tem escopo limitado ao ecossistema commercetools.
README
A tradução para o português deste README ainda está na fila.
Commerce MCP Studio
VS Code extension for configuring, exploring, testing, and using Commerce MCP servers with commercetools projects.
Instead of hand-editing MCP JSON, use the Commerce MCP side panel to manage connections, discover tools dynamically, run tools in a playground, and sync configuration into VS Code Chat.
Download: pre-built VSIX packages and release history are available at ct-mcp.suherman.net.
Install the extension
Download the latest VSIX from CT MCP — browse release history and pick a version, or use Download latest VSIX.
In VS Code: open Extensions → click ⋯ → Install from VSIX… → select the downloaded
.vsixfile.Reload the window (Developer: Reload Window) if prompted, then click the Commerce MCP icon in the Activity Bar.
Building from source? See Install the extension or Development.
Table of contents
Extension
- Prerequisites
- Install the extension
- First-time setup
- Configuration
- Commands
- Extension source layout
- Troubleshooting
Documentation
- Documentation index
- Development — build, watch, run from source, package VSIX
- Publishing & releases — GCP login, upload, semver releases
- Registry API — version history service
- Marketing website — public download site
- npm scripts reference
Prerequisites
| Requirement | Notes |
|---|---|
| Node.js 18+ | Required to run Commerce MCP via npx |
| VS Code 1.90+ | Extension host (engines.vscode) |
| Network access | First connect downloads @commercetools/commerce-mcp through npx |
You also need commercetools API credentials for your project:
- Project Key
- Client ID
- Client Secret
- Auth URL
- API URL
Client secrets are stored in VS Code Secret Storage only — never in settings.json.
For building from source or publishing releases, see Development and Publishing & releases.
Install the extension
Option 1 — Download from CT MCP (recommended)
The easiest way to install Commerce MCP Studio:
- Open https://ct-mcp.suherman.net/.
- Click Download latest VSIX, or open Versions to pick a specific release.
- In VS Code: Extensions → ⋯ → Install from VSIX… → select the downloaded file.
- Reload the window (Developer: Reload Window) if prompted.
- Click the Commerce MCP icon in the Activity Bar.
You can also install from the CLI after downloading:
code --install-extension ~/Downloads/ct-mcp-studio-0.1.0.vsix
Option 2 — Run from source (development)
Best for local development and debugging.
- Open this folder in VS Code.
- Run Terminal → Run Task… or press F5 and choose Run Extension.
- A new Extension Development Host window opens with the extension loaded.
- Click the Commerce MCP icon in the Activity Bar (left sidebar).
The launch configuration is in .vscode/launch.json. See Development for build and watch details.
Option 3 — Build and install a VSIX locally
Package the extension for installation in any VS Code instance:
npm install && npm run build && npm run package
This creates releases/ct-mcp-studio-0.1.0.vsix (version from package.json).
Install the package:
code --install-extension releases/ct-mcp-studio-0.1.0.vsix
Or in VS Code: Extensions view → ⋯ menu → Install from VSIX… → select the .vsix file from releases/.
Reload the window (Developer: Reload Window) after installing.
Prefer a pre-built release? Use CT MCP instead of building yourself.
Option 4 — Install from folder (advanced)
See Development — Install from folder.
First-time setup
- Open the Commerce MCP side panel.
- Go to the Connections tab.
- Enter connection details and click Save Connection.
- Click Connect.
On connect, the extension:
- Spawns
@commercetools/commerce-mcpover stdio - Calls
tools/listto discover available tools - Optionally syncs
mcp.servers.commerce-mcpfor VS Code Chat (whenctMcp.syncNativeMcpConfigis enabled)
- Click Open Explorer to run tools with JSON arguments.
Configuration
Settings are under Commerce MCP Studio (ctMcp.*):
| Setting | Default | Description |
|---|---|---|
ctMcp.autoConnectOnStartup | true | Reconnect to the last active connection on startup |
ctMcp.syncNativeMcpConfig | true | Write native mcp.servers config for Chat |
ctMcp.dynamicToolLoadingThreshold | 450 | Tool injection limit when using --tools=all |
ctMcp.commerceMcpPackage | @commercetools/commerce-mcp@latest | npm package spawned by the extension |
Default Auth/API URLs for new connections come from ct-mcp-studio.json at the extension root.
Commands
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for Commerce MCP:
| Command | Description |
|---|---|
| Open Commerce MCP Studio | Focus the side panel |
| Open MCP Explorer | Open the tool playground |
| Connect Commerce MCP | Connect the active connection |
| Disconnect Commerce MCP | Stop the MCP process |
| Refresh Commerce MCP | Reload the tool list |
Extension source layout
The VS Code extension lives under src/ and compiles to out/:
src/
├── extension.ts # Activation, commands, view registration
├── studioViewProvider.ts # Commerce MCP side panel webview
├── studioUi.ts # Side panel UI templates
├── explorerPanel.ts # MCP Explorer playground panel
├── explorerUi.ts # Explorer UI templates
├── mcpManager.ts # Connection lifecycle and tool calls
├── mcpProcessManager.ts # Spawn and manage commerce-mcp process
├── mcpBootstrap.ts # MCP client bootstrap over stdio
├── nativeMcpBridge.ts # Sync mcp.servers config for VS Code Chat
├── connectionStore.ts # Saved connection profiles
├── secrets.ts # VS Code Secret Storage for client secrets
├── config.ts # ctMcp.* settings and defaults
├── toolCatalog.ts # Tool discovery and catalog
├── templates.ts # Shared HTML/CSS/JS for webviews
├── responseFormat.ts # Format MCP tool responses for display
├── logStore.ts # In-panel log buffer
├── media.ts # Webview asset URIs
└── types.ts # Shared TypeScript types
out/ # Compiled JavaScript (generated by npm run build)
media/ # Extension icon and branding assets
ct-mcp-studio.json # Bundled default auth/API URLs
For the full repository layout (scripts, services, website), see Development — Repository layout.
Troubleshooting
Connect fails immediately
- Verify Client ID, Client Secret, Project Key, Auth URL, and API URL.
- Ensure Node.js and
npxare on yourPATH(VS Code inherits the shell environment). - Check the Logs tab in the side panel.
Tools do not appear
- Confirm the API client has scopes for the tools you expect.
- Try Refresh after connect.
- Lower or raise
ctMcp.dynamicToolLoadingThresholdif using--tools=all.
Chat does not see Commerce MCP
- Ensure
ctMcp.syncNativeMcpConfigis enabled. - Reload MCP in VS Code if available (
mcp.reload/ MCP: Reload). - Check
~/Library/Application Support/Code/User/mcp.json(macOS) for acommerce-mcpentry.
Extension does not load after install
- Run
npm run buildand confirmout/extension.jsexists. - Reload VS Code (Developer: Reload Window).
GCP login or upload fails
See Publishing & releases — Troubleshooting.
Related documentation
License
This project is licensed under the MIT License.