---
title: How do I connect Vercel to codus?
question: connect vercel
area: integrations
order: 3
surface: desktop
audience: beginner
keywords: [vercel, connect vercel, deployments, build logs, function logs, environment variables, env vars, domains, access token, personal access token, pat, hosting, redeploy, vercel token]
related: [integrations-overview, connect-cloudflare, connect-supabase]
updated: 2026-07-21
---

# How do I connect Vercel to codus?

Open **Integrations** in settings, find the **Vercel** card under **Hosting + deployment**, and click **Connect**. Vercel does not use a browser sign-in here, so the card walks you through making an access token on vercel.com, then you paste it in and click **Connect**. Once connected, codus has full access to your Vercel account: deployments, build and function logs, environment variables, and domains. You can ask an agent things like "show my last Vercel deployment's build log" or "list the env vars on my project".

## Before you start

- You need a Vercel account. If you do not have one, create it during the steps below.
- You will create a token and copy it once. Vercel shows the token a single time, so keep the codus window handy to paste it straight back.

## Steps

1. Open the gear (**⚙**), click **See all settings →**, then click **Integrations**.
2. Find the **Vercel** card and click **Open Vercel tokens page**. Your browser opens vercel.com/account/tokens.
3. On that page, click **Create Token** near the top right. Sign in to Vercel first if it asks.
4. For the token name, type **codus** so you remember what it is for.
5. Under **Scope**, choose **Full Account** so codus can work across all your projects. To limit it to one team, pick that team instead.
6. Under **Expiration**, choose **1 year** so you do not have to reconnect often.
7. Click **Create Token**, then click the copy button next to the token. Copy it now, because Vercel only shows it once.
8. Come back to codus, paste the token into the box on the card, and click **Connect**.

## How do I know it worked?

The card shows a green **Connected as yourname** label with your Vercel username. The card also reminds you: "Your token is stored encrypted on this Mac and is only ever sent to Vercel." If the token is later revoked on vercel.com, the card notices the next time codus comes to the front and returns to the disconnected state.

## Common problems

- **The Connect button did nothing.** The box needs a token first. Paste the token you copied, then click **Connect**. The button stays disabled while the box is empty.
- **My token was rejected.** codus validates the token against Vercel when you connect. Re-create it with **Full Account** scope and paste the fresh token.
- **I missed the token before it disappeared.** Vercel only shows a token once. Go back to the tokens page, create a new one, and paste that.
- **I want to disconnect.** Click **Disconnect** and confirm. codus forgets the token; reconnect any time with a new one.