Exposer Vercel à ton agent via MCP

Le serveur MCP officiel de Vercel tourne à https://mcp.vercel.com. En le branchant à Claude Code, tu peux interroger tes déploiements, lire tes logs et inspecter tes projets directement depuis le terminal, sans quitter ton éditeur ni ouvrir le dashboard.

C'est le troisième endpoint du pont MCP que le cours Blokby traverse : après avoir vu comment Claude Code consomme des serveurs MCP et comment Supabase en expose un, tu connectes ici le dernier maillon, côté Vercel.

Ce que le serveur expose

Vercel MCP regroupe ses outils en deux catégories.

Outils publics (sans authentification) :

• search_documentation - cherche dans la doc Vercel officielle

Outils authentifiés (nécessitent ton compte Vercel) :

• list_teams, list_projects, get_project - exploration de ta structure de projets
• list_deployments, get_deployment - état et métadonnées de tes déploiements
• get_deployment_build_logs - logs de build pour diagnostiquer un échec
• get_runtime_logs - logs d'exécution filtrables par niveau (error, warning, info), environnement (production, preview), code HTTP, et plage de temps
• check_domain_availability_and_price, buy_domain - gestion des domaines
• deploy_to_vercel - déclencher un déploiement depuis l'agent

Ajouter le serveur MCP

La commande suivante enregistre le serveur Vercel dans Claude Code pour le projet courant.

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

Par défaut, le scope est local (projet courant uniquement). Si tu veux que ce serveur soit disponible dans tous tes projets, ajoute --scope user à la commande ci-dessus.

Tu peux vérifier que le serveur figure bien dans ta liste :

$claude mcp list

Authentifier le serveur

Le serveur MCP Vercel utilise OAuth. La première connexion ouvre un flux d'autorisation dans ton navigateur.

Lance Claude Code dans ton projet :

$claude

Puis, une fois dans l'interface chat, affiche le statut des serveurs MCP :

$/mcp

Claude Code ouvre ton navigateur pour que tu autorises l'accès à ton compte Vercel. Une fois validé, le serveur passe à l'état "connected" et ses outils apparaissent dans la liste.

Premier test : lister tes déploiements

Une fois connecté, tu peux demander à Claude Code d'interagir avec Vercel en langage naturel. Essaie ce prompt dans Claude Code :

Liste mes 5 derniers déploiements Vercel et dis-moi lesquels sont en production.

Claude appelle list_teams puis list_projects pour identifier ton projet, ensuite list_deployments pour récupérer l'historique. Tu peux aussi interroger les logs directement :

Montre-moi les logs d'erreur runtime du projet blokby-website depuis la dernière heure.

Diagnostiquer un déploiement raté

Le cas d'usage le plus courant une fois le MCP branché : comprendre pourquoi un build a échoué sans ouvrir le dashboard.

Mon dernier déploiement a échoué. Récupère les logs de build et explique-moi ce qui s'est passé.

Claude appelle list_deployments pour identifier le déploiement raté, puis get_deployment_build_logs pour en lire les logs. Il t'explique ensuite l'erreur et peut suggérer un correctif dans le même fil de conversation.