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

# Connect an AI assistant to PostOnce

> Use Claude, ChatGPT, Grok, Cursor, Codex or any MCP client to publish posts and manage cross-posting workflows in PostOnce. Every assistant signs in with PostOnce; an API key is only a fallback for clients without sign-in.

You can ask an AI assistant to publish posts, schedule them, or set up cross-posting workflows in PostOnce. It connects through PostOnce's MCP server at `https://postonce.to/mcp`.

Open [Settings › AI agents](https://postonce.to/dashboard/preferences?tab=agents) and choose your assistant. PostOnce shows the exact steps for it.

![Settings, AI agents tab: choose your assistant from ChatGPT, Claude, Claude Code, Codex, Cursor, Grok, NanoClaw, OpenClaw, Hermes Agent or Any MCP client](https://mintcdn.com/postonce-87a0d366/llK1OPN-cTbmVTs4/images/help/ai-agents.webp?fit=max\&auto=format\&n=llK1OPN-cTbmVTs4\&q=85\&s=82e116ed50f38f7ad1a2802b92abded3)

## Two ways to connect

| Assistant | How it connects |
| - | - |
| Claude, ChatGPT, Grok, Claude Code, Codex, Cursor, OpenClaw, Hermes Agent and any MCP client that supports sign-in | Sign in to PostOnce from the assistant and click **Allow access**. No API key needed. |
| NanoClaw, and MCP clients that can't sign in | Use a PostOnce **API key** in the assistant's settings. |

Assistants that sign in work during the free trial and on every paid plan. Assistants that use an API key need a paid plan (Creator, Pro or Agency); API keys are not available during the trial. To publish, you also need at least one connected social account.

## Connect a coding tool or agent

Add the PostOnce server, then sign in once:

* **Claude Code:** run `claude mcp add --transport http --scope user postonce https://postonce.to/mcp`, then run `/mcp` in Claude Code, select **postonce** and choose **Authenticate**.
* **Codex:** run `codex mcp add postonce --url https://postonce.to/mcp`, then `codex mcp login postonce`.
* **Cursor:** add `{"mcpServers": {"postonce": {"url": "https://postonce.to/mcp"}}}` to `~/.cursor/mcp.json`, then open **Cursor Settings › MCP** and click **Connect** next to postonce.
* **OpenClaw:** run `openclaw mcp set postonce '{"url":"https://postonce.to/mcp","transport":"streamable-http","auth":"oauth"}'`, then `openclaw mcp login postonce`.
* **Hermes Agent:** add `postonce` with `url: "https://postonce.to/mcp"` and `auth: oauth` under `mcp_servers` in `~/.hermes/config.yaml`, then run `hermes mcp login postonce` from a new terminal.
* **Any other MCP client:** add the remote server `https://postonce.to/mcp` (Streamable HTTP) and choose sign-in or OAuth if the client asks. There's no client ID or key to enter.

Your browser opens PostOnce's sign-in page. Click **Allow access**, then ask the assistant: "Show my connected social accounts."

## Connect with an API key

Use this only for NanoClaw or a client that can't sign in.

1. Open [Settings › API keys](https://postonce.to/dashboard/preferences?tab=api-keys), name the key and click **Create**. Copy it right away; it's shown only once.
2. Add PostOnce to your assistant with these details:

```text theme={null}
URL: https://postonce.to/mcp
Transport: Streamable HTTP
Authorization: Bearer YOUR_POSTONCE_API_KEY
```

3. Ask the assistant: "Show my connected social accounts." It should list your accounts.

![Settings, API keys tab with a key name field, scopes selector and Create button](https://mintcdn.com/postonce-87a0d366/llK1OPN-cTbmVTs4/images/help/api-keys.webp?fit=max\&auto=format\&n=llK1OPN-cTbmVTs4\&q=85\&s=f336eb95e2c9696679165aeed9391cc6)

Keep the key private. Don't paste it into a chat or a shared file. To stop a key working, click **Revoke** next to it and create a new one.

## Manage connected assistants

Assistants you signed in from appear under **Connected apps** on the AI agents tab, with the permissions they have. Click **Revoke access** to disconnect one.

## Tips

* Ask the assistant to create a draft first and check it in [Posts › Drafts](https://postonce.to/dashboard/posts/drafts) before publishing.
* Assistants can't read files attached to a chat. Give them a public link to the media instead.

Want your assistant to write better posts too? Add PostOnce's free [AI skills](https://docs.postonce.to/help/ai-skills.md) for native posts on every platform, content calendars, hooks and viral video formats.

Developers can find the full tool reference in the [MCP documentation](https://docs.postonce.to/mcp/docs.md) and the [API reference](https://docs.postonce.to/introduction.md).

## Still stuck?

Search this help center with <kbd>⌘</kbd> <kbd>K</kbd>, or email [support@postonce.to](mailto:support@postonce.to) from the address you use for PostOnce. Include the platform, the approximate time, and the exact message you saw. Never send passwords, access tokens, API keys, or card details.

Something missing from PostOnce? [Request a feature](https://postonce.featurebase.app/) or check the [roadmap](https://postonce.featurebase.app/roadmap).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.