Connect Claude Desktop
REQUIRED FIRSTMinnal runs inside Claude Desktop via MCP. Follow these 3 steps once to connect, then talk to Claude to schedule posts, pull analytics, and plan content.
Minnal's MCP client runs via npx, which comes bundled with Node.js.
Easiest: In Claude Desktop, open Settings → Developer → Edit Config. This opens the folder containing claude_desktop_config.json.
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
If the file doesn't exist yet, create it as an empty file.
Your API key is already included below — just copy the whole block and paste it into the config file. Save, then quit and reopen Claude Desktop.
Social platforms connect per project. Open any project → Overview tab → click Connect next to LinkedIn, Facebook, or Instagram. Each project gets its own authorization so you can use different accounts per brand.
Quick Setup
- Install Node.js — required to run the MCP client via
npx - Copy the MCP config from and paste it into your Claude Desktop config file
- Set up a Claude Project — in Claude Desktop, create a Project for your brand and paste in your brand voice, target audiences, and product description. This is the most important step for content quality.
- Connect your social platforms in
- Ask Claude: "Plan this week's content for [your brand]" and start scheduling
Using Claude Effectively
- Be specific — platform, brand, timing, tone:
"Schedule 3 LinkedIn posts for Flow next week targeting ADHD founders, keep the tone personal" - Set up a Claude Project with your brand voice, audiences, and product info — Claude generates generic content without it
- Ask for a weekly plan first, then approve individual posts
- Tell Claude what performed well: "That story format got 3× engagement — write more like that"
- Check the queue in Scheduled before posts go live
- Say "do my marketing" — Claude can't write on-brand content without context
- Skip the Claude Project setup — posts will be generic without brand context
- Schedule before connecting a platform in Integrations — posts will fail
- Forget to set target audiences in your project settings
- Use Minnal without Claude Desktop configured — check Settings first
Full Documentation
Step-by-step setup guides, advanced workflows, and example prompts.
Read the full guide →Profile
Email changes aren't available yet — they'll be enabled once account verification is in place.
API key
Your API key authenticates Claude Desktop and any custom integrations. If it's ever exposed, regenerate it immediately — the old key will stop working and you'll need to update your Claude Desktop config (Settings tab).
Export my data
Download a JSON file containing every row Minnal stores for your account — user info, brands, scheduled posts, engagement metrics, connected credential metadata (not the encrypted tokens), and knowledge sources. Use this to keep a personal backup or migrate to another platform.
Delete my account
Permanently delete your account and all associated data: brands, scheduled posts, engagement metrics, connected credentials, knowledge sources, and AI visibility history.
This action cannot be undone. Consider exporting your data first.
Connection Tests
Tests each API key with a minimal request. Keys are read from server environment variables — set them in Railway.
Database Migrations
Run pending schema migrations on the Supabase database. Each migration is idempotent — safe to run more than once.