Before you start
- Plans: Paperclip is free and open source (MIT). You host it yourself, and no Paperclip account is needed.
- Platforms: your own macOS, Linux or WSL2 machine with Node 24.11 or later, or Docker. PostQueen’s tools reach Paperclip’s Claude Code and Codex agents, and agents on Paperclip’s ACP engine.
- A PostQueen API key. A workspace admin copies it 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 Paperclip
1
Add your own MCP server
In Paperclip, open Connectors, choose Connect on Connect your own tool, then Connect your own MCP server. Paste this address and choose Continue:
2
Enter the key
Under Advanced authentication, choose Key or token, paste your PostQueen API key into App key on its own, without the word
Bearer, and press Check link. Paperclip saves it as an encrypted secret.3
Review the tools
Paperclip turns on every PostQueen tool as Allowed, including scheduling. To approve each post first, open PostQueen’s Permissions and choose Set all: Ask first on the Write group.
4
Choose the agents
Choose which agents can use PostQueen: Any agent, or Just agents I pick.
Check that it works
Assign a Claude Code or Codex agent a task: “List my PostQueen channels.” The agent answers with the channels you connected in PostQueen.Good to know
- Paperclip hands PostQueen’s tools straight to its Claude Code and Codex agents, and to agents on its ACP engine. For other agent types, the PostQueen CLI is the surer route.
- Every value you enter becomes an encrypted Paperclip secret and is never shown again.
- A Claude Code agent managed by Paperclip ignores servers added on the same machine with
claude mcp add. Give it access in Connectors instead. - There is no
paperclipaicommand for MCP connections yet. Use the Connectors page. - Every tool starts as Allowed, scheduling included. Set the Write group to Ask first in PostQueen’s Permissions to approve each call, or to Off to keep agents to reading.
- 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
- Sign in
- CLI and skill
In Connect your own MCP server, enter
https://api.postqueen.ai/mcp-oauth-dynamic, choose Continue, then press Check link. Paperclip registers itself and starts the browser sign-in; a workspace admin signs in to PostQueen and approves.The sign-in address has 24 tools, all but ask_postqueen. Revoke access in PostQueen under Connections > Approved Apps.Try this first
Assign this to a Claude Code or Codex agent:Run it on a schedule
Add a routine with a cron schedule, such as0 9 * * 1 for Mondays at 9am. Each run opens an issue for the routine’s agent, which picks it up on its next heartbeat.
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.