Integrations · VS Code
Give GitHub Copilot in VS Code its own inbox
Add Pidgeon to VS Code’s MCP config and sign in, and Copilot’s agent mode gets an address of its own.
01 · Set it up
3 steps, about two minutes.
01 · Add the server
In your workspace’s .vscode/mcp.json. The URL is all it needs.
{ "servers": { "pidgeon": { "type": "http", "url": "https://pidgeon.ai/api/mcp" } } }02 · Sign in
When the server first starts, VS Code sends you to Pidgeon to sign in. You choose what it can do — read, read and send, or full access — and which address it reaches, or every address if you own the account. That becomes an API key under Developers → API keys → Connected apps, and Disconnect there ends it.
https://pidgeon.ai/api/mcp03 · Or connect with a key
For an agent with nobody there to sign in. VS Code prompts for the key the first time and keeps it in its secret storage, so nothing is written to the file.
{ "inputs": [ { "type": "promptString", "id": "pidgeon-key", "description": "Pidgeon API key", "password": true } ], "servers": { "pidgeon": { "type": "http", "url": "https://pidgeon.ai/api/mcp", "headers": { "Authorization": "Bearer ${input:pidgeon-key}" } } } }
02 · Questions
Pidgeon in VS Code
- Do I need an API key?
- Not to connect: the client signs you in to Pidgeon, and the access you choose there becomes a key the client holds for you. A key of your own is for an agent with nobody there to sign in — read from your environment, so it never lands in a config file. Either can be scoped to one address and one level of access.
- How do I disconnect a client?
- Under Developers → API keys → Connected apps. Disconnect ends its access on the client’s next call, and nothing else you have connected is affected.
- Can my agent sign itself up?
- Yes. Paste “Read pidgeon.ai/skill.md and get yourself an email address.” into the agent. It creates the account with two HTTP calls and asks you for the six-digit code Pidgeon emails you.
- What can the agent do once it is connected?
- Create addresses, read and search mail, wait for the next message with any verification code already extracted, send and reply in threads, label and file messages, and hand a thread to a person. Every inbound message carries a Pidgeon Firewall verdict.
03 · Elsewhere