convexskills MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

12 habilidades específicas de Convex con ejemplos de código real
Cubre funciones (query/mutation/action/HTTP), esquema, tiempo real, cron, almacenamiento de archivos, agentes
Dos habilidades de seguridad: convex-security-check y convex-security-audit
Patrones de migración para la evolución del esquema
convex-component-authoring para componentes reutilizables

Demo en vivo

Cómo se ve en la práctica

convexskills-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "convexskills-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "convexskills-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/waynesutton/convexskills",
          "~/.claude/skills/convexskills"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add convexskills-skill -- git clone https://github.com/waynesutton/convexskills ~/.claude/skills/convexskills

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: convexskills

Andamiar una nueva aplicación Convex con tiempo real + autenticación + carga de archivos

👤 Desarrolladores full-stack que inician un nuevo proyecto Convex ⏱ ~90 min intermediate

Cuándo usarlo: Estás empezando de cero y quieres patrones correctos de Convex desde el archivo uno.

Requisitos previos

Convex CLI — npm create convex

Flujo

Diseñar el esquema

Usa la habilidad convex-schema-validator. Diseña tablas para usuarios, proyectos y archivos con índices apropiados.✓ Copiado

→ El esquema usa v.id(), índices declarados, relaciones correctas
Conectar consultas y mutaciones

Usa la habilidad convex-functions. Implementa CRUD para proyectos.✓ Copiado

→ Consulta para lecturas, mutación para escrituras, sin mal uso de acciones
Agregar tiempo real + carga de archivos

Usa convex-realtime y convex-file-storage para que los proyectos se actualicen en vivo con archivos adjuntos.✓ Copiado

→ React se suscribe a través de useQuery, archivos almacenados a través de storage.generateUploadUrl

Resultado: Una aplicación Convex correctamente estructurada sobre la que puedas construir.

Errores comunes

Usar acciones donde las mutaciones son suficientes — La habilidad obliga: mutaciones para escrituras en BD, acciones para E/S externa

Agregar un trabajo cron diario que limpie filas antiguas

👤 Desarrolladores de Convex que agregan mantenimiento en segundo plano ⏱ ~20 min beginner

Cuándo usarlo: Necesitas una tarea programada sin ejecutar un worker.

Flujo

Usa la habilidad cron

Usa convex-cron-jobs. Agrega un trabajo diario que elimine filas de más de 30 días de la tabla sesiones.✓ Copiado

→ Entrada crons.ts + mutación interna para la limpieza
Probar

Dame una forma de disparar esto manualmente para pruebas.✓ Copiado

→ Acción HTTP solo para desarrollo o receta CLI

Resultado: Un cron ejecutándose en el planificador administrado de Convex.

Errores comunes

Cron ejecuta una consulta en lugar de una mutación interna — La habilidad obliga mutación interna para eliminaciones

Auditar una aplicación Convex para encontrar agujeros de autorización

👤 Desarrolladores antes de un lanzamiento a producción ⏱ ~45 min advanced

Cuándo usarlo: Tu aplicación está lista pero no has probado la autenticación bajo presión.

Flujo

Ejecutar la auditoría

Usa convex-security-audit en este repo. Verifica que cada mutación pública tenga autenticación adecuada.✓ Copiado

→ Postura de autenticación por función con gravedad
Corregir

Aplica las correcciones con verificaciones de identidad y retorna nulo para lecturas no autorizadas.✓ Copiado

→ Funciones actualizadas con verificaciones ctx.auth

Resultado: Autenticación reforzada antes de producción.

Errores comunes

Confiar en el modelo mental 'public=unauthenticated' — Las funciones públicas de Convex son accesibles desde INTERNET; la habilidad insiste en verificaciones de autenticación

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

convexskills-skill + github

La habilidad diseña + implementa; el MCP de GitHub abre el PR

Usa convexskills para construir la función, luego abre un PR con los cambios.✓ Copiado

convexskills-skill + playwright-skill

Construir backend Convex, luego Playwright prueba la UI de extremo a extremo

Implementa el backend de Convex, luego escribe una prueba playwright-skill que golpee la UI y verifique actualizaciones en tiempo real.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
convex-functions	necesidad de función	Cualquier trabajo de función
convex-schema-validator	modelo de datos	Diseñar o cambiar tablas
convex-realtime	caso de uso de UI	Agregar UI reactiva
convex-cron-jobs	tarea programada	Trabajo periódico en segundo plano
convex-migrations	cambio de esquema	Evolucionar un esquema existente
convex-security-audit	repo	Revisión previa a producción

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno para la habilidad; Convex tiene sus propios niveles gratuito + de pago
Tokens por llamada: 2-6k por habilidad cargada
Monetario: Gratuito — la habilidad es local. Convex tiene un nivel gratuito generoso.
Consejo: Nombra la habilidad específica (por ejemplo, convex-cron-jobs) para evitar cargar el conjunto completo.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales en la habilidad. Las claves de despliegue de Convex permanecen en tu .env.

Salida de datos: Ninguno de la habilidad en sí

Las funciones públicas de Convex son accesibles desde Internet. Siempre ejecuta convex-security-audit antes de ir a producción.

Resolución de problemas

Errores comunes y soluciones

Claude escribe una acción cuando una mutación es suficiente

Regla general que la habilidad obliga: solo BD → mutación; E/S externa → acción.

El cambio de esquema rompe los datos existentes

Usa la habilidad convex-migrations — planifica transiciones seguras con relleno.

useQuery no se actualiza en tiempo real

Verifica la reactividad: la consulta debe leer los datos que cambiaron, no un índice antiguo.

Alternativas

convexskills vs otros

Alternativa	Cuándo usarla	Contrapartida
Documentos de Convex manual + ejemplos	Ya eres un desarrollador experimentado de Convex	Incorporación más lenta sin la habilidad
Habilidades fullstack específicas del framework	No estás en Convex	Stack diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills