Client setup

Configure your AI client to connect to the PostSyncer MCP server. There are three ways in:

ChatGPT app — PostSyncer is an official app in the ChatGPT app directory. Install it; nothing to configure. See ChatGPT: install the official app below.
Connector (OAuth) — for clients that support it (e.g. Claude custom connectors). No token to create; you authorize in PostSyncer. See Connect as a connector (OAuth) below.
Bearer token — for config-file clients (Claude Desktop, Claude Code, Cursor) and scripts. See Connect with a Bearer token below.

ChatGPT: install the official app

PostSyncer is listed in the ChatGPT app directory, so ChatGPT needs no connector URL and no token.

Open PostSyncer in ChatGPT (or open Apps in ChatGPT and search for PostSyncer).
Click Install. ChatGPT sends you to PostSyncer to sign in and Allow access.
In any chat, mention @PostSyncer — for example “@PostSyncer schedule this video to TikTok, Instagram Reels and YouTube Shorts for tomorrow at 9am”. ChatGPT gets the full tool set (posts, media, comments, campaigns, analytics), scoped to the workspaces you belong to.

To disconnect later, remove the app under Settings → Apps in ChatGPT and/or revoke access from your PostSyncer account.

Prefer a custom connector instead of the app (for example on a workspace plan that manages connectors centrally)? In ChatGPT open Settings → Connectors → Create, set the URL to https://postsyncer.com/mcp, and complete the OAuth authorization — the same flow as the connector section below.

Connect as a connector (OAuth)

If your client supports MCP connectors (Claude on the web and desktop do), this is the simplest path — there is no token to create or paste.

In Claude, open Settings → Connectors → Add custom connector (the option may be Add custom connector / Connect apps; it requires custom connectors to be enabled for your plan).
Set the URL to https://postsyncer.com/mcp and add it.
Claude sends you to PostSyncer to authorize. Sign in if needed, then click Allow on the consent screen.
Claude is connected. The PostSyncer tools (e.g. list-workspaces, create-post) are now available, scoped to the workspaces you belong to.

To disconnect later, remove the connector in Claude and/or revoke access from your PostSyncer account.

One-click connect links

Some clients accept a deep link that pre-fills the PostSyncer server, so you only confirm and authorize. The same buttons are available in-app under Settings → API Keys → Connect to AI assistants.

Client	One-click link
ChatGPT	Open PostSyncer in ChatGPT — the official app listing; click Install
Claude	Add PostSyncer to Claude — opens the Add custom connector dialog, prefilled

Other clients have no prefill link — add https://postsyncer.com/mcp manually in their connector settings.

Behind the scenes this uses standard OAuth 2.0 (discovery + Dynamic Client Registration + PKCE). Any MCP client that implements the connector/OAuth flow can use it against https://postsyncer.com/mcp — it will discover the endpoints automatically.

Connect with a Bearer token

Create a token first: open app.postsyncer.com → Settings → API Integrations, click Create, and copy the key, see Authentication.

Connection details

Setting	Value
URL	`https://postsyncer.com/mcp`
Transport	Streamable HTTP
Authorization	`Bearer YOUR_TOKEN` (send as the `Authorization` HTTP header)

Replace YOUR_TOKEN with the token from API Integrations (include the Bearer prefix in the header value).

Claude Desktop

Claude Desktop only loads MCP servers as local processes (command + args). It does not use the url / headers shape from HTTP-native clients. Use the mcp-remote proxy so stdio speaks to PostSyncer’s HTTPS endpoint. Add PostSyncer under mcpServers in your Claude Desktop config:

macOS
Windows

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "postsyncer": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postsyncer.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "postsyncer": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postsyncer.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

On Linux, the file is usually ~/.config/Claude/claude_desktop_config.json. Tips: If npx prompts to install packages, add -y as the first entry in args (for example ["-y", "mcp-remote", ...]). Node 18+ must be on your PATH-Claude Desktop uses your system Node. Restart Claude Desktop after saving. On Windows (and some Cursor builds), spaces inside a single args string can be mangled; if the header fails, use the env workaround: put Authorization:Bearer ${POSTSYNCER_TOKEN} in args (no space after the colon) and set POSTSYNCER_TOKEN to Bearer YOUR_TOKEN_HERE in env.

