Skip to main content

​
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

​
Connection Details

Use the same values in any client:
FieldValue
NameWritesonic
DescriptionWritesonic MCP
Server URLhttps://mcp.writesonic.com/mcp
AuthenticationOAuth

​
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
On a Team or Enterprise plan, only Owners can add custom connectors. See Organization Setup below.

​
Claude Desktop

Add the following to your claude_desktop_config.json: 
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "writesonic": {
      "url": "https://mcp.writesonic.com/mcp"
    }
  }
}
Restart Claude Desktop after saving. On first use, you’ll be prompted to authenticate with Writesonic.

​
Claude Code (CLI)

Run in your terminal: 
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

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.
Each member still connects and authorizes Writesonic individually, signing in through OAuth with their own Writesonic account, before they can query data.

​
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 guide for details.
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.

​
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

Yes. The MCP server requires an active Writesonic paid plan and at least one project with tracked prompts in your dashboard.
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.
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.
  • Make sure you have an active paid plan
  • Disconnect and reconnect the connector
  • Clear browser cookies for writesonic.com and retry
  • Verify you have at least one project in your Writesonic dashboard
  • Ensure the project has tracked prompts configured
  • 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