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

# Setup Guide

> Step-by-step instructions for connecting the Writesonic MCP server to your AI assistant.

## Prerequisites

Before connecting, make sure you have:

1. A Writesonic account with any active **paid plan**
2. At least one project with tracked prompts in your [dashboard](https://app.writesonic.com)

## Claude.ai (Web)

1. Go to **Settings** in Claude.ai
2. Navigate to **MCP Servers** (or **Integrations**)
3. Click **Add MCP Server**
4. Enter the server URL:
   ```
   https://mcp.writesonic.com/mcp
   ```
5. Click **Connect** — you'll be redirected to Writesonic to authorize access
6. Sign in and approve the connection
7. You're ready to query your GEO data

## Claude Desktop

Add the following to your `claude_desktop_config.json`:

<CodeGroup>
  ```json macOS theme={"system"}
  // ~/Library/Application Support/Claude/claude_desktop_config.json
  {
    "mcpServers": {
      "writesonic": {
        "url": "https://mcp.writesonic.com/mcp"
      }
    }
  }
  ```

  ```json Windows theme={"system"}
  // %APPDATA%\Claude\claude_desktop_config.json
  {
    "mcpServers": {
      "writesonic": {
        "url": "https://mcp.writesonic.com/mcp"
      }
    }
  }
  ```
</CodeGroup>

Restart Claude Desktop after saving. On first use, you'll be prompted to authenticate with Writesonic.

## Claude Code (CLI)

Run in your terminal:

```bash theme={"system"}
claude mcp add writesonic --transport streamable-http https://mcp.writesonic.com/mcp
```

On first tool call, Claude Code will open a browser window for OAuth authentication.

## Authentication

The MCP server uses **OAuth 2.0** for authentication. When you first connect:

1. Your client redirects you to the Writesonic login page
2. Sign in with your Writesonic credentials
3. Authorize the MCP integration to access your GEO data
4. You're redirected back — the session is now active

Sessions persist across conversations. You won't need to re-authenticate unless your token expires.

## Verifying the Connection

After setup, try this prompt in Claude:

> "List my Writesonic projects"

Claude should call the `get_all_projects` tool and return your project list. If this works, you're all set.

## Troubleshooting

**"Authentication failed" or redirect loop**

* Make sure you have an active paid plan
* Try disconnecting and reconnecting the MCP server
* Clear browser cookies for writesonic.com and retry

**"No projects found"**

* Verify you have at least one project in your [Writesonic dashboard](https://app.writesonic.com)
* Ensure the project has tracked prompts configured

**Tools not appearing**

* In Claude Desktop, restart the app after editing `claude_desktop_config.json`
* In Claude Code, run `claude mcp list` to verify the server is registered