Connect an assistant (MCP)

Connect Wonda to ChatGPT

Add Wonda as a custom MCP server in ChatGPT so it can act through your social personas.

What you get

ChatGPT gets Wonda's tools: running searches and reading inboxes, profiles, feeds and analytics across LinkedIn, Sales Navigator, X and Reddit, plus approved writes such as messaging, connecting, commenting, posting and running bounded campaigns.

Every action runs in the Wonda browser on your computer, signed in as you. Join, then download the Wonda app from your account, sign in, and keep it running. You do not need the Wonda CLI or an API key pasted into ChatGPT.

Turn on Developer mode first

Open Settings, then Security and login, and enable Developer mode.

Developer mode needs a Business, Enterprise or Edu plan on ChatGPT web, and a workspace admin turns it on (Enterprise and Edu can scope it per user). Consumer Plus and Pro do not have it, so on those plans you cannot add a server here. Use Claude or Codex instead, or call the API directly.

Do this before anything else: the Plugins page has no way to add a server until Developer mode is on.

Add the server

Go to chatgpt.com/plugins and:

  1. Click + and name it Wonda.

  2. Set Connection to Server URL and paste this into the URL field:

    text
    https://api.wondercat.ai/mcp

  3. Leave Authentication on OAuth, tick I understand and want to continue, and create it.

  4. ChatGPT asks you to sign in to Wonda and approve access. Done once, works forever.

Your Wonda API key stays inside Wonda and is never shown to ChatGPT. The grant is OAuth against the Wonda MCP resource at https://api.wondercat.ai/.well-known/oauth-protected-resource/mcp.

Verify

Ask ChatGPT:

text
Use Wonda to tell me which personas I have.

If it lists your personas, the connector works. If it reports none, ask ChatGPT to sign you in to LinkedIn, X or Reddit: it opens the Wonda browser on your screen at the platform's login page and you sign in yourself. See Personas and Sessions.

Where actions run

ChatGPT cannot load a local MCP server, so the connector itself runs on Wonda's servers. The actions do not: the connector calls the same action endpoints as the CLI and the API, and they run in the Wonda Automation Browser on your computer, through the Wonda app, from your own connection. If the app is not running, the action returns an error instead of running.

Approvals

Read tools are labelled safe to allow broadly. Write tools request server-side write slots and should stay ask-first unless you want a hands-off loop.

The approval setting in ChatGPT is a client-side prompt. Wonda still enforces the action gate, write-slot allowance, daily caps, cooldowns, account status, and safety checks server-side, so allowing a tool does not raise those limits.

Team and Enterprise

An admin enables Developer mode and may need to approve the server before members can use it. Add Wonda once, complete the OAuth grant, and approve it for the workspace.

The OAuth grant binds your Wonda account, not an organization: the consent screen has no organization chooser, and the connector does not send the X-Wonda-Org header that selects an organization seat, entitlement, or wallet. Actions therefore run against your personal context. Use the CLI or the web app when work must be billed to an organization.