MCP Setup

Prerequisites

• A Misar.Blog account at www.misar.blog
• An MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, or any MCP-capable client)

Step 1 — Get Your API Key

The MCP connect flow generates a key automatically. Trigger it from your browser while logged in:

POST https://api.misar.io/blog/v1/auth/mcp-connect?callback_port=6748

Or visit Dashboard → Settings → API Keys → Connect MCP — the UI handles the flow and writes the key to your local MCP config automatically.

The key starts with mbk_ and is delivered to http://localhost:6748/callback (your local MCP client). Store it securely — it's shown only once.

Step 2 — Choose a Transport

Option A — HTTP (Remote MCP, no install required)

Use this if your client supports remote MCP servers over HTTP. No npm install needed.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "misarblog": {
      "type": "http",
      "url": "https://api.misar.io/blog/v1/mcp",
      "headers": {
        "Authorization": "Bearer mbk_YOUR_KEY"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor / Windsurf (.cursor/mcp.json or .windsurf/mcp.json)

{
  "mcpServers": {
    "misarblog": {
      "type": "http",
      "url": "https://api.misar.io/blog/v1/mcp",
      "headers": {
        "Authorization": "Bearer mbk_YOUR_KEY"
      }
    }
  }
}

Option B — Stdio (npm package, works everywhere)

Install once globally or run directly with npx:

npm install -g @misarblog/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "misarblog": {
      "command": "misarblog-mcp",
      "env": {
        "MISARBLOG_API_KEY": "mbk_YOUR_KEY"
      }
    }
  }
}

Claude Code

claude mcp add misarblog -- misarblog-mcp
# Then set your key:
export MISARBLOG_API_KEY=mbk_YOUR_KEY

Or use npx without installing:

claude mcp add misarblog -- npx @misarblog/mcp

Step 3 — Verify Connection

Restart your AI client and run:

List my Misar.Blog articles

Your client should call list_articles and return your articles.

Available Tools

| Tool | Description | |------|-------------| | list_articles | List your articles (filter by status, limit) | | get_article | Get full article content by ID or slug | | create_draft | Create a new draft from markdown | | update_article | Update title, body, or tags of a draft | | publish_article | Publish a draft article | | search_articles | Search published articles by keyword, tag, or author |

Revoking MCP Access

Go to Dashboard → Settings → API Keys and revoke the key named MCP. Access is removed immediately on the next tool call.

Troubleshooting

| Issue | Fix | |-------|-----| | 401 Unauthorized | Key was revoked or copied incorrectly — regenerate via the MCP connect flow | | Tools not appearing | Restart the AI client after updating the config file | | callback_port refused | Ensure your MCP client is running and listening on the configured port before triggering the connect flow | | HTTP transport not supported | Use Option B (stdio/npm) — some older clients only support stdio |