VTEX IO MCP

Name: VTEX IO MCP
Author: zeluizr

제작자: zeluizr버전 0.1.8i★ 0i내 컴퓨터에서 실행

레지스트리 이름io.github.zeluizr/vtex-io-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

Scaffold VTEX IO apps, Node services and GraphQL, look up Store Framework block props, search docs

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i2개 중 2개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아주 새로움↓ 142/주 · ★ 0

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 검색 및 AI 기억

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 2개 중 2개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "vtex-io": {
      "command": "npx",
      "args": [
        "-y",
        "vtex-io-mcp"
      ]
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add vtex-io -- npx -y vtex-io-mcp

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "vtex-io": {
      "command": "npx",
      "args": [
        "-y",
        "vtex-io-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "vtex-io": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vtex-io-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 10일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 zeluizr 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
✓ 통과
계속 관리되고 있음
코드 마지막 변경: 4일 전
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

검색 및 AI 기억 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 5875개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 5875개 중 47%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 5875개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

VTEX IO MCP, 안전한가요?

해당하는 기본 점검 2개 중 2개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 4일 전 변경됐고, 최신 버전(0.1.8)은 지난달 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Ruflo, Context7, Metabase

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Ruflo

Agent teams, swarms, memory and hooks for Claude Code and Codex, served over MCP.

제작자: ruvnet널리 사용됨↓ 7.4만/주★ 8.1만오늘 업데이트

내 컴퓨터에서 실행

설치

Context7

Up-to-date docs for AI agents

제작자: upstash널리 사용됨↓ 125만/주★ 6.4만어제 업데이트

컴퓨터 또는 클라우드

설치

Metabase

Lets AI clients search, explore, query, and visualize data in a Metabase instance.

제작자: metabase널리 사용됨★ 5만6개월 전 업데이트

클라우드에서 실행

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

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-reviews con 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/:orderId y un handler para order.created"
"Arma el esquema GraphQL con una query productReviews(productId: ID!) y una mutation addReview"
"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.json y 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: store y node)
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} y vtex://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 de vtex-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/ .ts exportando el esquema zod ( Schema) y la función que devuelve el contenido.
Regístrala en src/tools/index.ts con server.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 desde src/knowledge/.
npm run build y 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

VTEX IO MCP

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

어떤 앱에서 쓸 수 있나요

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

검색 및 AI 기억 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Ruflo

Context7

Metabase

제작자의 README

vtex-io-mcp

Instalación

Uso rápido

Que incluye

Documentación

Clientes MCP

Herramientas

Resources

Hoja de ruta

Estructura

Desarrollo

Agregar una herramienta

Convenciones

Ramas y publicación

Contribuir · Licencia