Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.magicpost.in/llms.txt

Use this file to discover all available pages before exploring further.

Claude Desktop communicates with MCP servers over stdio. Because the MagicPost MCP server uses HTTP transport, you use the open-source mcp-remote bridge to convert stdio to HTTP locally on your machine.

​
Prerequisites

  • macOS, Windows, or Linux with Claude Desktop installed
  • Node.js 18+ on your PATH (npx requires it)
  • A MagicPost API key — see creating a token

​
Configure

1

Locate the config file

Find the Claude Desktop configuration file for your operating system:
OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
2

Add the MCP server block

Open the file (create it if it doesn’t exist) and add the mcpServers entry below. Replace mp_YOUR_TOKEN_HERE with your actual API key.
{
  "mcpServers": {
    "magicpost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.magicpost.in/mcp",
        "--header",
        "Authorization:Bearer mp_YOUR_TOKEN_HERE"
      ]
    }
  }
}
When you create a key from Settings → API & MCP, the dialog includes a copy-paste-ready version of this snippet with your token already filled in.
3

Fully quit and relaunch Claude Desktop

On macOS, use Cmd+Q — closing the window is not enough. MCP servers are only loaded at startup.

​
Verify

After relaunching, open a new conversation and click the tools indicator in the input bar. You should see magicpost listed with 8 tools available:
  • get_metrics_summary
  • refresh_my_posts
  • list_my_posts
  • get_post
  • create_or_update_post
  • schedule_post
  • cancel_scheduled_post
  • publish_post_now
Try an example prompt to confirm everything is working: 
List my scheduled posts on MagicPost
Claude will call list_my_posts and read back your upcoming posts.

​
Troubleshooting

  1. Open the Claude Desktop logs: Preferences → Developer → Open log directory
  2. Look for mcp.log or claude_mcp.log
  3. Common causes:
    • JSON syntax error in claude_desktop_config.json — validate it with python -m json.tool claude_desktop_config.json
    • npx not found on PATH — install Node.js via nvm or Homebrew
    • Network blocked — confirm connectivity with curl https://mcp.magicpost.in/.well-known/oauth-protected-resource
Your API key is invalid or has been revoked. Generate a new one from Settings → API & MCP and replace the token in the config file.
The MCP bridge may have crashed silently. Restart Claude Desktop. If the issue persists, run the bridge manually to see its output:
npx -y mcp-remote https://mcp.magicpost.in/mcp \
  --header "Authorization:Bearer mp_YOUR_TOKEN"

​
Privacy

mcp-remote runs on your machine and forwards requests directly to mcp.magicpost.in. Your token never passes through a third party. The MagicPost MCP server validates it and acts on your behalf.