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

## Connection Details

Use the same values in any client:

| Field          | Value                            |
| -------------- | -------------------------------- |
| Name           | Writesonic                       |
| Description    | Writesonic MCP                   |
| Server URL     | `https://mcp.writesonic.com/mcp` |
| Authentication | OAuth                            |

## Claude.ai (Web)

1. Go to **Settings** in Claude.ai
2. Navigate to **Connectors** (under **Customize**)
3. Click **Add custom connector**
4. Enter the name `Writesonic` and the server URL `https://mcp.writesonic.com/mcp`
5. Click **Add**, then **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

<Note>
  On a **Team or Enterprise** plan, only Owners can add custom connectors. See [Organization Setup](#organization-setup) below.
</Note>

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

## ChatGPT

Custom connectors in ChatGPT require **Developer Mode**.

1. Open **Settings > Connectors** (ChatGPT prompts you to enable **Developer Mode** if it isn't already on)
2. Click **Create** to open the new connector dialog
3. Enter:
   * **Name:** `Writesonic`
   * **Description:** `Writesonic MCP`
   * **Server URL:** `https://mcp.writesonic.com/mcp`
   * **Authentication:** OAuth (settings are discovered automatically once a valid URL is entered)
4. Accept the "custom MCP servers introduce risk" notice and click **Create**
5. Click **Connect** and sign in to Writesonic via OAuth

For workspace-wide rollout, see [Organization Setup](#organization-setup).

## Organization Setup

On **Team**, **Enterprise**, and ChatGPT **Business/Enterprise** plans, only Owners and Admins can add custom connectors. Setting one up at the organization level only makes Writesonic **available** to your team — it does not connect anyone automatically.

<Note>
  Each member still connects and authorizes Writesonic individually, signing in through OAuth with their own Writesonic account, before they can query data.
</Note>

### Claude (Owners & Primary Owners)

1. Open **Settings** and go to **Organization settings**
2. In the left sidebar under **Libraries**, select **Connectors**
3. In the top-right, click the **Add** dropdown and choose **Custom**
4. Enter:
   * **Name:** `Writesonic`
   * **Remote MCP server URL:** `https://mcp.writesonic.com/mcp`
5. Leave the **OAuth Client ID** and **OAuth Client Secret** fields (under **Advanced settings**) blank — authorization is handled automatically
6. Click **Add** — Writesonic now appears in your organization's connector list

Each member then enables it under **Settings > Connectors** (**Customize > Connectors**) and clicks **Connect** to authenticate with their own account. See Anthropic's [custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) guide for details.

<Note>
  Owners can also restrict which **desktop extensions** members may install. If the desktop extension allowlist is enabled and Writesonic hasn't been added, members can't install the connector until an Owner adds it under **Organization settings > Connectors > Desktop** (or enables public desktop extensions). See Anthropic's [desktop extension allowlist guide](https://support.claude.com/en/articles/12592343-enabling-and-using-the-desktop-extension-allowlist).
</Note>

### ChatGPT (Workspace Owners & Admins)

Custom connectors require **Developer Mode**. If it isn't on, ChatGPT prompts you to enable it during this flow.

1. Open the ChatGPT **admin panel** and go to **Apps**
2. Click **Create** (top-right) to open the **New App** dialog
3. Fill in:
   * **Name:** `Writesonic`
   * **Description:** `Writesonic MCP`
   * **Connection:** keep **Server URL** selected and enter `https://mcp.writesonic.com/mcp`
   * **Authentication:** leave as **OAuth**
4. Read the risk notice and tick **"I understand and want to continue"**
5. Click **Create** — the app is created as a draft (shown with a **DEV** label)
6. On the draft, click **Publish**, work through both risk reviews until they show **Reviewed**, then click **Publish** again
7. Writesonic moves into your **Enabled apps** list

Publishing makes Writesonic available to everyone in your workspace, but each user still connects and authorizes it individually via OAuth.

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

> "List my Writesonic projects"

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

## FAQ

<AccordionGroup>
  <Accordion title="Do I need a paid plan?">
    Yes. The MCP server requires an active Writesonic paid plan and at least one project with tracked prompts in your [dashboard](https://app.writesonic.com).
  </Accordion>

  <Accordion title="Does adding the connector for my organization connect everyone automatically?">
    No. Organization or workspace setup only makes Writesonic *available*. Each member still connects and authorizes individually, signing in via OAuth with their own Writesonic account.
  </Accordion>

  <Accordion title="I don't see the option to add a custom connector">
    On Team/Enterprise (Claude) and Business/Enterprise (ChatGPT), only Owners and Admins can add custom connectors. In ChatGPT, make sure **Developer Mode** is enabled. Otherwise ask an organization Owner to add Writesonic — see [Organization Setup](#organization-setup).
  </Accordion>

  <Accordion title="Authentication failed or redirect loop">
    * Make sure you have an active paid plan
    * Disconnect and reconnect the connector
    * Clear browser cookies for writesonic.com and retry
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>