XPlanner

Docs

MCP

A guide to connecting XPlanner MCP with Claude, ChatGPT, Codex CLI, and Claude Code CLI.


Overview

What does the MCP connection do?

The XPlanner MCP server lets supported clients securely work with your workspace and content flow.

  1. Choose the Claude or Codex / ChatGPT client from the MCP page.

  2. Open the client connection screen with the Connect action.

  3. Copy the MCP endpoint or CLI command from the drawer if needed.

  4. Approve OAuth with your XPlanner account during connection.

Open the MCP screen

View Claude, ChatGPT, and CLI connection details.

Open

Capabilities

What can MCP do in XPlanner?

The connected Claude, ChatGPT, or Codex client operates only with the scopes you approve, and its tools use the current Public API contract.

  1. It can discover workspaces, Social Sets, and X, LinkedIn, and Threads publish targets.

  2. It can read current platform text and media limits and prepare target-specific publishTargets.

  3. It can read, create, update, and, when authorized, delete posts, ideas, folders, and media.

  4. Risky actions such as publishing and deleting also require explicit confirmation and the relevant granular scope.

Routines are not yet exposed through Public API or MCP; automated workflows remain private until user ownership and a dedicated permission domain are complete.

Connect to Claude

Set up the Claude connection

For Claude, the XPlanner connection opens Claude’s connector screen with the connection details ready.

  1. Open Account Settings > MCP.

  2. Select the Connect action on the Claude card.

  3. Check the MCP server name and endpoint in the Claude connection screen.

  4. Approve the connection in Claude.

Claude’s connection screen auto-fills the details it supports; if a field is missing, copy the endpoint from the MCP drawer.

Connect to ChatGPT / Codex

Set up the ChatGPT and Codex connection

You can create the connection in the ChatGPT Connector screen using the XPlanner MCP endpoint.

  1. In Account Settings > MCP, select the Connect action on the Codex card.

  2. When the ChatGPT connector screen opens, set the connector name to xplanner.

  3. Enter https://mcp.xplanner.co/mcp in the MCP endpoint field.

  4. Complete the XPlanner OAuth approval during connection.

If official auto-fill parameters for connector name and endpoint are not supported, XPlanner does not use undocumented URL parameters.

Codex CLI

Connect with Codex CLI

If you work from the terminal, you can add the XPlanner MCP server with Codex CLI.

  1. Codex CLI must be installed and signed in.

  2. Copy the command from the MCP drawer.

  3. Run codex mcp add xplanner --url https://mcp.xplanner.co/mcp in your terminal.

  4. If Codex asks for OAuth approval, complete the browser flow.

Claude Code CLI

Connect with Claude Code CLI

If you use Claude Code CLI, you can add the XPlanner MCP server from the terminal.

  1. Claude Code CLI must be installed and signed in.

  2. Copy the command from the MCP drawer.

  3. Run claude mcp add --transport http xplanner https://mcp.xplanner.co/mcp in your terminal.

  4. If Claude asks for OAuth approval, complete the connection flow.

Advanced Setup

When is manual config needed?

CLI commands are enough for most users. Manual config should only be used for custom setups or project-level MCP settings.

  1. ~/.codex/config.toml is the local Codex user configuration.

  2. A project-level .codex/config.toml only stores settings for that project workspace.

  3. With manual config, the server name should be xplanner and the endpoint should be https://mcp.xplanner.co/mcp.

  4. The CLI method is the default recommendation because it creates the same configuration with less risk of mistakes.

Manual configuration is not required for regular users; that is why the MCP drawer shows a ready CLI command.

Troubleshooting

What should I check if the connection does not work?

The MCP connection is established between the client, OAuth, and your XPlanner account. If something goes wrong, verify the basic connection details first.

  1. Check that the endpoint value is https://mcp.xplanner.co/mcp.

  2. Make sure you are signed in to your XPlanner account.

  3. If the OAuth approval window does not open, check your browser popup blocker.

  4. If you use CLI, make sure the client is up to date.

How will the guide be updated?

When a new user flow occurs, this section is added as a new page to the same docs structure.

When the display language changes, the actual button and title names are checked again with Playwright smoke.

API-related flows are cross-linked to the relevant API v1 page.