Before you start
- Plans: you need GitHub Copilot. Copilot Free, Pro, Pro+ and Max are not restricted. On Copilot Business and Enterprise, your organization’s MCP servers in Copilot policy must allow it.
- Platforms: VS Code 1.140 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 key. 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) and paste your key address:Enter
postqueen as the server ID, then choose Global, then Copilot Global. VS Code writes the server to ~/.copilot/mcp-config.json.2
Start it
VS Code might ask you to confirm that you trust the server. If it does, confirm, then open the Copilot chat.
Prefer to edit the file yourself?
Prefer to edit the file yourself?
Copilot Global is A project’s
~/.copilot/mcp-config.json, which uses mcpServers:~/.copilot/mcp-config.json
.vscode/mcp.json still works too, for compatibility. It uses servers:.vscode/mcp.json
Check that it works
In the Copilot chat, ask: “List my PostQueen channels.” Copilot calls PostQueen and answers with the channels you connected.Good to know
- Two file shapes.
~/.copilot/mcp-config.jsonuses"mcpServers", and a project’s.vscode/mcp.jsonuses"servers". Both need"type": "http". - The file holds your key when you use the key address. Keep a project’s
.vscode/mcp.jsonout of version control, or, in a Local session, use an input variable below. - Copilot can add the entry for you in the Copilot chat, if you allow it to edit the file.
- 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: 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 (Local sessions)
- Sign in
An input variable makes VS Code prompt you for the key instead of reading it from the file, so the file holds no secret. Input variables work only in Local harness sessions:
.vscode/mcp.json
Try this first
Troubleshooting
More fixes are on Troubleshooting agents.
Next steps
Every agent
Which agents can post to PostQueen, and how each one connects.
The MCP tools
What each of the 25 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.