Vercel hosts frontends, edge functions, and serverless backends for many web applications. Connecting Vercel to clariBI brings deployment and project metadata into your AI analyses for release-correlated reporting.
Why connect Vercel
Release-vs-metric questions ("did the deploy slow things down?") usually require correlating Vercel timelines with metrics tools.
With Vercel connected, you can ask "When did we last deploy production?", "Find failed deployments this week", or "Read the build logs for the latest preview" without leaving clariBI.
How the connection works
clariBI talks to Vercel through its hosted MCP server at https://mcp.vercel.com/. Authentication uses an OAuth flow that clariBI registers itself for (no developer console setup on your side). Tokens stay encrypted server-side and never leave clariBI in clear form.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as Vercel
U->>C: Click Authorize with Vercel
C->>V: Open OAuth authorization
V-->>U: Grant read access?
U->>V: Approve
V-->>C: Authorization code
C->>V: Exchange code for tokens
V-->>C: Access + refresh tokens
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
The AI engine selects from these read-only Vercel tools during analyses. None of them modify data in Vercel.
| Tool | Returns | Example question |
|---|---|---|
search_documentation | Search Vercel documentation by topic. | How do I configure custom domains in Vercel? |
list_teams | Teams the user belongs to. | Which Vercel teams am I in? |
list_projects | Vercel projects for a team. | List projects in my main team. |
get_project | Project details: framework, domains, latest deployment. | Show me project marketing-site. |
list_deployments | Recent deployments with state and target. | Latest deployments to production? |
get_deployment | Deployment details: build status, regions, metadata. | Show me deployment dpl_001. |
get_deployment_build_logs | Build logs for a deployment. | Why did the last deploy fail? |
get_runtime_logs | Runtime logs filterable by environment, level, status, time range. | Show me runtime errors from the last hour. |
check_domain_availability_and_price | Domain availability + pricing lookup. | Is mydomain.com available? |
list_toolbar_threads | Vercel Toolbar comment threads on a team. | Show me unresolved toolbar comments. |
get_toolbar_thread | A toolbar thread with messages and context. | Show me thread tbt_123. |
Data flow during analysis
When you ask a question that maps to Vercel, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as Vercel
U->>C: Ask a question about deployment and project data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the Vercel card.
- Click Authorize with Vercel.
- Sign in to Vercel in the popup window and grant the requested read scopes.
- Back in clariBI, give your data source a name.
- Click Finish.
Permissions and data access
clariBI requests read access to deployments, projects, teams, and logs. No deployments can be triggered or rolled back through this integration. Disconnect from Vercel account settings or from clariBI Settings.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "Team scope missing" | You authorized as a personal account; team data is not visible. | Reconnect from your team's context to include team projects. |