Skip to main content

​
Integrating MCP clients

Use this page to connect the WoopSocial MCP server to a client that supports streamable HTTP MCP.

​
Prerequisites

  • A WoopSocial account
  • Access to the client you want to configure

​
Claude Code CLI

Use the claude mcp add command to register WoopSocial with Claude Code. 
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"
  1. Ensure that you have a WoopSocial account and you are logged in
  2. Start claude
  3. In Claude, type /mcp
  4. Select the woopsocial · △ needs authentication menu item
  5. Select Authenticate
  6. This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
  7. Return to Claude
  8. Ask Claude to do something with the MCP. For example tell it to “List my social accounts in woopsocial”

​
Get your MCP URL

Claude Code above used our OAuth-based MCP authentication but this is not yet compatible with all AI agents. In such cases, please follow the procedure below which will generate an MCP URL for you backed by an API key.
  1. Open the WoopSocial dashboard API page.
  2. Click on the “Create API key” button.
  3. Give the key a name so you can identify it later.
Name the API key
  1. Copy the MCP URL from the key details page.
Copy the MCP URL from the API key details page The MCP URL uses this format: 
https://api.woopsocial.com/mcp?api_key=YOUR_API_KEY

​
Codex CLI

Use the codex mcp add command to register WoopSocial with Codex. 
codex mcp add woopsocial --url "https://api.woopsocial.com/mcp?api_key=YOUR_API_KEY"

​
Claude Desktop

  1. Open Claude settings.
Open Claude settings
  1. Open the Connectors tab.
Open the Connectors tab in Claude
  1. Select Add custom connector.
Add a custom connector in Claude
  1. Enter a connector name and paste the MCP URL.
Enter the connector name and MCP URL
  1. Save the connector.
  2. Test the connection by asking Claude to list your social accounts.
Test the Claude connector by listing social accounts If Claude blocks media uploads, add *.cloudflarestorage.com to the allowlist in its settings.

​
ChatGPT

  1. Open Settings.
Open ChatGPT settings
  1. Open Apps.
  2. Enable Developer Mode if it is not already enabled.
Enable Developer Mode in ChatGPT
  1. Select Create App.
  2. Enter these values:
  • Name: WoopSocial
  • Description: Publish social media content
  • MCP Server URL: paste the MCP URL you copied earlier
  • Authentication: No Auth
Create the WoopSocial app in ChatGPT
  1. Save the app.
  2. Start a new chat and test the connection by asking ChatGPT to list your social accounts.
Test the ChatGPT app by listing social accounts

​
Note

If the client has an allowlist for outbound domains, add *.cloudflarestorage.com so media uploads work.