Docs Connect

Connect VS Code

Add Soontra to VS Code’s agent mode with an API key it asks for once.

This tool sends an API key with each request. Create one in Soontra under Settings, API & MCP (owners and admins only), with the scopes you want it to have. See Authentication.

VS Code uses MCP servers in GitHub Copilot’s agent mode.

Steps

  1. Create the file in your workspace.

    .vscode/mcp.json
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "soontra-api-key",
          "description": "Soontra API key",
          "password": true
        }
      ],
      "servers": {
        "soontra": {
          "type": "http",
          "url": "https://app.soontra.com/api/mcp",
          "headers": {
            "Authorization": "Bearer ${input:soontra-api-key}"
          }
        }
      }
    }
  2. Start the server from the file. VS Code asks for the key and stores it.

  3. Open Copilot Chat in agent mode and check that Soontra’s tools are listed.

Try it

Test prompt
List my projects in Soontra.

If the app answers with your projects, it is connected. If it says a tool is not available, the connection’s scopes do not include it.