Home

Guide

Vercel MCP, Next.js MCP and the errors your users see

Vercel MCP reads function and daemon logs. The Next.js dev MCP reads your local overlay. Add BugTape so your agent can see real users' browser errors.

You've connected Vercel MCP to your agent, a user says checkout is broken, and the agent finds nothing. That's usually because the error happened in the user's browser, and as Vercel documents it, the observability tools on Vercel MCP read Functions and daemon logs, not that browser session.

This guide is for Next.js teams on Vercel who already use an MCP-connected agent (Cursor, Claude Code or Codex). It shows what each MCP server reads, and one setup that adds real users' browser errors alongside them.

No account: npx -y bugtape --help prints the commands and does not sign you in. The demo MCP at https://app.bugtape.ai/demo/mcp needs no sign-in. Your own workspace needs one.

Page owner: Jaco Veldsman, hi@bugtape.ai. Last checked 2026-11-13. I build BugTape. Vercel and Next.js facts come from their public docs, linked below, re-checked on 13 November 2026.

What each MCP server reads

Next.js MCP (next-devtools-mcp)Vercel MCPBugTape MCP
Where it runsYour local next dev server (Next.js 16+, at /_next/mcp)Your Vercel projectsYour BugTape project
Errors it returnsget_errors: config, build and browser runtime errors from browser sessions open on your dev serverget_runtime_errors: grouped runtime error clusters. get_runtime_logs: logs from Vercel Functions during requests (source: function or daemon), with a maximum lookback of 7 dayslist_recommended_critical, get_repro_context: errors and bug reports captured in real users' browsers (and servers, if you add the Node SDK)
Production users' browsersNo, it reads your local dev sessionNot as Vercel documents it: the logs come from Functions and daemonYes, once the browser SDK is installed

Sources: Next.js MCP guide, Vercel MCP observability tools, BugTape MCP tools.

They don't overlap much. Keep all three connected: the Next.js MCP while you build, Vercel MCP for function failures and logs, and BugTape for what broke in a real user's tab.

If you already run Grafana Faro, Grafana Cloud MCP does expose real-user browser errors when Faro is installed (frontend_observability_handler). BugTape adds the repro context for one user's steps. See BugTape and Grafana Faro.

Add browser capture to your Next.js app

Create app/bugtape-provider.tsx and render <BugTapeProvider /> once from app/layout.tsx, after your consent check. Use the project capture key from BugTape Setup.

import Script from 'next/script';

export function BugTapeProvider() {
  return (
    <Script id="bugtape" type="module" strategy="afterInteractive">
      {`
        import { init } from 'https://app.bugtape.ai/bugtape.mjs';
        init({
          apiKey: 'YOUR_PROJECT_KEY',
          onSuccess(response) {
            console.info('BugTape capture accepted', response.id, response.captureId);
          },
          onError(error) {
            console.warn('BugTape capture failed', error.message);
          }
        });
      `}
    </Script>
  );
}

This is the supported recipe from BugTape's Next.js example. Prefer a bundled SDK? npm install @bugtape/sdk and call BugTape.init({ apiKey }) once in a client component.

Two rules from that recipe and the quickstart: render one provider only, and don't run it next to a second global error reporter. A capture key can only send events. Never put agent tokens or AI provider keys in the script.

In the browser, BugTape records uncaught errors, unhandled rejections, console breadcrumbs, the fetch and XHR waterfall, and a DOM replay (what each platform captures).

Server errors too? Add @bugtape/node and the Next.js onRequestError hook (cookbook). Then a function failure Vercel MCP shows you and the browser error that came with it end up in the same BugTape project.

Check it

In a local or staging page, add a button that throws an error with a unique name. Click it, then open Issues in the BugTape console and find it. BugTape's own docs say this Next.js recipe has been checked for syntax and against the framework docs, and that a full Next.js runtime trial is still a separate check, so run this step yourself before you rely on it.

Connect it to your agent

Do this after the capture key is in the app and a test error has landed.

npx -y bugtape connect cursor

Use claude or codex instead of cursor for the other clients (install guide).

Then, when a user reports a bug, ask your agent something like: "Check Vercel runtime errors for /api/checkout in the last 24h, then pull the BugTape repro context for the checkout bug." The agent calls Vercel's get_runtime_errors for the function side and BugTape's get_repro_context for the browser side: the error, the console and network timeline, and the steps before it. It can then open a pull request for you to review. BugTape doesn't change your code, merge or deploy.

Why it pays off

The bugs users report are often front-end bugs: a failed fetch, a render that throws, a button that does nothing. When your agent can read the user's browser session next to the function logs, it can start on a fix without you first reproducing the bug by hand.

FAQ

Does BugTape replace Vercel MCP?

No. Vercel MCP covers your deployments, function logs and traces. BugTape adds browser-side capture and bug reports. Use both.

Isn't the Next.js MCP enough?

It's very good while you develop, but it reads the browser sessions open on your own dev server, not your production users.

Can Vercel MCP see production browser errors?

Not as Vercel documents it. get_runtime_logs reads output from Vercel Functions during requests (source: function or daemon). get_runtime_errors groups those runtime error clusters. This page does not claim those tools can never see a browser error; it follows the current docs.

Is this a Vercel integration?

No. BugTape is a separate service you add to your app. It works the same whether or not you host on Vercel.

Does this swap in for a Sentry DSN?

No. BugTape has its own SDK and init. To compare them, see BugTape vs Sentry.

Sources

Re-checked 13 November 2026:

See also

Vercel FUNCTION_INVOCATION_FAILED · Node.js, Express and Next.js cookbook · BugTape and Grafana Faro · Connect Cursor · Install BugTape MCP · MCP tools · BugTape vs Sentry

Start free. No card.

Your team reviews the PR. Agents do not silent-ship.