> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PostQueen's hosted API is https://api.postqueen.ai. The public API base is https://api.postqueen.ai/public/v1 and takes the raw API key in the Authorization header, with no Bearer prefix.
> The MCP server for posting is https://api.postqueen.ai/mcp/YOUR_API_KEY (or /mcp with Authorization: Bearer YOUR_API_KEY). docs.postqueen.ai/mcp only searches these docs and cannot post.
> The API key is under Connections > API Keys in the app, and only workspace admins can see it.

# Claude

> Add PostQueen to Claude as a custom connector, on the web or in Claude Desktop, and ask Claude to write, schedule and check your posts.

export const AgentStatus = ({status, label, children}) => {
  const look = ({
    tested: {
      color: 'green',
      icon: 'badge-check'
    },
    'partly-tested': {
      color: 'green',
      icon: 'badge-check'
    },
    'vendor-docs': {
      color: 'surface',
      icon: 'book-open'
    },
    'not-possible': {
      color: 'gray',
      icon: 'circle-slash'
    }
  })[status] || ({
    color: 'gray',
    icon: 'circle-question-mark'
  });
  const cut = status === 'partly-tested' ? -1 : (label || '').indexOf(', ');
  const rest = cut > 0 ? label.slice(cut + 2) : '';
  const pill = status === 'partly-tested' ? 'Partly tested' : cut > 0 ? label.slice(0, cut) : label;
  const note = status === 'partly-tested' ? label : cut > 0 ? rest.charAt(0).toUpperCase() + rest.slice(1) + '.' : null;
  return <div className="pq-status not-prose" data-status={status}>
      <Badge color={look.color} shape="pill" size="md" icon={look.icon}>{pill}</Badge>
      {note || children ? <span className="pq-status-note">
          {note}
          {note && children ? ' ' : null}
          {children}
        </span> : null}
    </div>;
};

<AgentStatus status="partly-tested" label="Key address tested (2026-09-19); sign-in from Anthropic's docs, not tested yet" />

Claude is Anthropic's AI assistant on the web, in the desktop app and in the iOS and Android apps. Add PostQueen as a custom connector and Claude can list your channels, write and schedule posts, add a photo from your device, and tell you how your published posts did.

<div className="pq-visual pq-tint-lilac">
  <img noZoom src="https://mintcdn.com/forceplay/CEQwaAjYodG7Gh_r/images/site/agents/claude.webp?fit=max&auto=format&n=CEQwaAjYodG7Gh_r&q=85&s=168c526207d651b37366b08c09efd47e" alt="A sample Claude chat with PostQueen connected: a request for posts, the PostQueen tools it used, and the reply" width="1280" height="966" data-path="images/site/agents/claude.webp" />
</div>

## Before you start

* **Plans:** Free (one custom connector), Pro, Max, Team and Enterprise.
* **Platforms:** add the connector on the web or in Claude Desktop (macOS, Windows). It then works in the iOS and Android apps too; adding one from mobile is in beta.
* **A PostQueen API key.** A workspace admin copies it, or the ready-made address, from **Connections**.

<Info>
  **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.
</Info>

## Connect Claude

