
Before you start
- Plans: Pro, Max, Team, Enterprise or a Console (API) account. The free Claude plan does not include Claude Code.
- Platforms: the terminal on macOS, Linux and Windows, plus IDE integrations.
- 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 Claude Code
1
Add PostQueen
Run this in your terminal, with your key in place of Add
YOUR_API_KEY:--scope user to use PostQueen in every project. Without it, the server is saved for the current project only.2
Check the server
Run
claude mcp list. PostQueen is listed with its address.3
Start a new session
Start a new Claude Code session so the PostQueen tools load.
Check that it works
In the new session, ask: “List my PostQueen channels.” Claude Code calls PostQueen and answers with the channels you connected. Type/mcp to see the server and its tools.
Good to know
- Scopes: the default is local, this project only, stored in
~/.claude.json.--scope usercovers every project, and--scope projectwrites a shared.mcp.jsoninto the project. - Keep the key out of a shared file.
.mcp.jsonexpands${VAR}in the address and headers, so a committed file can read the key from your environment. Or use the header form below. - Claude Code can run the command for you if you allow it, since it runs shell commands. The tools still load only in a new session.
- A connector you added in Claude on claude.ai also shows up in Claude Code when you log in with a claude.ai subscription.
- 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
- Bearer header
- Sign in
Try this first
Run it on a schedule
Claude Code runs without a chat with-p, from cron or a CI job, and a -p run connects the same MCP servers as a normal session. It cannot stop to ask you for approval, so allow the PostQueen tools up front with --allowedTools:
mcp__postqueen allows every tool of the postqueen server and nothing else. Source: Anthropic, run Claude Code programmatically.
Troubleshooting
More fixes are on Troubleshooting agents.
Is it the same as Claude?
No. Claude Code is Anthropic’s coding agent, with its own command. Claude and Claude Cowork share a connector instead:Next steps
Every agent
Which agents can post to PostQueen, and how each one connects.
The MCP tools
What each of the 22 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.