drafty
Vercel logo

Build a Vercel deployments dashboard with Claude

Connect the Vercel MCP server to Claude, ask for a deploys, traffic, and performance dashboard from your live projects, and publish it to a link your team comments on directly — no spreadsheet, no screenshots pasted into Slack.

What you'll build
A self-contained deployments dashboard — deploy frequency and build health, traffic and error rate from runtime logs, the slowest functions, and a recent-deploys table — generated by Claude from your real Vercel data, then published to a drafty.im/canvas/… link. Your team clicks the exact tile or number they want changed and leaves a note. Claude reads the comments and ships a revised version to the same URL.

This is an end-to-end example: connect a data source over MCP, generate a dashboard from live numbers, and close the review loop on one link. Total time, start to shared link, is under fifteen minutes. The same shape works for any of the other examples — only the connection step changes.

Here's the finished dashboard, published to a canvas — click any tile or number to leave a comment, exactly as your team would:

Live canvas — comment on any elementOpen ↗

The three moving parts

  1. The Vercel MCP server gives Claude read access to your Vercel account — teams, projects, deployments, build logs, and runtime logs — through a controlled set of tools. It's read-only, so it can't change or ship anything.
  2. Claude pulls the numbers and writes a single self-contained HTML dashboard. You iterate on it in the artifact panel until it's right.
  3. Drafty turns that HTML into a stable link your team reviews. Comments pin to the exact element; Claude ships the fix to the same URL.

The generation step is fast now. The part this example is really about is the third one — getting the dashboard in front of people without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the Vercel MCP server

Vercel runs an official remote MCP server at https://mcp.vercel.com. You connect once; it authenticates over OAuth, so no token is pasted into a config file.

In Claude Code:

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

Then run /mcp inside Claude Code and follow the OAuth prompt to authorize your Vercel account in the browser.

In Claude Desktop: open Settings → Connectors → Add custom connector, name it Vercel, paste https://mcp.vercel.com, and authorize with OAuth the same way.

Safety first
The Vercel MCP server is read-only at launch — it can list projects, read deployments, and pull build and runtime logs, but it can't deploy, change env vars, or buy domains without your explicit confirmation. Connecting grants the agent the same access as your Vercel user, so enable human confirmation for tool calls and never connect it alongside an untrusted server. A reporting dashboard only reads; it never needs more.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the MCP server's read tools (list_projects, list_deployments, get_deployment, get_runtime_logs) to fetch real data:

claude
Using the Vercel MCP server, pull everything we need for a deployments dashboard for my production project: number of deployments in the last 7 days and how many succeeded vs. failed, the average build duration, and the time of the latest production deploy. Then from runtime logs over the last 24 hours, give me total requests, the error rate (4xx and 5xx), and a breakdown of status codes. List the 10 most recent deployments with their state, target, and duration. Summarize the figures before you build anything.

Claude calls Vercel, returns the figures, and you sanity-check them against the Vercel dashboard before going further. This is the moment to catch a wrong assumption — the wrong team, a preview deploy counted as production, a log window that's shorter than you thought — while it's cheap.

One honest gap
The Vercel MCP server doesn't expose Speed Insights / Web Vitals (LCP, CLS, INP) or Web Analytics as read tools today — those live only in the Vercel dashboard. For a performance view, lean on what the runtime logs do give you: request volume, error rate, status-code mix, and function execution. If you want true Core Web Vitals on the canvas, paste the numbers from the Vercel Speed Insights tab and tell Claude to render them as a tile — don't let it invent them.

Step 3 — Build the dashboard

Once the numbers look right, ask for the artifact:

claude
Build a single self-contained HTML dashboard from those figures. Deploys this week as the hero number with the success/failure split, then tiles for average build time, latest production deploy, total requests (24h), and error rate. Add a small bar chart of deploys per day and a status-code breakdown. A recent-deployments table at the bottom with state, target, and build duration. Clean, no external dependencies — inline the CSS and any chart code.

Claude renders it live in the artifact panel. Iterate in place — you're not regenerating from scratch:

Step 4 — Publish to Drafty for review

A Claude artifact link is a preview, not a stable URL — iterate the artifact and the link you already sent now shows the old version. Ask Claude to publish it to a Drafty canvas instead, so the link you share always stays current:

claude
Publish this dashboard to Drafty as a canvas and give me the shareable link.

Claude pushes the dashboard and hands back a drafty.im/canvas/… link that renders on any device. Send it — your team opens it in a browser, no login and no Claude account needed.

Step 5 — The review loop

This is the part that's not obvious until you've done it once.

A reviewer clicks the specific tile, chart, or number they want changed and leaves a pinned comment — "this error rate looks low, are we counting preview traffic too?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant Vercel query if needed, and pushes a revised dashboard to the same URL. The reviewer refreshes and sees the change; the thread stays attached to the element.

The mechanic matters because of what it removes. A Slack message about a chart produces "the number on the left looks wrong." A pinned comment on the actual tile produces "this — exclude preview deploys from the build-time average." One of those produces a correct revision; the other produces a guess.

Keeping it fresh

An MCP-generated dashboard is a snapshot — it holds the numbers Claude pulled when it built it; it doesn't re-query Vercel when someone opens the link. For a weekly deploy review or a status update, that's fine.

To make it a live canvas that always shows the latest deploys and traffic, copy this prompt — Claude sets up the refresh for you and schedules it to run on its own:

claude
Turn this Vercel dashboard into a live canvas: every morning, re-pull the latest deployments and runtime-log figures from Vercel via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows current numbers. Schedule it to run daily on its own.

The link stays stable while the content updates underneath it — see keeping a canvas updated automatically.

What to watch for

Vercel dashboard with Claude — FAQ

Do I need to paste my Vercel token anywhere?
No. The remote Vercel MCP server at mcp.vercel.com authenticates over OAuth, so you authorize the account through a consent screen instead of pasting a token. The server is read-only at launch, and connecting grants the agent the same access as your Vercel user — keep human confirmation on for tool calls.
Is the dashboard live or a snapshot?
A snapshot. It contains the numbers Claude pulled when it built the file; it does not re-query Vercel when someone opens the link. To refresh it, ask Claude to repull and re-push to the same URL — or put that on a daily schedule so the stable link always shows current deploys and traffic.
Can my team comment without a Vercel or Claude account?
Yes. The dashboard is published to a Drafty canvas link that renders in any browser. Reviewers click the exact element they want changed and leave a pinned comment with no login required. Only the person connecting Vercel needs access to the account.
Can Claude pull Web Vitals or analytics through the MCP?
Not today. The Vercel MCP server's read tools cover projects, deployments, build logs, and runtime logs — not Speed Insights (Web Vitals) or Web Analytics. You can derive traffic, error rate, and status-code mix from runtime logs; for Core Web Vitals, paste the numbers from Vercel's Speed Insights tab and have Claude render them rather than letting it guess.
How is this different from the Vercel dashboard or Observability tab?
Vercel's dashboard and Observability are the live source of truth — the right place for real-time monitoring and alerting. This approach is for a fast, shareable snapshot you can spin up in minutes, shape by talking to Claude, and collect feedback on inline. Different jobs: one is a standing system, the other is a quick reviewable deliverable your team can annotate.