VS Code

VS Code supports MCP servers through a .vscode/mcp.json configuration file.

Configuration

Save the following as .vscode/mcp.json in your project root:

{
  "servers": {
    "maestrohub": {
      "type": "http",
      "url": "https://<your-instance>/api/v1/mcp",
      "headers": {
        "Authorization": "ApiKey <your-token>",
        "X-Organization-ID": "<your-org-id>"
      }
    }
  }
}

Replace the placeholders:

• <your-instance> — your MaestroHub domain (e.g., maestro.example.com)
• <your-token> — the Personal Access Token you created
• <your-org-id> — your organization ID (found in the URL or organization settings)

note

For local deployments without TLS, change https:// to http:// in the URL (e.g., http://localhost:8080/api/v1/mcp).

Tips

• VS Code uses a servers top-level key (not mcpServers).
• MCP support in VS Code requires the GitHub Copilot extension with agent mode enabled.
• Add .vscode/mcp.json to your .gitignore to avoid committing tokens.