@stronger-ecommerce/gadget-mcp

Servidor MCP genérico de solo lectura para cualquier aplicación de Gadget. Consulta cualquier modelo mediante introspección de GraphQL: no se requiere cliente generado.

Creado por Stronger eCommerce.

Configuración rápida (recomendada)

Ejecuta el asistente de configuración interactivo desde el directorio de tu proyecto Gadget. Detecta automáticamente el slug de tu aplicación desde .gadget/sync.json y escribe tu configuración automáticamente.

npx @stronger-ecommerce/gadget-mcp setup

El asistente hará lo siguiente:

1. Detectar el slug de tu aplicación desde .gadget/sync.json (si existe)

2. Solicitar tu clave de API y entorno

3. Generar el comando claude mcp add listo para ejecutar para Claude Code

4. Escribir automáticamente tu ~/.cursor/mcp.json para Cursor

Configuración manual

1. Obtén una clave de API de producción

Ve a https://<tu-app>.gadget.app/edit/settings/api-keys y crea una clave con acceso de lectura.

2. Regístrate en Claude Code

claude mcp add my-app-gadget \
  -e GADGET_APP=my-app \
  -e GADGET_API_KEY=your_key_here \
  -- npx @stronger-ecommerce/gadget-mcp

Registra múltiples aplicaciones con nombres diferentes:

claude mcp add app-one-gadget \
  -e GADGET_APP=my-first-app \
  -e GADGET_API_KEY=key1 \
  -- npx @stronger-ecommerce/gadget-mcp

claude mcp add app-two-gadget \
  -e GADGET_APP=my-second-app \
  -e GADGET_API_KEY=key2 \
  -- npx @stronger-ecommerce/gadget-mcp

3. Regístrate en Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "app-one-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-first-app",
        "GADGET_API_KEY": "key1"
      }
    },
    "app-two-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-second-app",
        "GADGET_API_KEY": "key2"
      }
    }
  }
}

Variables de entorno

Herramientas

Ejemplo de uso

Una vez conectado, pregúntale a Claude:

• "Lista los modelos en mi aplicación Gadget"

• "Muéstrame los campos del modelo shopifyOrder"

• "Busca pedidos donde el correo electrónico sea customer@example.com"

• "Obtén todos los registros con errores"

Funciones futuras

Las ideas planificadas y las notas de investigación (incluyendo registros / integración de ggt para agentes) se encuentran en FUTURE_FEATURES.md.

Contribución

¡Los informes de errores y las solicitudes de extracción (pull requests) son bienvenidos!

• ¿Encontraste un error? Abre un issue

• ¿Tienes una corrección o función? Haz un fork del repositorio, realiza tus cambios y abre un PR contra main

• Para cambios significativos, abre un issue primero para que podamos alinear el enfoque

Ejecución local

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

Acerca de

Hecho con ♥ por Stronger eCommerce — Desarrollo de Shopify y operaciones de comercio electrónico.