Skip to content

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:

  1. En la terminal se puede ejecutar npx (lo que indica que Node.js ya está instalado); si aparece command not found, instala Node.js antes de continuar.
  2. 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).
  3. 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:

bash
npx plugins add vercel/vercel-plugin

La 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:

bash
npx skills add vercel-labs/agent-skills

Esto 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:

bash
npx -y add-mcp https://mcp.vercel.com -g

Este 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 -y para 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.com puede 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.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.