Claude Code

Claude Code supports HTTP MCP servers natively (recommended for PostSyncer). Use the CLI or a .mcp.json / ~/.claude.json entry as in the Claude Code MCP docs. CLI (Bearer token):

claude mcp add --transport http postsyncer https://postsyncer.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

JSON (for example project .mcp.json or user config)-HTTP servers use type, url, and headers:

{
  "mcpServers": {
    "postsyncer": {
      "type": "http",
      "url": "https://postsyncer.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE",
        "Accept": "application/json"
      }
    }
  }
}

Alternatively, you can use the same mcp-remote + npx block as Claude Desktop if you prefer one config shape everywhere.

Cursor

Open Cursor Settings → MCP and add a new server, or edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project)-see Cursor’s MCP docs.
For a remote server, use url and headers (Cursor’s supported remote shape). Prefer an env var for the token via config interpolation:

{
  "mcpServers": {
    "postsyncer": {
      "url": "https://postsyncer.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POSTSYNCER_TOKEN}",
        "Accept": "application/json"
      }
    }
  }
}

Set POSTSYNCER_TOKEN to your personal access token only (the same secret string as in API Integrations-not the word Bearer; the JSON adds Bearer for you). For a one-off test you can use "Authorization": "Bearer YOUR_TOKEN_HERE" instead of ${env:...}. If your Cursor version does not connect with url + headers, use the same mcp-remote + npx block as Claude Desktop (mcp-remote notes that some clients still need this for OAuth or compatibility). Restart Cursor so the tool list refreshes.

Other MCP clients

Any MCP-compatible client that supports Streamable HTTP (or remote HTTP) and custom headers can use PostSyncer:

URL: https://postsyncer.com/mcp
Transport: Streamable HTTP
Header: Authorization: Bearer YOUR_TOKEN_HERE
Recommended: Accept: application/json

Follow that product’s own docs for where to enter the URL and headers.

Verify the connection

After connecting, ask your assistant to run a read-only tool, for example:

List my workspaces

If setup is correct, it should call list-workspaces and return data. Then try list my connected accounts to exercise list-accounts.

Troubleshooting

Symptom	What to check
401 / Unauthorized (token)	Token missing, revoked, or `Authorization` not formatted as `Bearer` plus your token (no typos or extra spaces). Create a new token from API Integrations if unsure.
Connector won’t authorize	Make sure you’re signed in to PostSyncer in the same browser, then click Allow on the consent screen. If the connector was removed, re-add `https://postsyncer.com/mcp` and authorize again.
Tool denied (token)	Each tool needs the `resource:action` permission of the API route it mirrors, e.g. `posts:read` for `list-posts`, `posts:create` for `create-post`, `workspaces:read` and `accounts:read` to discover IDs. The error names the missing permission; grant it by editing the key in API Integrations. Connector authorizations get full access, scoped to your workspaces.
Empty or partial tools	Update the client; some older builds mishandle `tools/list` pagination.

Start here

Guides

MCP

API reference

Integrating MCP clients

Client setup

ChatGPT: install the official app

Connect as a connector (OAuth)

One-click connect links

Connect with a Bearer token

Connection details

Claude Desktop

Claude Code

Cursor

Other MCP clients

Verify the connection

Troubleshooting

See also

​Client setup

​ChatGPT: install the official app

​Connect as a connector (OAuth)

​One-click connect links

​Connect with a Bearer token

​Connection details

​Claude Desktop

​Claude Code

​Cursor

​Other MCP clients

​Verify the connection

​Troubleshooting

​See also

Client setup

ChatGPT: install the official app

Connect as a connector (OAuth)

One-click connect links

Connect with a Bearer token

Connection details

Claude Desktop

Claude Code

Cursor

Other MCP clients

Verify the connection

Troubleshooting

See also