Po Master MCP — Quick Start

Connect any MCP-compatible LLM client (Claude Desktop, Cursor, Cline, …) to Po Master so it can generate XHS / Threads posts directly inside your AI workflow.

---

1. Get an API key

1. Sign in at https://po-master.com
2. Settings → API Keys → New key
3. Name it (e.g. "Claude Desktop on Mac") and copy the pm_live_… value — you only see it once.

Free tier works: MCP and the web app share the same 30-credits/month pool.

2. Wire it into your client

We use mcp-remote — a tiny stdio↔HTTP proxy maintained by the community. Nothing to install in advance, npx fetches it on first run.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "po-master": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.po-master.com/mcp/",
        "--header",
        "Authorization: Bearer pm_live_xxxxxxxxxxxxxxxx"
      ]
    }
  }
}

Tip: the Settings page already shows this exact config block pre-filled with your new key — just hit Copy.

Restart Claude Desktop. The 🔌 icon should show 5 tools under "po-master".

Cursor / Cline

Same JSON shape — add the same mcpServers.po-master entry to their MCP config.

3. Try it

In any MCP-aware chat:

幫我用「拿鐵咖啡如何挑豆子」寫一篇小紅書

Claude will call smart_generate(topic="拿鐵咖啡如何挑豆子", platform="xhs"), charge 10 credits, and return the post + sources. You can then ask it to render_cards for visual cards or rewrite_voice to switch tone.

Tools

| Tool | Cost | Use it for | |---|---|---| | recommend_topics | free | Browse what's trending in your vault | | smart_generate | 10 | Full pipeline — search, explore, generate | | rewrite_voice | 5 | Switch a post into a different voice preset | | render_cards | free | Markdown → 1080×1440 PNG cards | | generate_image | 5 | Cover image via Gemini |

Troubleshooting

• Auth error: Invalid PO_MASTER_API_KEY — revoke and create a new key in Settings.
• Account disabled — contact hello@po-master.com.
• Insufficient credits — check balance in Settings or upgrade to Pro.
• No 🔌 icon in Claude Desktop — verify the JSON is valid and restart fully.

Privacy

The MCP server runs as a stdio subprocess on your machine and connects to https://api.po-master.com over TLS. The only thing leaving your machine is the tool arguments (topic, markdown, etc.) and the API key in the Authorization header. Same policy as the web app: posts are scoped to your account, never used for training.