> ## 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.

# Claude Desktop

> Connect Claude Desktop to MagicPost in 3 steps.

Claude Desktop talks to MCP servers via stdio. Since MagicPost MCP is HTTP,
we use the open-source [`mcp-remote`](https://www.npmjs.com/package/mcp-remote)
bridge to convert stdio ↔ HTTP locally.

## Prerequisites

* macOS, Windows or Linux with Claude Desktop installed
* [Node.js](https://nodejs.org) 18+ available on your PATH (`npx` needs it)
* A MagicPost API key — see [creating a key](https://dev.magicpost.in/essentials/authentication.md#creating-a-token)

## Configure

**1. Locate the config file**

| OS | Path |
| - | - |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Linux | `~/.config/Claude/claude_desktop_config.json` |

**2. Add the MCP server block**

Open the file (create it if missing) and add a `mcpServers` entry:

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

> [!TIP]
>
> When you create the key from
> [Settings → API & MCP](https://app.magicpost.in/account?tab=api-keys),
> the dialog includes a copy-paste-ready version of this exact snippet
> with the token already filled in.

**3. Fully quit and relaunch Claude Desktop**

On macOS, **Cmd+Q** (not just close window). MCP servers are only loaded
at startup.

## Verify

After relaunch, open a new conversation and click the tools indicator in the
input bar. You should see `magicpost` listed with 38 tools available.

Try:

```
List my scheduled posts on MagicPost
```

Claude will call `list_my_posts` and read back what's coming up.

## Troubleshooting

> [accordion] The magicpost server doesn't appear in the tools list
>
> 1. Open the Claude Desktop logs (Preferences → Developer → Open log directory)
> 2. Look for `mcp.log` or `claude_mcp.log`
> 3. Common causes:
>    * JSON syntax error in `claude_desktop_config.json` — validate it with `python -m json.tool claude_desktop_config.json`
>    * `npx` not on PATH — install Node via nvm or homebrew
>    * Network blocked — confirm you can `curl https://mcp.magicpost.in/.well-known/oauth-protected-resource`

> [accordion] Authentication error in the tool response
>
> The PAT is invalid or revoked. Generate a new one from
> [Settings → API & MCP](https://app.magicpost.in/account?tab=api-keys)
> and replace it in the config.

> [accordion] Claude says it cannot reach MagicPost
>
> The MCP bridge might have crashed silently. Restart Claude Desktop. If
> the issue persists, run the bridge manually to see its output:
>
> ```bash theme={null}
> npx -y mcp-remote https://mcp.magicpost.in/mcp \
>   --header "Authorization:Bearer mp_YOUR_TOKEN"
> ```

## Privacy

`mcp-remote` runs on **your machine** and forwards calls to `mcp.magicpost.in`.
Your token never leaves your machine via a third party. The MagicPost MCP
server validates it and acts on your behalf.


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