Connect Claude, Cursor or another AI app to Publedia with MCP
Connect Claude, ChatGPT, Cursor, VS Code, Codex or another AI app to your workspace over MCP by signing in, or with an API key for a script or server.
Эта статья доступна только на английском.
Publedia runs an MCP server, so an AI app that speaks the Model Context Protocol can work with your workspace directly. Depending on what you allow, it can look at your posts, calendar, analytics (beta), inbox (beta) and channels, create and edit drafts, or schedule and publish for you. Using AI agents to manage social media covers which jobs to hand an agent and which to keep.
The app learns what it can do from the server when it connects, so what follows is the setup and the kinds of requests that work, not a fixed list of actions.
Before you start
- An admin turns on Assistants can connect to this workspace in Settings, Assistants. While it is off, every app is refused.
- Any editor or admin can connect an app for themselves. What it may do is never more than your own role allows.
1. Pick your app and take its one step
- Open Settings and choose Assistants under your workspace.
- Pick your app: Claude Code, Claude (desktop and web), ChatGPT, Cursor, or another one from More apps, such as VS Code or Codex.
- Take the one step its panel shows. There is no key to copy:
| App | Step |
|---|---|
| Claude Code | Copy the command and run it in a terminal. It adds Publedia for all your projects. |
| Cursor, VS Code | Select Add to Cursor or Add to VS Code and confirm in the app. |
| Codex | Copy the two commands and run them. The second opens the sign-in. |
| Claude, ChatGPT | Copy the server URL and add it as a custom connector in the app's settings. |
| Another app | Copy the server URL and choose OAuth or sign in when the app asks. |
2. Sign in
The app opens Publedia in your browser. Sign in, choose the workspace, choose what the app may do, and select Allow. Read only is enough to ask about your calendar, your results and what failed; allow drafts when you want it to write. The app then appears under Connected apps on the same page.
3. Check it works
Ask your app: "Which Publedia workspace am I connected to?" It answers with your workspace and what it may do. The status line on the Assistants page shows the last connection, or why the last attempt was refused, with the fix.
Ready-made prompts
The server offers three ready prompts, which apps that support MCP prompts show in their prompt or command menu:
- Review performance: a look at how recent posts did and what stood out.
- Plan posts: a set of post ideas for the coming days, based on your channels and what you give it.
- Triage the inbox: new comments sorted by what needs an answer first.
Prompts to try
Ask in plain language; the app picks the right action.
- "Which Instagram posts from the last 30 days got the most comments? Draft three follow-ups." (needs Drafts)
- "What failed this week, and why?"
- "Plan next week's posts from this blog post: [paste or link it]." (needs Drafts)
- "Is any channel in my workspace waiting to be reconnected?"
- "Retry the Instagram post that failed this morning." (needs an API key with Full control)
With drafts allowed, everything the app writes lands as a draft in Publedia, where you check each network's version and preview before scheduling it yourself. That is the safest way to start.
What the app can and cannot do
- A connection reaches one workspace. For another workspace, connect again and choose it.
- An app never does more than you allowed when you signed in, and never more than your role.
- Comments written by people outside your workspace reach the app marked as untrusted, so an instruction hidden in a comment is not treated as yours.
- Each change an app makes is recorded against its connection or key.
- Requests are rate limited per workspace. An app that sends too many in a short time is asked to wait and try again. Connecting and listing what it can do are never limited.
Disconnect an app or revoke a key
In Settings, Assistants, under Connected apps, select Disconnect beside the app and confirm. Its next request is refused. Admins can also see everyone's apps and disconnect all of them at once.
Keys are revoked in Settings, Developers, under API keys. To change a key without downtime, rotate it and keep the old secret working for an hour, a day or a week while you update the app.
If the connection fails
The app shows the reason Publedia gives:
- Authentication required: the app sent no sign-in or key. Connect it again from the Assistants page.
- Credential not accepted: the sign-in ended, or the key expired, was revoked or was mistyped. Reconnect, or create a replacement key.
- Not allowed for this connection: the app tried something you did not allow. Reconnect and allow it, or ask in a way that fits its access.
- MCP connections are disabled: an admin turned off Assistants can connect to this workspace in Settings, Assistants.
- Rate limit exceeded: wait a moment and try again.