Skip to main content
Connect your Vercel account to enable CloudThinker agents to inventory projects, inspect deployments and build events, fetch runtime logs, audit domains and aliases, and run approval-gated controls like canceling stuck deployments or pausing projects. Vercel authenticates with an access token that CloudThinker passes to the official Vercel MCP server (@vercel/sdk). The token’s scope — personal account or a specific team — determines what the agent can reach. No OAuth flow is required.

​
Prerequisites

  • A Vercel account with access to the teams and projects you want to investigate.
  • An access token scoped to the right team.
  • Permission to create tokens for that scope.
Scope the token to only the team CloudThinker needs. The connection’s read operations never mutate Vercel resources — only the three approval-gated controls do.

​
Setup

1

Create an Access Token

In Vercel, go to Settings → Tokens → Create Token:
  • Name: cloudthinker
  • Scope: pick the team (or personal account) CloudThinker should access
  • Expiration: choose a lifetime and plan to rotate
Copy the token immediately — Vercel shows it only once.
2

Add Connection in CloudThinker

Navigate to Connections → Vercel and enter:
  • Token: the access token you just created
Click Connect. CloudThinker starts the Vercel MCP server and shows a Connected status.
Copy the access token immediately after creation. You’ll need to create a new token if it’s lost.

​
Connection Details

FieldDescriptionExample
VERCEL_TOKENVercel access token used as the MCP bearer token—
CloudThinker resolves the team and projects from the token’s scope, so no manual team ID or URL configuration is required.

​
Required Permissions

Scope the token to the team whose projects, deployments, domains, and logs CloudThinker should reach. Read operations work with any token that can see those resources; the three control operations additionally require the token’s scope to allow them and explicit approval in CloudThinker.
Follow least privilege: scope the token to a single team and set an expiration. Keep control operations approval-gated rather than removing the guardrail.

​
Agent Capabilities

Once connected, agents have read access to your Vercel projects and deployments.
CapabilityDescription
Teams & ProjectsList teams and projects, and inspect project domains
DeploymentsList and inspect deployments, deployment events, and build output
Runtime LogsFetch runtime logs for error triage
Domains & AliasesAudit domains, domain configuration, and aliases
AccountRead the authenticated Vercel user
Deployment ControlCancel deployments, pause and unpause projects — requires approval
Cancel deployment, Pause project, and Unpause project are approval-gated. CloudThinker requests confirmation before running them; read-only operations run without approval.

​
Example Prompts

@tony list all projects across my Vercel teams with framework and latest deployment status #visualize as a table
@tony the latest production deployment failed — pull the build events, find the error, and #recommend a fix
@tony show runtime error logs for my Vercel project over the last 6 hours and #alert on 5xx spikes
@tony check the domain configuration for my production domains and flag any unverified ones
For accounts with many projects, scope requests to a single team or project so the agent returns focused results.

​
Troubleshooting

The token is missing, expired, or revoked. Create a fresh Vercel token and reconnect the Vercel connection.
The token’s scope does not include those teams. Create a new token scoped to the correct team and reconnect.
Only one Vercel connection is allowed per workspace. Use the existing connection or remove it before reconnecting.
Cancel, pause, and unpause require both a token scope that permits the action and explicit approval in CloudThinker. Approve the action when prompted, and confirm the token’s scope allows it.

​
Security Best Practices

  • Least-privilege scope - Scope the token to only the team CloudThinker needs
  • Set an expiration - Prefer short-lived tokens and rotate them regularly
  • Approval for controls - Keep cancel, pause, and unpause approval-gated
  • Reconnect carefully - Remove the existing connection before switching tokens
  • Revoke when unused - Delete the token in Vercel if you stop using the connection
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/mcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c89b6087a9d233901dea5e354452eff6

MCP Connection

Connect custom tools and services with MCP

Approval

How approval-gated actions work