Exponer Vercel a tu agente con MCP

El servidor MCP oficial de Vercel corre en https://mcp.vercel.com. Al conectarlo a Claude Code, puedes consultar tus despliegues, leer tus logs e inspeccionar tus proyectos directamente desde el terminal, sin salir de tu editor ni abrir el dashboard.

Es el tercer endpoint del puente MCP que el curso Blokby recorre: después de ver cómo Claude Code consume servidores MCP y cómo Supabase expone uno, aquí conectas el último eslabón, del lado de Vercel.

Lo que expone el servidor

Vercel MCP agrupa sus herramientas en dos categorías.

Herramientas públicas (sin autenticación):

• search_documentation - busca en la documentación oficial de Vercel

Herramientas autenticadas (requieren tu cuenta Vercel):

• list_teams, list_projects, get_project - exploración de tu estructura de proyectos
• list_deployments, get_deployment - estado y metadatos de tus despliegues
• get_deployment_build_logs - logs de build para diagnosticar un fallo
• get_runtime_logs - logs de ejecución filtrables por nivel (error, warning, info), entorno (production, preview), código HTTP y rango de tiempo
• check_domain_availability_and_price, buy_domain - gestión de dominios
• deploy_to_vercel - lanzar un despliegue desde el agente

Añadir el servidor MCP

El siguiente comando registra el servidor de Vercel en Claude Code para el proyecto actual.

$claude mcp add --transport http vercel https://mcp.vercel.com

Por defecto, el scope es local (solo el proyecto actual). Si quieres que este servidor esté disponible en todos tus proyectos, añade --scope user al comando de arriba.

Puedes verificar que el servidor aparece correctamente en tu lista:

$claude mcp list

Autenticar el servidor

El servidor MCP de Vercel usa OAuth. La primera conexión abre un flujo de autorización en tu navegador.

Lanza Claude Code en tu proyecto:

$claude

Luego, una vez en la interfaz de chat, muestra el estado de los servidores MCP:

$/mcp

Claude Code abre tu navegador para que autorices el acceso a tu cuenta de Vercel. Una vez validado, el servidor pasa al estado "connected" y sus herramientas aparecen en la lista.

Primera prueba: listar tus despliegues

Una vez conectado, puedes pedirle a Claude Code que interactúe con Vercel en lenguaje natural. Prueba este prompt en Claude Code:

Lista mis 5 últimos despliegues de Vercel y dime cuáles están en producción.

Claude llama a list_teams y luego a list_projects para identificar tu proyecto, y después a list_deployments para recuperar el historial. También puedes consultar los logs directamente:

Muéstrame los logs de error en runtime del proyecto blokby-website de la última hora.

Diagnosticar un despliegue fallido

El caso de uso más habitual una vez conectado el MCP: entender por qué ha fallado un build sin abrir el dashboard.

Mi último despliegue ha fallado. Recupera los logs de build y explícame qué ha pasado.

Claude llama a list_deployments para identificar el despliegue fallido y luego a get_deployment_build_logs para leer sus logs. Después te explica el error y puede sugerir una corrección en el mismo hilo de conversación.