These steps use the key address, the route PostQueen tested on 2026-09-19. To sign in instead of using a key, see [Other ways to connect](#other-ways-to-connect).

<Steps>
  <Step title="Copy your MCP address">
    In PostQueen, open **Connections** and copy the address from the Claude card, or build it from your key:

    ```text wrap theme={"system"}
    https://api.postqueen.ai/mcp/YOUR_API_KEY
    ```
  </Step>

  <Step title="Add a custom connector">
    In Claude, open **Customize > Connectors**, then **+ > Add custom connector**.
  </Step>

  <Step title="Paste the address">
    Name it `PostQueen` and paste the address as the URL, with no slash at the end. Leave **Advanced settings** empty and click **Add**.
  </Step>

  <Step title="Switch it on in a chat">
    In a chat, open **+** (or type `/`), choose **Connectors** and switch PostQueen on.
  </Step>
</Steps>

<Note>
  **On Team and Enterprise,** an Owner adds the connector first under **Organization settings > Connectors > Add > Custom > Web**. Members then connect it from **Customize > Connectors**.
</Note>

## Check that it works

Ask Claude: "List my PostQueen channels." Claude calls PostQueen and answers with the channels you connected. The PostQueen tools show up in the chat as `mcp__PostQueen__...` calls.

## Good to know

* **Anthropic advises against secrets in a URL.** The key address works and is tested, but it carries your key, so keep it private. The sign-in under [Other ways to connect](#other-ways-to-connect) avoids a key in the URL; PostQueen has not tested it yet. If the address leaks, a workspace admin rotates the key under **Connections > API Keys**.
* **Claude cannot add PostQueen for you.** Asked in a chat, it says it cannot add servers itself. Add the connector in **Connectors**.
* **PostQueen is not in Anthropic's connector directory**, so searching **Connectors** does not find it. Add it as a custom connector.
* **Upload from your device.** In Claude, PostQueen's upload widget opens an **Upload Media** panel where you add a photo or video from your device. It works on the web, in Claude Desktop, in Cowork and in the mobile apps.
* **Claude Desktop's config file** starts only local servers. Use the **Connectors** screen for PostQueen.
* **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](/mcp/tools) lists what it can do.

## Other ways to connect

| Way                    | Address                                      | Status                                                                    |
| ---------------------- | -------------------------------------------- | ------------------------------------------------------------------------- |
| The key in the address | `https://api.postqueen.ai/mcp/YOUR_API_KEY`  | Tested (2026-09-19). The route above                                      |
| Sign in with PostQueen | `https://api.postqueen.ai/mcp-oauth-dynamic` | From Anthropic's docs, not tested yet                                     |
| The Bearer header      | `https://api.postqueen.ai/mcp`               | Not for Claude: custom headers in the connector dialog are a limited beta |

The key address has 21 tools. The sign-in address has 20, all but `ask_postqueen`.

<Accordion title="Sign in with PostQueen instead (not tested yet)" icon="log-in">
  With the sign-in, no key is copied or stored in Claude. Only a workspace admin can approve it.

  <Steps>
    <Step title="Add the sign-in address">
      In **Customize > Connectors**, choose **+ > Add custom connector**, name it `PostQueen` and paste `https://api.postqueen.ai/mcp-oauth-dynamic` as the URL, with no slash at the end. Leave the OAuth client ID and secret empty, so Claude registers itself, and click **Add**.
    </Step>

    <Step title="Sign in and approve">
      Click **Connect**, sign in to PostQueen and approve access.
    </Step>

    <Step title="Switch it on in a chat">
      Open **+** (or type `/`), choose **Connectors** and switch PostQueen on.
    </Step>
  </Steps>

  The access does not expire on its own. Revoke it in PostQueen under **Connections > Approved Apps**.
</Accordion>

## Try this first

```text wrap theme={"system"}
List my PostQueen channels. Then turn these notes into a short Bluesky post and save it as a draft for tomorrow at 9am: <paste your notes>
```

The draft appears on your PostQueen calendar, ready for you to check and schedule. [Prompts to try](/mcp/examples) has more.

## Troubleshooting

| Symptom                                          | Fix                                                                                                                       |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Searching **Connectors** does not find PostQueen | PostQueen is not in Anthropic's directory. Add it as a custom connector.                                                  |
| Claude refuses the address                       | Paste it with no slash at the end. Claude checks that it matches exactly.                                                 |
| The tools do not show up in a chat               | Open **+** (or type `/`), choose **Connectors** and switch PostQueen on.                                                  |
| The key is refused                               | Copy the address again from the Claude card on **Connections**. Only a workspace Admin or Super Admin can reveal the key. |
| “Only an admin can approve”                      | Ask a PostQueen workspace admin to sign in and approve, or to set it up with the key address.                             |
| You cannot add a second custom connector         | The Free plan allows one. Remove the other one, or use a paid plan.                                                       |

More fixes are on [Troubleshooting agents](/agents/troubleshooting).

## Is it the same as Claude Code or Claude Cowork?

No. Anthropic ships three products that can use PostQueen, and two of them share this connector:

| Product                                | What it is                                           | How it connects                                     |
| -------------------------------------- | ---------------------------------------------------- | --------------------------------------------------- |
| **Claude** (this page)                 | Anthropic's assistant on the web, desktop and mobile | A custom connector                                  |
| [Claude Cowork](/agents/claude-cowork) | Claude's agent mode for everyday work                | The same connector, switched on in a Cowork session |
| [Claude Code](/agents/claude-code)     | Anthropic's coding agent for the terminal and IDEs   | One `claude mcp add` command                        |

A connector you add in Claude also shows up in Claude Code when you log in to Claude Code with a claude.ai subscription.

## Next steps

<CardGroup cols={2}>
  <Card title="Every agent" icon="bot" href="/agents/overview">
    Which agents can post to PostQueen, how each one connects, and what PostQueen has tested.
  </Card>

  <Card title="The MCP tools" icon="wrench" href="/mcp/tools">
    What each of the 21 tools does, and what an agent cannot do.
  </Card>

  <Card title="Prompts and tool calls" icon="messages-square" href="/mcp/examples">
    The order an agent calls the tools in, with prompts that work.
  </Card>

  <Card title="Troubleshooting agents" icon="life-buoy" href="/agents/troubleshooting">
    What to do when a connection or a command fails.
  </Card>
</CardGroup>