> ## Documentation Index
> Fetch the complete documentation index at: https://dev.magicpost.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect Claude Desktop to your MagicPost account in 3 steps.

By the end of this page, Claude Desktop can list your scheduled posts, draft
new ones, attach supported files when the client provides them to the MCP,
schedule them, and read your analytics — all from a normal conversation.

## 1. Create an API key

**1. Open Settings**

Sign in to [app.magicpost.in](https://app.magicpost.in/account) and go to
**Settings → API & MCP**.

**2. Create a key**

Click **Create a key**, name it (e.g. `Claude Desktop`), and submit.

**3. Copy the token**

The cleartext token (`mp_...`) is shown **exactly once**. Copy it now —
you won't be able to see it again. The reveal dialog also includes a
ready-to-paste `claude_desktop_config.json` snippet.

## 2. Configure Claude Desktop

**1. Open the config file**

Open `~/Library/Application Support/Claude/claude_desktop_config.json` on
macOS (or the equivalent on Windows/Linux).

**2. Add the MCP server**

Paste this block (the create-key dialog has it pre-filled with your token):

```json theme={null}
{
  "mcpServers": {
    "magicpost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.magicpost.in/mcp",
        "--header",
        "Authorization:Bearer mp_YOUR_TOKEN_HERE"
      ]
    }
  }
}
```

> [!NOTE]
>
> Claude Desktop talks to MCP servers over stdio. `mcp-remote` is a tiny
> npm bridge that proxies stdio ↔ HTTP so you can connect to remote MCP
> servers. It runs locally and only forwards your requests.

**3. Restart Claude Desktop**

Fully quit (Cmd+Q on macOS, not just close the window) and relaunch.
A new MCP server `magicpost` should appear under the tools indicator.

## 3. Try it

In any conversation, ask things like:

* *"List my scheduled posts on MagicPost"*
* *"Summarize my LinkedIn analytics for the last 30 days"*
* *"Create a draft: 'My first post via Claude'"*
* *"Create a draft from this text, attach this image, then schedule it for
  tomorrow at 14:00"* (attach the file to the conversation before sending)
* *"Schedule post xyz for tomorrow 14:00"* (Claude will warn you if you already
  have other posts that day before going through)

> [!NOTE]
>
> Media attachment depends on the MCP client exposing the uploaded file as a
> temporary file reference. If the client does not offer the file to the
> `attach_media_to_post` tool, create the draft in chat and add the media from
> the MagicPost web app.

If Claude says it doesn't have access to your data, the MCP server probably
didn't load — check the config file syntax and that `mcp-remote` is reachable
(your machine needs `npx`).

## Next steps

> [card] [MCP tools](https://dev.magicpost.in/mcp/tools.md)
>
> Full catalog of what the LLM can do.

> [card] [Attach media](https://dev.magicpost.in/mcp/media-attachments.md)
>
> Supported formats, limits, and the complete workflow.

> [card] [Setup Claude Code](https://dev.magicpost.in/mcp/setup-claude-code.md)
>
> Connect with OAuth and attach files from your local workspace.

> [card] [Setup Cursor](https://dev.magicpost.in/mcp/setup-cursor.md)
>
> Same backend, different MCP client.

> [card] [Direct API](https://dev.magicpost.in/api-reference/overview.md)
>
> Use curl or your own scripts.

> [card] [Errors & rate limits](https://dev.magicpost.in/essentials/errors.md)
>
> What to handle, what to retry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.