Connect AI assistants with MCP
MCP (Model Context Protocol) lets an AI assistant work with your blog directly. Once connected, you can ask it in plain language to write and publish posts, fix SEO, manage categories, check analytics or deploy.
It works with Claude Code, Claude (claude.ai and the desktop app), Codex and any other client that supports MCP.
Prerequisites
- A Superblog account with access to the blog you want to manage.
- Your blog on the SUPER plan or above.
- An MCP-compatible AI client.
MCP Server URL
Use this Streamable HTTP MCP server URL:
https://write.superblog.ai/api/mcp
Claude Code
Run this in your terminal:
claude mcp add --transport http superblog https://write.superblog.ai/api/mcp
Then open Claude Code and ask:
show my superblogs
Claude will guide you through authentication if needed.
Claude (claude.ai and Claude Desktop)
The same steps work on claude.ai in the browser and in the Claude Desktop app. The connection is shared across web, desktop and the mobile apps once it is made.
- Open Settings > Connectors.
- Click Add custom connector.
- Enter a name (e.g.,
Superblog) and paste the MCP server URL:
https://write.superblog.ai/api/mcp
- Click Add, then click Connect and complete the sign-in in your browser. The consent screen lists which Superblog sites the connection can reach; you can revoke it later from the same Connectors page.
Once connected, start a new chat and ask:
show my superblogs
Codex CLI
Run this in your terminal:
codex mcp add superblog --url https://write.superblog.ai/api/mcp
codex mcp login superblog
Then start Codex:
codex
Inside Codex, you can check the connection with:
/mcp
Then ask:
show my superblogs
Codex Desktop
- Open Settings > MCP servers.
- Click to add a new MCP server and paste the MCP server URL:
https://write.superblog.ai/api/mcp
- Click Authenticate and complete the sign-in in your browser.
Once it shows "Authentication complete", start a new chat and ask:
show my superblogs
Other MCP Clients
Add a remote MCP server with this URL:
https://write.superblog.ai/api/mcp
Use OAuth if your client supports it.
If your MCP client asks for an API key instead of OAuth, generate an API key from your Superblog dashboard (Dashboard > Data > API keys). See Create API keys. and send it as a bearer token:
Authorization: Bearer <api-key>
What You Can Do
Once connected, you can use natural language to manage almost everything you can do from the dashboard:
Posts and pages
- Create, edit, publish, schedule, pin, and delete posts
- Create, list, and delete static pages (About, Contact, etc.)
- Get internal link suggestions
- Upload images or reuse images from your media library
Content organization
- Manage categories and tags
- Add, update, and delete FAQs on posts (for FAQ rich results)
- Create, edit, and delete redirects
- Manage navigation menu items and footer sections
Translations
- Enable or disable translation languages
- Create and manage translated versions of posts
Audience and team
- Moderate reader comments (approve, hide, or delete)
- View captured leads and manage per-post lead capture forms
- Manage authors: update profiles, reassign posts, add or remove co-authors
- Manage team members: invite, change roles, or remove
Site management
- Read and update site settings (name, SEO defaults, appearance, header, indexing options)
- View blog traffic analytics for any date range
- Connect or disconnect a custom domain, with the exact DNS records to add
- Trigger deployments and check deploy status until your changes are live
- Use advanced operations through the Superblog API for anything else
Give your assistant the API reference
For better results, you can also give your AI client the Superblog OpenAPI spec:
https://write.superblog.ai/api/v2/openapi.json
This helps the AI understand the full REST API surface when it needs to perform advanced operations beyond the built-in MCP tools.
MCP or the API
Use MCP when you want an AI assistant to do the work. Use the REST API when you are writing your own code or automation.