Connect VS Code and GitHub Copilot
Add Supero to VS Code: put https://mcp.supero.dev/mcp in .vscode/mcp.json, sign in in your browser, and build Supero apps from Copilot agent mode.
- VS Code
- GitHub Copilot
- MCP
- OAuth
- mcp.json
- agent mode
Overview
https://mcp.supero.dev/mcp and signs you in through your browser (OAuth). No API key is needed. After that, Copilot in agent mode can plan, build, preview, and publish Supero apps.Tested
Add the server
.vscode/mcp.json in your workspace (or add the same entry to your user MCP configuration):{
"servers": {
"supero": {
"type": "http",
"url": "https://mcp.supero.dev/mcp"
}
}
}- 1
Start the server
Open
.vscode/mcp.jsonand start thesuperoserver, or run **MCP: List Servers** from the Command Palette and start it there. - 2
Sign in
VS Code opens your browser at Supero. Sign in, or create an account.
- 3
Allow
The approval page says "Supero hasn't verified this app", followed by the local address the tool uses (such as 127.0.0.1 or localhost). That is normal. Supero can't check a program on your computer, so it asks you to confirm you started the sign-in. Pick where it may work (access options). Click Allow.
- 4
Use it
Open Copilot Chat, switch to Agent mode, and check that the Supero tools are enabled in the tools picker.
Check the connection
build_whoami and answers with your workspace and access. Supero lists about 50 tools, with the build tools first.Your first app
Build a booking app for a dog grooming salon: customers pick a groomer and a time slot and pay a deposit; staff see the day's appointments.Use an API key instead (optional)
https://api.supero.dev/mcp/v1/messages with the key in the X-API-Key header; Two addresses, one set of tools explains why there are two addresses, and Use an API key instead covers creating a key in the console (Build via MCP). A project key can read, change and delete records in every tenant of its project. Never commit a key.{
"inputs": [
{ "type": "promptString", "id": "supero-key", "description": "Supero API key", "password": true }
],
"servers": {
"supero": {
"type": "http",
"url": "https://api.supero.dev/mcp/v1/messages",
"headers": { "X-API-Key": "${input:supero-key}" }
}
}
}Troubleshooting
- Use the URL exactly as
https://mcp.supero.dev/mcp, with no trailing slash. Some clients compare it with the server's published resource and stop if they differ. - "Too many registrations" (HTTP 429). Each new sign-in registers the tool with Supero. One IP address may register 10 times an hour (an IPv6 /64 network 20 times), and there is an overall hourly limit. Wait, then try again. A sign-in that already works is not affected.
- Signed in as the wrong account: remove the server, add it again, and use Switch account on the approval page.
- To disconnect, use Disconnect at app.supero.dev/oauth/connections, then remove the server from the tool's config.
- Changing your Supero password or email ends every assistant connection you signed in. Your projects and apps are not affected; sign in again from the tool.
- VS Code allows up to 128 tools per request across all servers. Supero lists about 50 when you sign in and about 70 with an API key. If you hit the limit, turn off tools you don't need in the tools picker.
On this page