Connect AI apps with MCP

Postwase runs an MCP server. Once connected, an AI assistant can list your projects and channels, upload images and videos, check posts against each network's rules, and save, schedule or publish posts, all with the same limits and approvals as the Postwase app.

Server address

One address for every app: https://your-postwase-domain/mcp. It speaks MCP's Streamable HTTP transport.

Two ways to sign in

MethodBest forAccess
Sign in with Postwase (OAuth)ChatGPT, Claude.ai, Claude Desktop and other apps with a “connector” screen. Nothing to copy.Acts as you in every project you belong to, with your role in each. You can disconnect it in Account & security.
Project API keyCoding tools and agents with an MCP config file (Antigravity, Cursor, VS Code, Claude Code, Gemini CLI).One project only. Create it in the project's Settings → Developers (admins only). Revoke it there.
An API key is a password: keep it out of shared repositories and screenshots. Put it in your app's user-level config, not a project file you commit.

Step-by-step for your app

App menus change from release to release; if a label below differs, look for the screen where you add a custom connector or MCP server.

  1. In ChatGPT, open Settings → Apps & Connectors. Under Advanced settings, turn on Developer mode (available on paid plans; workspace admins may have to allow custom connectors).
  2. Choose Create (add a custom connector). Name it Postwase, paste the server address https://your-postwase-domain/mcp and pick OAuth as the authentication.
  3. ChatGPT opens Postwase: sign in and press Allow.
  4. In a new chat, enable the Postwase connector (Developer mode) and ask, for example: “Schedule a post on my shop's Facebook Page for 9am tomorrow.”

Without developer mode, ChatGPT only offers read-only search and fetch tools, so it can find your posts but not create them.

What to ask

  • “What Postwase projects and channels do I have?”
  • “Take this image, write an Instagram and Facebook caption for our weekend sale, and save it as a draft.”
  • “Import https://example.com/clip.mp4 and schedule it on TikTok (public) and YouTube Shorts for Friday 7pm.”
  • “Plan next week's posts around our autumn menu and put them in the queue.” (uses the plan_week prompt)
  • “Which posts failed this week, and why?” / “How did last month's posts perform?”

How uploads work

  • A public link (Drive/Dropbox direct link, a CDN, a ClipForge export): upload_media_from_url.
  • An image in the chat: the AI sends it inline with upload_media (up to 15 MB).
  • A large video on your computer: create_upload_link returns a one-hour link to send the file to, then complete_upload. Or upload it in Postwase's Media page and ask the AI to use it (list_media).

Postwase prepares every file (size, duration, thumbnails, a JPEG or H.264 MP4 copy where a network needs one). Posts can use a file once get_media says ready.

Safety built in

  • The AI has your role: a viewer can't post; an editor's posts wait for approval when the project requires it.
  • Every network rule (length, media, required options) is checked before anything is saved; errors come back in plain words.
  • The server tells the AI to confirm text, channels and time with you before scheduling or publishing, and to prefer drafts.
  • Plan limits apply exactly as in the app. Password, billing, team and approvals stay in the Postwase app only.
  • Disconnect an app in Account & security, or revoke an API key in project Settings → Developers. Access ends immediately.

Troubleshooting

“Authentication required” / 401The key was revoked, or the app's sign-in expired. Reconnect, or paste a new key.
No tools in ChatGPTTurn on Developer mode, and enable the connector in the chat.
“This connection is read-only”The app asked only for read access. Disconnect it in Account & security and connect again.
“Not found” for a projectAPI keys see only their own project. Use a key from that project, or sign in with Postwase (OAuth).
Testing the server yourselfRun npx @modelcontextprotocol/inspector, choose Streamable HTTP, URL https://your-postwase-domain/mcp, and add the Authorization header.

Next: the full tools reference.