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
- Open the gear (⚙), click See all settings →, then click Integrations.
- Find the Vercel card and click Open Vercel tokens page. Your browser opens vercel.com/account/tokens.
- On that page, click Create Token near the top right. Sign in to Vercel first if it asks.
- For the token name, type codus so you remember what it is for.
- Under Scope, select the team or account needed for the intended projects. Full-account access is broader; use it only if that is the access you intend to grant.
- Under Expiration, choose a lifetime appropriate to the work. Shorter-lived credentials need renewing sooner but reduce exposure if lost.
- Click Create Token, then click the copy button next to the token. Copy it now, because Vercel only shows it once.
- 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 Connected as yourname with the Vercel username returned by its check. Credentials are stored locally for authorised integration use, not for pasting into chat or source files. A successful connection is not proof that every project or deployment permission is available. If a token is revoked, reconnect with an appropriately scoped credential when the card or a request reports the failure.
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. Read the connection error, then check the token, expiry and required account/team access. Do not grant full-account access automatically to work around an unexplained error.
- 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.