Connect AI agents to the v0 MCP server

Setup

1. Install the SDK

   • Node.js
   • Python

   npm install @scalekit-sdk/node dotenv

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Create the v0 MCP connection

   In AgentKit > Connections, create a v0 MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

   Console steps with screenshots

   Register your v0 API key with Scalekit so it can authenticate and proxy requests on behalf of your users. v0 MCP uses Bearer Token authentication.

   1. Get a v0 API key

      • Go to v0.dev and sign in to your account.
      • Click your workspace name in the top-left corner and select Settings.
      • In the left sidebar, click API Keys.
      • Click New Key, give it a name (e.g. Agent Auth), and copy the generated key.

      

   2. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for v0 MCP and click Create.
      • Note the Connection name — use this as connection_name in your code (e.g., v0mcp).

   3. Add a connected account

      Connected accounts link a specific user identifier in your system to a v0 API key. Add one in the dashboard to test. In production, each user adds their own through the authorization link: they enter their credentials on the page it opens.

      In the dashboard, to test

      • Open the connection and click the Connected Accounts tab → Add account.
      • Fill in Your User’s ID and API Key, then click Save.

      From your backend, if your app already has the credentials

      For example, when users enter them on a settings page in your app:

      • Node.js
      • Python

      1
      import { ConnectorStatus } from '@scalekit-sdk/node'
      2
      
      3
      const authorizationDetails = {
      4
        details: {
      5
          case: 'staticAuth',
      6
          value: { details: { token: 'your-v0-api-key' } },
      7
        },
      8
      }
      9
      
      10
      let { connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      11
        connectionName: 'v0mcp',
      12
        identifier: 'user_123',
      13
        authorizationDetails,
      14
      })
      15
      
      16
      // Make sure the account is ACTIVE before the first tool call.
      17
      if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {
      18
        ;({ connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      19
          connectionName: 'v0mcp',
      20
          identifier: 'user_123',
      21
          authorizationDetails,
      22
        }))
      23
      }

4. Authorize a user and make your first call

   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   import { createInterface } from 'node:readline/promises'
   4
   
   5
   const scalekit = new ScalekitClient(
   6
     process.env.SCALEKIT_ENVIRONMENT_URL,
   7
     process.env.SCALEKIT_CLIENT_ID,
   8
     process.env.SCALEKIT_CLIENT_SECRET,
   9
   )
   10
   const actions = scalekit.actions
   11
   
   12
   const connector = 'v0mcp'
   13
   const identifier = 'user_123'
   14
   
   15
   // Generate an authorization link for the user
   16
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   17
   console.log('Authorize v0 MCP:', link)
   18
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   19
   await rl.question('Press Enter after authorizing...')
   20
   rl.close()
   21
   
   22
   // Make your first call
   23
   const result = await actions.executeTool({
   24
     connector,
   25
     identifier,
   26
     toolName: 'v0mcp_findchats',
   27
     toolInput: {},
   28
   })
   29
   console.log(result)

   npx tsx quickstart.mts

   Each user opens the link once and enters their v0 MCP server credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See Authorize a user for the full flow and statuses.