VTEX IO MCP
Überblick
Beschreibung vom Entwickler (englisches Original)
Scaffold VTEX IO apps, Node services and GraphQL, look up Store Framework block props, search docs
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiGanz neu↓ 142/Wo. · ★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Läuft auf deinem Computer
- Transport: stdio
- Kategorie: Suche & KI-Gedächtnis
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
- Die Registry nennt keinen Schlüssel zum Eintragen.
Du brauchst
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"vtex-io": {
"command": "npx",
"args": [
"-y",
"vtex-io-mcp"
]
}
}
}Führe das in deinem Terminal aus
claude mcp add vtex-io -- npx -y vtex-io-mcpOder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"vtex-io": {
"command": "npx",
"args": [
"-y",
"vtex-io-mcp"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"vtex-io": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vtex-io-mcp"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto zeluizr bestätigt, dem das Repo gehört
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Im Vergleich mit anderen in Suche & KI-Gedächtnisi
- Mehr Sterne als 0 % der anderen 5756 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 48 % der anderen 5756 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 5756 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist VTEX IO MCP sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.8) kam vor 43 Tagen in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Context7, Codebase Memory, Exa
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
vtex-io-mcp
Servidor MCP para desarrollar en VTEX IO: Store Framework, React, Node, GraphQL y Admin.
Instalación
claude mcp add vtex-io -- npx -y @commenteme/vtex-io-mcp
El cliente MCP corre el servidor con npx, así que no hace falta instalar nada. Requiere Node >= 18. Para Claude Desktop, Cursor, VS Code y Windsurf, mira Clientes MCP.
Uso rápido
Reinicia el cliente y pide lo que necesitas. El asistente elige la herramienta:
- "Crea una app VTEX IO llamada
product-reviewscon los builders react, node, graphql y store" - "Que props acepta el
flex-layout.row? Dame un ejemplo con dos columnas" - "Genera un servicio Node con una ruta pública
GET /_v/order/:orderIdy un handler paraorder.created" - "Arma el esquema GraphQL con una query
productReviews(productId: ID!)y una mutationaddReview" - "Busca en la documentación como funcionan las CSS Handles"
- "Que endpoints tiene la API de Master Data?"
Que incluye
- Scaffolding de apps VTEX IO:
manifest.jsony carpetas para cualquier combinación de builders. - Backend listo para empezar: servicio Node con
service.json, clients, rutas HTTP y handlers de eventos; esquema GraphQL con resolvers tipados. - Store Framework: props, ejemplos y JSONC validado para los blocks del catálogo.
- Documentación en el editor: 391 documentos de VTEX y 10 cursos oficiales, con búsqueda por palabras clave.
- Local y sin credenciales: todo el conocimiento va en el paquete. No llama a APIs externas ni pide claves.
Funciona con Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, Windsurf y cualquier cliente MCP por stdio.
Documentación
Clientes MCP
Claude Code. Para compartirlo con el equipo en un repositorio, agrega --scope project al comando de Instalación: la configuración queda en .mcp.json.
Claude Desktop, en claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\). Cursor, en ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto). Windsurf, en ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": { "vtex-io": { "command": "npx", "args": ["-y", "@commenteme/vtex-io-mcp"] } } }
VS Code, en .vscode/mcp.json:
{
"servers": { "vtex-io": { "type": "stdio", "command": "npx", "args": ["-y", "@commenteme/vtex-io-mcp"] } } }
Codex, con el CLI (queda en ~/.codex/config.toml):
codex mcp add vtex-io -- npx -y @commenteme/vtex-io-mcp
O a mano, en ~/.codex/config.toml o en .codex/config.toml del proyecto:
[mcp_servers.vtex-io]
command = "npx" args = ["-y", "@commenteme/vtex-io-mcp"]
Gemini CLI, con el CLI (-s user lo deja en ~/.gemini/settings.json; sin -s, en .gemini/settings.json del proyecto):
gemini mcp add -s user vtex-io npx -y @commenteme/vtex-io-mcp
GitHub Copilot CLI, en ~/.copilot/mcp-config.json o en .mcp.json del proyecto, con el mismo JSON de mcpServers de arriba. En VS Code, Copilot usa el .vscode/mcp.json.
Otros clientes. Cualquiera con transporte stdio sirve: el comando es npx y los argumentos, -y @commenteme/vtex-io-mcp. Si prefieres instalación global, npm install -g @commenteme/vtex-io-mcp y usa vtex-io-mcp como comando.
El servidor está en el Official MCP Registry como io.github.commentemeapp/vtex-io-mcp.
Herramientas
La entrada src/index.ts conecta el servidor por stdio: el cliente inicia el proceso y habla por la entrada y salida estándar, sin abrir puerto HTTP. Las nueve herramientas se registran en src/tools/index.ts.
Apps y backend
| herramienta | parámetros | que hace |
|---|---|---|
scaffold-vtex-app | appName, vendor, builders, version?, description? | Genera manifest.json y las carpetas de los builders elegidos: store, react, node, graphql, styles, messages, admin, pixel, docs. |
scaffold-node-service | appName, vendor, routes?, events?, memory?, timeout? | Genera node/index.ts, service.json, clients y middlewares. Cada ruta lleva name, path, method y public; cada evento, name, sender y keys. |
scaffold-graphql | appName, vendor, queries?, mutations? | Genera schema.graphql y los resolvers en TypeScript, con argumentos, tipo de retorno y descripción. |
Store Framework
| herramienta | parámetros | que hace |
|---|---|---|
lookup-block-props | blockName | Devuelve descripción, props y ejemplos de un block. |
add-block | blockName, blockId?, props?, children? | Genera un fragmento JSONC para blocks.jsonc y valida las props contra el esquema del block. |
Blocks disponibles hoy: rich-text, info-card, flex-layout.row, flex-layout.col, shelf, image.
Documentación
| herramienta | parámetros | que hace |
|---|---|---|
search-concepts | query, maxResults? | Busca por palabras clave en los 391 documentos y devuelve resultados ordenados con extractos. |
explain-concept | concept | Devuelve el documento completo de un concepto por su ID. |
search-courses | query, courseId? | Busca en los cursos oficiales de VTEX IO y devuelve extractos con contexto. |
lookup-vtex-api | api | Referencia REST de una API de VTEX: catalog, orders, checkout, master-data, logistics, pricing, intelligent-search, session, headless-cms, promotions, payments-gateway, license-manager. |
Resources
| URI | contenido |
|---|---|
vtex://concepts | Índice de los documentos, agrupados por prefijo. |
vtex://concepts/{conceptId} | Documento completo de un concepto. |
vtex://courses | Índice de los cursos, con título, descripción y número de pasos. |
vtex://courses/{id} | Contenido completo de un curso: onboarding, basic-blocks, layout-blocks, styles-course, store-block, service-course, calling-commerce-apis, admin, content-workflow, store-performance. |
Hoja de ruta
- Mas blocks de Store Framework: layouts (
slider-layout,tab-layout,responsive-layout,stack-layout,condition-layout,modal-layout,disclosure-layout), producto (product-summary,product-images,product-price,sku-selector,buy-button), búsqueda, header, footer, minicart y login - Referencia de todos los builders en
data/builders/(hoy:storeynode) - Herramientas de Store Framework:
validate-blocks,create-page-template - Herramientas de React:
generate-react-component,add-css-handles,create-graphql-query - Herramientas de backend:
add-route-handler,add-event-handler,create-client,add-graphql-field - Herramientas de manifiesto:
add-builder,add-dependency,add-policy,generate-manifest - Scaffolding de apps Admin y Pixel
- Resources
vtex://builders/{name}yvtex://api/{client}con los clients de@vtex/api - Prompts MCP para escenarios comunes: home, PDP, servicio REST, app fullstack, app Admin
- Scripts de ingestión para actualizar
data/desde los cursos y los README devtex-apps
Estructura
src/
├── index.ts # entry point del binario (stdio) ├── server.ts # McpServer: registra tools y resources ├── tools/ # una herramienta por archivo, registradas en tools/index.ts ├── resources/ # vtex://concepts y vtex://courses └── knowledge/ # carga y búsqueda sobre data/ data/ ├── blocks/ # un JSON por block + _index.json ├── builders/ # referencia por builder ├── concepts/ # documentación en Markdown └── courses/ # cursos en Markdown + _index.json assets/ # header del README (no va en el paquete npm)
Desarrollo
git clone https://github.com/commentemeapp/vtex-io-mcp.git
cd vtex-io-mcp npm install npm run build npm run inspect
npm run inspect abre el MCP Inspector sobre build/index.js para llamar cada herramienta y leer los resources sin cliente. Para probar la versión local en un cliente, apunta el comando a la build en vez de npx:
claude mcp add vtex-io-local -- node /ruta/a/vtex-io-mcp/build/index.js
| comando | que hace |
|---|---|
npm run build | Compila TypeScript en build/ y marca el binario como ejecutable. |
npm run dev | Compilación en modo _watch_. |
npm run lint | Verificación de tipos (tsc --noEmit). |
npm run inspect | Abre el MCP Inspector sobre el servidor compilado. |
Agregar una herramienta
- Crea
src/tools/ .tsexportando el esquema zod (Schema) y la función que devuelve el contenido. - Regístrala en
src/tools/index.tsconserver.tool(nombre, descripción, esquema, función). La descripción es lo que el modelo lee para decidir cuando usarla: di que hace y con que ejemplos. - Si necesita conocimiento nuevo, agrega los archivos en
data/y cárgalos desdesrc/knowledge/. npm run buildy pruébala en el Inspector.
Convenciones
- TypeScript con módulos ESM; Prettier sin punto y coma y con comillas simples.
- Conventional Commits.
- El conocimiento es solo lectura en tiempo de ejecución: nada se escribe en disco ni se descarga.
Ramas y publicación
El trabajo nace en una rama que sale de dev y el PR va contra dev. Después de probar localmente, dev se promueve a main con merge de la rama completa (sin qa desde el 30/10/2026). El CI corre lint y build en Node 18, 20 y 22.
Para publicar, sube la versión en package.json y CHANGELOG.md y empuja un tag v*: el workflow publish.yml compila, publica en npm con _provenance_, crea el GitHub Release y publica el server.json en el MCP Registry. Los cambios de cada versión están en CHANGELOG.md.
Contribuir · Licencia
Abre un issue o un PR contra dev. MIT.
Hecho por commente.me · hablecon@commente.me