Setup Guide

Tutorials

Step-by-step video walkthrough for setting up Blotato with Claude Code:

• Build Your AI Personal Assistant for Social Media Marketing

• The ULTIMATE Claude Code Tutorial (brand voice, quality gates, subagents)

Prerequisites

1. A paid Blotato subscription

2. Your Blotato API key (get it from Settings > API)

3. At least one connected social account in Settings

---

Claude Code

1. Open your terminal

2. Run the following command:

claude mcp add blotato \
  --url https://mcp.blotato.com/mcp \
  --header "blotato-api-key: YOUR_API_KEY"

1. Replace YOUR_API_KEY with your Blotato API key

2. Verify by asking: "What social media accounts do I have connected?"

---

Claude Desktop / Claude Cowork

1. Open Claude Cowork

2. Go to Settings > Developer > Edit Config

3. Right-click claude_desktop_config.json and select "Open Terminal Here"

4. Copy this command and replace YOUR_API_KEY with your Blotato API key from Settings > API:

claude mcp add --transport http blotato https://mcp.blotato.com/mcp \
  --header "blotato-api-key: YOUR_API_KEY"

1. Paste the command into the terminal and run it

2. Blotato MCP uses API key auth, not OAuth. Install an MCP proxy like mcp-remote to handle the connection

3. Claude Cowork does not load your shell profile. Find your real Node.js path by running:

node -e "console.log(process.execPath)"

Use the directory from that output in your config's PATH so Claude Cowork finds Node.js.

1. Restart Claude Cowork

2. Go to Settings > Developer and confirm Blotato MCP shows as connected

3. Verify by asking: "What social media accounts do I have connected in Blotato?"

---

Cursor

1. Open Cursor

2. Go to Settings > MCP

3. Click "Add new MCP server"

4. Enter the following configuration:

{
  "mcpServers": {
    "blotato": {
      "url": "https://mcp.blotato.com/mcp",
      "headers": {
        "blotato-api-key": "YOUR_API_KEY"
      }
    }
  }
}

1. Replace YOUR_API_KEY with your Blotato API key

2. Verify by asking: "What social media accounts do I have connected?"

---

Verify Your Connection

After setup, test the connection by asking your AI tool:

"What social media accounts do I have connected?"

The tool calls blotato_list_accounts and returns your connected platforms. If you see your accounts listed, the setup is complete.

---

Troubleshooting

If the MCP server connects but does not work as expected:

1. Double check you copy/pasted the correct API key from Settings > API. Make sure there are no extra spaces or missing characters.

2. Restart your Claude Code / Claude Desktop / Claude Cowork session after installing the MCP server. MCP servers load on startup.

3. Tell your AI tool the API key is correct and point it to the help docs. For example: "My Blotato API key is correct. Reference this doc for instructions: https://help.blotato.com/api/llm"

4. Verify you have a paid Blotato subscription. API access requires a paid plan.

5. Verify you have at least one social account connected in Settings.

6. If you get a JSON parsing error in your config file, validate it at jsonlint.com. A common mistake is a missing comma between sections.

Video walkthrough: Build Your AI Personal Assistant for Social Media Marketing