# Setup Guide

Setting up Blotato with Claude, Antigravity, or Cursor takes a few minutes.

Generate your API key: [Settings > API](https://my.blotato.com/settings/api)

## Tutorials

Using **Claude.ai Web**? Add Blotato directly here: <https://claude.ai/customize/connectors?modal=add-custom-connector> Paste this URL: `https://mcp.blotato.com/mcp`

Step-by-step video walkthrough for setting up Blotato with Claude Desktop and Cowork:

* [Claude Cowork and Desktop + Blotato MCP](https://youtu.be/1dSNfnFL40c)

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

* [Claude Code + Blotato MCP](https://youtu.be/3HVH2Iuplqo)
* [The ULTIMATE Claude Code Tutorial](https://youtu.be/fYX6hHC9FhQ) (brand voice, quality gates, subagents)

## Prerequisites

1. A paid Blotato subscription
2. At least one connected social account in [Settings](https://my.blotato.com/settings)
3. For Cursor and other API-key-based clients: your Blotato API key from [Settings > API](https://my.blotato.com/settings/api)

***

## Claude.ai Web

1. Go to **Settings** > **Connectors** > **Add Custom Connector**
2. Name: `Blotato`
3. URL: `https://mcp.blotato.com/mcp`
4. Press **Connect** and approve access

You must be logged into your Blotato account in the same browser to complete the OAuth connection.

***

## Claude Desktop / Claude Cowork

1. Go to **Settings** > **Connectors** > **Add Custom Connector**
2. Name: `Blotato`
3. URL: `https://mcp.blotato.com/mcp`
4. Press **Connect** and approve access

You must be logged into your Blotato account in your default browser to complete the OAuth connection.

***

## Claude Code (Terminal)

1. Start a Claude Code session
2. Copy and paste the following command into your session:

   ```bash
   claude mcp add \
     --transport http \
     Blotato https://mcp.blotato.com/mcp
   ```
3. Let Claude apply changes
4. Once done, run `/mcp` inside the session
5. Select `Blotato > Authenticate` and approve access
6. Restart Claude Code

You must be logged into your Blotato account in your default browser to complete the OAuth connection.

***

## Other MCP Clients (Cursor, Antigravity, Replit Agent, etc.)

1. Go to [Settings > API](https://my.blotato.com/settings/api) in the Blotato app
2. Under "Other MCP Clients", click **Copy MCP Config**
3. Paste the JSON config into your app's MCP settings
4. Restart your app

The config adds the Blotato MCP server with your API key:

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

***

## 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. **OAuth clients (Claude.ai, Desktop, Cowork, Claude Code):** Make sure you are logged into your Blotato account in the browser. The OAuth approval requires an active Blotato session.
2. **API key clients (Cursor, etc.):** Double check you copy/pasted the correct API key from [Settings > API](https://my.blotato.com/settings/api). Make sure there are no extra spaces or missing characters.
3. Restart your AI tool after adding the MCP server. MCP servers load on startup.
4. Tell your AI tool the connection is correct and point it to the help docs. For example: "My Blotato MCP is connected. Reference this doc for instructions: <https://help.blotato.com/api/llm>"
5. If Blotato shows "Connected" in Claude Settings but Claude.ai returns an OAuth error when you ask it to list accounts or use any Blotato tool, your Blotato subscription is not active. Go to [Settings > API](https://my.blotato.com/settings/api) and click "Generate API Key" to activate your paid subscription. API access requires a paid plan.
6. Verify you have at least one social account connected in [Settings](https://my.blotato.com/settings).
7. If you get a JSON parsing error in your config file, validate it at [jsonlint.com](https://jsonlint.com). A common mistake is a missing comma between sections.

Video walkthrough: [Build Your AI Personal Assistant for Social Media Marketing](https://youtu.be/3HVH2Iuplqo)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blotato.com/api/mcp/setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.