Connect Claude to your MacroMkt org
MacroMkt ships a hosted MCP server at mcp.macromkt.com. Mint a long-lived token, paste it into your Claude config, and the 13+ MacroMkt tools show up in any chat — drafts, monitors, scans, history, weekly briefs.
Mint an API token
Go to Settings → API Tokens and click New token. Pick a name (e.g. claude-laptop), then check only the scopes the session needs. Start narrow.
The plaintext value (mk_live_…) is shown once on the green card. Copy it before navigating away — we only store a hash.
Wire it into Claude
Claude Code (CLI)
One command, scoped to your current project:
claude mcp add --transport http mktops https://mcp.macromkt.com/mcp \
--header "Authorization: Bearer mk_live_PASTE_TOKEN_HERE"Add --scope user to install for every project on your machine. Don't use --scope project with a real token — it gets written to a checked-in .mcp.json.
Claude Desktop
Open ~/Library/Application Support/Claude/claude_desktop_config.json (create it if missing) and add:
{
"mcpServers": {
"mktops": {
"url": "https://mcp.macromkt.com/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer mk_live_PASTE_TOKEN_HERE"
}
}
}
}Restart Claude Desktop. The mktops server should appear in the MCP indicator.
Verify it's connected
In Claude Code, run /mcp — you should see mktops connected with 15 tools. In Claude Desktop, look for the MCP indicator in the bottom-right of the input box.
Then in any chat:
Use the mktops whoami tool.Claude should call whoami and quote back your email, the active org, and the scopes carried by the token. If you see a 401, double-check the token; if you see a 403 on subsequent calls, mint a new token with the missing scope.
Tool reference
Scope gates are enforced server-side. A token missing a scope gets a clean 403 with the missing scope named in the body.
Read tools — safe to grant broadly
| Tool | Scope | Does |
|---|---|---|
| whoami | (none) | Confirm token + discover scopes |
| list_posts | posts:read | Drafts and published posts in the active org |
| get_post | posts:read | Single post by id |
| list_credentials | credentials:read | Wired-up platform keys (masked) |
| list_monitors | monitors:read | Configured monitors per platform |
| list_history | history:read | Recent findings / events per platform |
| weekly_brief | posts:read + history:read | One-shot 7-day digest |
| pending_drafts | posts:read | Posts awaiting human approval |
Write tools — grant deliberately
| Tool | Scope | Does |
|---|---|---|
| create_draft | drafts:write | POST /api/posts |
| update_draft | drafts:write | PUT /api/posts/{id} |
| delete_draft | drafts:write | DELETE /api/posts/{id} |
| publish_post | posts:publish | POST /api/posts/{id}/publish |
| create_monitor | monitors:write | POST /api/{platform}/monitors |
| delete_monitor | monitors:write | DELETE /api/{platform}/monitors/{id} |
| run_scan | scans:run | POST /api/{platform}/scan |