Vercel × agente de codificación de IA: el trío de Plugin, Skills y MCP
Objetivo en una frase: con tres comandos oficiales, instala en tu agente de codificación de IA el trío de Plugin, Skills y MCP de Vercel, para que opere directamente tu proyecto de Vercel y te ahorres el ir y venir entre la terminal y la ventana de conversación.
Preparación
Antes de empezar, confirma tres cosas:
- En la terminal se puede ejecutar
npx(lo que indica que Node.js ya está instalado); si aparececommand not found, instala Node.js antes de continuar. - Has leído Manual avanzado: haz que la IA entienda mejor tu proyecto y tu proyecto ya tiene configurado un agente de codificación de IA (por ejemplo, Claude Code).
- Se recomienda repasar antes Despliegue en Vercel: despliegue con un solo comando del agente de codificación de IA para conocer lo básico de cómo el agente despliega en Vercel.
Cada pieza del trío cubre una parte: el Plugin aporta al agente las capacidades oficiales de Vercel, las Skills ofrecen prácticas estándar recopiladas oficialmente, y el MCP se encarga de conectar el agente a tu proyecto de Vercel. Los tres comandos provienen de Vercel oficial y escriben la configuración automáticamente, así que no tienes que editar archivos a mano; ejecútalos en orden en el directorio raíz del proyecto.
Hazlo conmigo
Paso 1: instalar el Vercel Plugin
Ejecuta en el directorio raíz del proyecto:
npx plugins add vercel/vercel-pluginLa primera vez descargará el paquete antes de instalarlo; espera un momento. Resultado esperado: el comando termina sin errores, el paquete del plugin vercel/vercel-plugin entra en la configuración del agente y, en conversaciones posteriores, el agente reconoce tareas relacionadas con Vercel.
Paso 2: añadir Agent Skills
A continuación, ejecuta:
npx skills add vercel-labs/agent-skillsEsto entrega al agente el paquete de skills vercel-labs/agent-skills mantenido oficialmente por Vercel. Según la documentación oficial, este comando está dirigido sobre todo a los agentes que no figuran en la lista de plugins compatibles; los agentes de la lista (Claude Code, Codex, Cursor, GitHub Copilot, etc.) ya obtienen las skills de despliegue y las mejores prácticas de frameworks al instalar el Plugin del paso 1. Resultado esperado: las skills se añaden con éxito y el agente cuenta con referencias oficiales al tratar tareas comunes de proyectos de Vercel, en lugar de improvisar solo con la memoria del modelo.
Paso 3: conectar el servidor Vercel MCP
Por último, ejecuta:
npx -y add-mcp https://mcp.vercel.com -gEste comando registra en el agente el servidor MCP (Model Context Protocol) oficial de Vercel https://mcp.vercel.com; -y hace que npx omita la confirmación de descarga, de modo que puedes copiar el comando tal cual, y -g indica que surte efecto globalmente, así que después todos los proyectos podrán conectarse a él.@@I18N_KEEP_000009@@Resultado esperado: el comando indica que la adición fue exitosa y mcp.vercel.com aparece en la lista de servidores del agente.
Verificación
Abre una nueva sesión del agente (la nueva configuración no se recarga en caliente) y da la instrucción directamente:
Ayúdame a revisar el estado de mis proyectos en Vercel y luego despliega el proyecto actual.
Si el agente empieza a invocar herramientas relacionadas con Vercel, en lugar de soltarte un comando para que lo ejecutes tú mismo, el trío de Vercel MCP ya está configurado; cuando termine el despliegue, pídele que te envíe la URL en línea y ábrela para confirmar que la página funciona. Si usas Claude Code, también puedes escribir /mcp para ver el estado de conexión de los servidores.@@I18N_KEEP_000010@@
Si el agente dice que no encuentra las herramientas relacionadas, vuelve al paso 3 para confirmar que el comando se ejecutó con éxito y luego abre una nueva sesión e inténtalo de nuevo.
Errores comunes
- Directorio equivocado: los tres comandos deben ejecutarse en el directorio raíz del proyecto; no los ejecutes en un subdirectorio ni en otro proyecto.
- npx se queda en el aviso de confirmación: el tercer comando incluye
-ypara confirmar automáticamente; si los dos primeros preguntan si deseas instalar un paquete, solo confirma según el aviso. - El agente no cambia tras la instalación: el agente no recarga automáticamente la nueva configuración; abre una nueva sesión y vuelve a intentarlo.
- MCP no se conecta: la primera conexión a
mcp.vercel.compuede requerir completar la autorización de la cuenta de Vercel; sigue las indicaciones que dé el agente hasta completar el proceso y vuelve a intentarlo.@@I18N_KEEP_000011@@ - Solo instalaste una o dos piezas: según la documentación oficial, entre Plugin y Skills se elige uno según el agente (Plugin para los de la lista de compatibilidad, Skills para los que no están); no hace falta instalar ambos; el MCP se encarga por separado de conectar el agente a tu proyecto de Vercel, así que se recomienda configurarlo.
Próxima lección
A partir de aquí, el agente ya puede operar Vercel directamente por ti. En la próxima lección Dominio personalizado: de github.io a tu propio dominio, cambiarás la dirección temporal del despliegue por tu propio dominio. Si quieres reforzar aún más la comprensión del agente sobre este proyecto, puedes usarlo junto con AGENTS.md y CLAUDE.md: deja a la IA un manual de tu proyecto.