Connect Claude Code, Cursor, or VS Code with API keys

Create a scoped soontra_sk_ API key in Settings → Connections, then paste one command or config block to give your editor or CLI access to your workspace.

Last updated Jul 23, 2026

Developer tools connect to Soontra with an API key instead of a sign-in. You create the key once, then each client sends it as a Bearer token in an Authorization header alongside your workspace's MCP server URL.

Both the MCP server URL and the API-key section live in Settings → Connections. Only workspace owners and admins can create keys.

Create an API key with scopes

  1. Open Settings → Connections and find the API keys section.
  2. Choose the scopes the key should carry — each scope is a checkbox, so a key gets exactly the access you tick and nothing more.
  3. Optionally set an expiry date.
  4. Create the key and copy it. Keys look like soontra_sk_... and are shown once, so store it somewhere safe.

To understand what each scope permits, see MCP scopes, safety, and rate limits.

Connect Claude Code

  1. Create an API key in Settings → Connections and copy it.
  2. Run the following command with your key, replacing the URL with your workspace's MCP server URL: claude mcp add --transport http soontra <your MCP server URL> --header "Authorization: Bearer <YOUR_KEY>"
  3. Run /mcp in a Claude Code session to confirm the server is connected.

Test it with: Use the soontra MCP server to list my projects.

Connect Cursor

  1. Create an API key in Settings → Connections and copy it.
  2. Open Cursor Settings → Tools & MCP → "New MCP Server" and paste the config below into ~/.cursor/mcp.json, replacing <YOUR_KEY> and the URL: { "mcpServers": { "soontra": { "url": "<your MCP server URL>", "headers": { "Authorization": "Bearer <YOUR_KEY>" } } } }

Test it with: Use the Soontra MCP server to list my projects.

Connect VS Code

VS Code uses a promptString input so the key itself is never written into the config file — VS Code prompts for it and stores it securely.

  1. Create an API key in Settings → Connections and copy it.
  2. Add the config below to your user MCP config or .vscode/mcp.json: { "inputs": [ { "type": "promptString", "id": "soontra-api-key", "description": "Soontra API key", "password": true } ], "servers": { "soontra": { "type": "http", "url": "<your MCP server URL>", "headers": { "Authorization": "Bearer ${input:soontra-api-key}" } } } }
  3. Use Copilot Agent mode and select the Soontra MCP server when you want the tools available.

Test it with: Use the Soontra MCP server to list my projects.

Keep keys safe

An API key acts as you, within the scopes it carries. Treat it like a password: keep it out of shared documents and chat threads, and prefer the VS Code prompt-input pattern over pasting keys into files.

Revoke or expire

You can revoke any key at any time from Settings → Connections, and expired keys stop working automatically. Role changes matter too: if you're demoted from admin, your API keys are revoked immediately.