Connect AI agents to the Context7 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 Context7 MCP connection

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

   Console steps with screenshots

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

   1. Get a Context7 API key

      • Go to context7.com and sign in to your account.
      • Navigate to the API Keys section in the dashboard.
      • Click Create API Key… and give it a name (e.g. Agent Auth).
      • Copy the generated key — it starts with ctx7sk-.

      

   2. Create a connection in Scalekit

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

   3. Add a connected account

      Connected accounts link a specific user identifier in your system to a Context7 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: { api_key: 'ctx7sk-...' } },
      7
        },
      8
      }
      9
      
      10
      let { connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      11
        connectionName: 'context7mcp',
      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: 'context7mcp',
      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 = 'context7mcp'
   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 Context7 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: 'context7mcp_query_docs',
   27
     toolInput: { libraryId: '/mongodb/docs', query: 'YOUR_QUERY' },
   28
   })
   29
   console.log(result)

   npx tsx quickstart.mts

   Each user opens the link once and enters their Context7 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.