Before you start
- Plans: you need GitHub Copilot. Copilot Free, Pro, Pro+ and Max are not restricted. On Copilot Business and Enterprise, the MCP servers in Copilot policy must be on, and it is off by default.
- Platforms: VS Code 1.99 or later on macOS, Windows and Linux.
- A PostQueen API key. A workspace admin copies it, or the ready-made address, from Connections.
Where the API key is: in the app, open Connections > API Keys. Only a workspace Admin or Super Admin can reveal or rotate it; other members see it masked. A workspace has one key, and each agent card on Connections shows your MCP address with the key already filled in.
Connect VS Code
1
Add the server
Open the Command Palette and run MCP: Add Server. Choose HTTP (HTTP or Server-Sent Events), enter your key address as the server URL, enter
postqueen as the server ID, and pick Global or Workspace:2
Start it
VS Code asks you to confirm that you trust the server. Confirm, then open Copilot Chat in agent mode.
Prefer to edit mcp.json yourself?
Prefer to edit mcp.json yourself?
Open
.vscode/mcp.json in the project, or run MCP: Open User Configuration for every workspace, and add:.vscode/mcp.json
Check that it works
In Copilot Chat, in agent mode, ask: “List my PostQueen channels.” Copilot calls PostQueen and answers with the channels you connected.Good to know
- VS Code uses
"servers", not"mcpServers", and"type"must be"http". A block copied from Cursor does not work here. - The file holds your key when you use the key address. Keep a workspace
.vscode/mcp.jsonout of version control, or use an input variable below. - Copilot can add the entry for you in agent mode, if you allow it to edit
.vscode/mcp.json. - Ask for drafts when you want to check first. A draft waits on your PostQueen calendar, and nothing publishes until you schedule it.
- What it cannot do over MCP: delete a post, or change a post’s text or time. Do that on the calendar in the app. The MCP tools lists what it can do.
Other ways to connect
- Input variable
- Sign in (not tested yet)
VS Code recommends input variables for secrets. It prompts you for the key instead of reading it from the file, so the file holds no secret:
.vscode/mcp.json
Try this first
Troubleshooting
More fixes are on Troubleshooting agents.
Next steps
Every agent
Which agents can post to PostQueen, how each one connects, and what PostQueen has tested.
The MCP tools
What each of the 21 tools does, and what an agent cannot do.
Prompts and tool calls
The order an agent calls the tools in, with prompts that work.
Troubleshooting agents
What to do when a connection or a command fails.