Connect the MCP server
Mint an API key, register dx-seo as an MCP server in Claude Code, and backfill your history
Overview
dx-seo exposes a self-hosted MCP server at POST /mcp. Once a Claude Code session can reach it, the /seo-* commands push their results to your dashboard automatically. Every push is authenticated with an API key you mint in Settings.
Sync is best-effort. If the dashboard MCP isn't connected, the commands still run exactly as they would standalone — they just skip the push step.
Steps
Mint an API key
In the dashboard, go to Settings → API keys and create a key. It is an opaque oat_… token shown once — copy it now.
Register the MCP server
Add dx-seo as a user-scoped MCP server so every project can push to it:
For local development the endpoint is http://localhost:8080/mcp.
Backfill your history (one time)
Existing projects have config and ledger history from before the dashboard. Sync it all once:
/seo-migrateIt's idempotent — safe to re-run.
What /seo-migrate backfills
/seo-migrate walks every registered project and pushes its seo/config.json (via seo_upsert_site) and every seo/actions.jsonl entry (via seo_sync_actions), then reads back per-site totals with seo_overview.
Keyword tables and content briefs from past runs were never persisted to disk, so they can't be backfilled. They accrue on the dashboard from the next command run onward.
Verify the connection
Ask the connected session to call seo_overview, or run any command that pushes — for example /seo-quick-wins — and watch a site appear on the dashboard.