Client Setup - Postiz Documentation

Claude Desktop

Add the following to your Claude Desktop MCP configuration file:

macOS
Windows

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "postiz": {
      "url": "https://api.postiz.com/mcp/your-api-key"
    }
  }
}

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "postiz": {
      "url": "https://api.postiz.com/mcp/your-api-key"
    }
  }
}

Claude Code

The fastest way is the CLI:

claude mcp add postiz --transport http --url https://api.postiz.com/mcp/your-api-key

Or add it to your Claude Code config directly:

{
  "mcpServers": {
    "postiz": {
      "url": "https://api.postiz.com/mcp/your-api-key"
    }
  }
}

The Bearer-token transport works too, pick whichever your client supports better. Both authenticate the same way:

claude mcp add postiz --transport http \
  --url https://api.postiz.com/mcp \
  --header "Authorization: Bearer your-api-key"

Cursor

In Cursor, go to Settings > MCP and add a new server:

Name: Postiz
Type: HTTP
URL: https://api.postiz.com/mcp/your-api-key

Other MCP Clients

Any MCP-compatible client can connect to Postiz. Use the streamable HTTP transport:

URL: https://api.postiz.com/mcp/your-api-key
Transport: Streamable HTTP

Or, if your client supports Bearer token authentication:

URL: https://api.postiz.com/mcp
Transport: Streamable HTTP
Authorization: Bearer your-api-key

Base URL

Every URL on this page assumes Postiz Cloud. On a self-hosted instance, swap the host: So the endpoint becomes https://your-postiz-server.com/mcp/your-api-key.

Verify Connection

Once connected, ask your AI agent:

“List my connected social media accounts”

If the connection is working, the agent will call the integrationList tool and return your connected accounts.

​Claude Desktop

​Claude Code

​Cursor

​Other MCP Clients

​Base URL

​Verify Connection