# 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](https://soontra.com/docs/authentication).

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

## Steps

1. **Create the file in your workspace.**

```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.**

> **Warning:** The file above holds no key, so it is safe to commit. Do not paste a real key into a config file that is shared or committed.

## 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](https://soontra.com/docs/scopes) do not include it.