How to set up the NerdPress Guided Agent Connector

The NerdPress Guided Agent Connector lets an AI assistant (or “agent”) work on your WordPress site: read your content, draft and edit posts, tidy up media, check settings — whatever you allow it to do. You decide what it can do, you can see everything it did, and you can undo some of it.

This page covers connecting Claude and ChatGPT to WordPress, but the steps are similar for most agents:

  1. Install our Agent Connector plugin on your site.
  2. Add a custom connector to your agent/assistant.
  3. Approve the connection in your own WordPress admin.

A “connector” may also be called an “MCP” or “plugin,” and an “agent” may also be called an “AI assistant.”

Not all AI plans allow custom connectors, so if you get stuck on Step 2, please let us know.

Step 1 — Install the Agent Connector plugin

  1. Download the plugin: NerdPress Guided Agent Connector (.zip)
  2. In your WordPress Admin, go to Plugins → Add New Plugin → Upload Plugin.
  3. Choose the .zip file, click Install Now, then Activate Plugin.

From that point on the plugin can be updated the same way your other plugins are.

Step 2 — Add your site as a custom connector in your assistant

These steps may vary depending on which AI agent you’re using, but the overall idea is the same on all of them: you’ll add a custom “Connector” or “MCP” or “Plugin” and click through to authorize the connection.

You’ll need the connector address, customized with your domain. 👇

👉 Replace example.com with your site’s domain:

https://support-mcp.nerdpress.net/mcp/example.com

Follow the instructions for your agent:

Claude

  1. Open Settings → Connectors (or Customize → Connectors).
  2. Click Add → Add custom connector (on Team and Enterprise plans, an owner needs to add it).
  3. Give it a name you’ll recognize — something like “My WordPress site, via NerdPress”.
  4. Paste the connector address, remembering to customize it with your domain: https://support-mcp.nerdpress.net/mcp/example.com
  5. Leave any advanced fields empty or at their defaults. Click Add.
  6. Click Connect.
Claude's "Add custom connector" dialog. The name field reads "My Website Connector" and the server address field below it contains https://support-mcp.nerdpress.net/mcp/example.com, with Cancel and Continue buttons at the bottom.

In a new chat, use the + button in the message box → Connectors to make sure your site is switched on for that conversation.

ChatGPT

1. In the sidebar, go to Plugins ( https://chatgpt.com/plugins )

    "Plugins" should be shown below New Chat, Scheduled, and Library.

    2. Click Add ➡ Create Custom MCP Server

      The Add button is in the top right corner

      (Exactly where this lives in your settings may depend on whether you’re on the website or in the apps.)

      3. Enter the Custom MCP Server information:

      The modal to add a Custom MCP Connector
      • Name — Something like “My WordPress site, via NerdPress”
      • Description — optional, but may we suggest: “NerdPress Guided Agent Connector”
      • Connection — the connector server URL, remembering to customize it with your domain:
        https://support-mcp.nerdpress.net/mcp/example.com
      • Authentication — OAuth (default)
      • Check the box next to “I understand and want to continue” then click Create as a plugin. 🎉

      4. You should then see this message. Click Continue, and move on to Step 3 below.

      Modal showing a warning and a Continue button.

        👆 Not seeing Plugins? You may need to turn on “developer mode.” Check in Settings → Security and login, and toggle Developer mode on.
        (Depending on your account it may live under Settings → Security and login, or, on a Business or Enterprise workspace, under Workspace settings → Permissions & roles.)

        Use these Hubbub Pro Action Buttons to connect your agent:

        Once connected, your AI agent can help you configure your Hubbub Pro Action Buttons. Oh, the serendipitous alignment!

        Or give your agent this prompt and it will walk you through the setup:

        I want to connect my WordPress site to the NerdPress Guided Agent Connector, which is a remote MCP server. First, ask me for my website's domain. Take just the bare domain (no https://, no trailing slash) and put it into this URL in place of example.com: https://support-mcp.nerdpress.net/mcp/example.com Then show me the finished URL and give me step-by-step instructions for adding it as a custom connector in the app I'm using right now. Ask me which app and plan I'm on if you're not sure. Tell me what to expect when I sign in to approve the connection. Don't try to connect it yourself.

        Step 3 — Approve the connection on your site

        Adding the connector, clicking Connect, or starting a new chat should start an approval process that requires you to sign in.

        A NerdPress page opens in your browser with your domain already filled in. Confirm your domain is correct, then click Continue to my site.

        The NerdPress consent screen, headed "NerdPress Guided Agent Connector" with the line "Claude wants to work on your WordPress site". A field labeled "Your site" holds the site's web address, above a "Continue to my site" button and a note that the next step is approving the connection on your own site.
        1. You’ll be redirected back to your site, to a page titled Authorize NerdPress Guided Agent Connector. From there you can choose what the assistant may do. The recommended permissions are already chosen for you: it can read your site and edit some of its content, and it cannot delete things, activate or deactivate plugins, switch themes, or update WordPress. Open Adjust permissions to change any of that.
        2. Check the box to agree to the connector terms.
        3. Click Approve to finish.
        The authorization screen inside WordPress admin, where the NerdPress Guided Agent Connector requests permission to act on the site. Three numbered markers highlight, in order, the "Adjust permissions" button, the checkbox agreeing to the NerdPress Guided Agent Connector Terms, and the Approve button, with a Deny button beside it.

        (The assistant never gets your WordPress username, and this doesn’t use application passwords.)

        You can always adjust a connection’s permissions at Settings → Guided Agent Connector.

        Step 4 — Check your connection

        Ask your agent for something harmless and specific, like “What WordPress version is my site domain-name.com running?” or “List my five most recent posts.” If you get real answers about your site, you’re connected. We’re happy to confirm it from our side too — just ask!

        In ChatGPT, you may need to tell it to use your new plugin.

        • Click the + or type an @ sign and you can select it from the drop-down.
        • In “Work” mode, you can also click the Plugins button.

        If you already have other connectors set up for your WordPress site, you may want to disable them while you’re using the NerdPress Guided Agent Connector, to avoid confusing your assistant.

        If you’ve created any Skills that reference those connectors, they may also need to be updated to reference this new connector instead.


        Questions we’ve been asked

        I’ve installed the plugin. Where do I find it, and what do I do next?

        Installing the plugin is the first step. Then, add our Connector in your AI app and approve it on your site (Steps 2 and 3 above). After that, our Connector “lives” inside your AI app. Start a new chat and ask for something, and you should see your agent say it’s using the NerdPress Connector. Not sure what to ask? Try “What can you do on my site?” Your agent will tell you.

        I’ve never used an AI agent before. Where do I start?

        You’ll need your own AI app, such as Claude or ChatGPT, usually on a paid plan that allows custom connectors. Connecting it to your site takes a few clicks with the steps on this page. After that, just start asking questions! Your agent and our Connector’s guidance will help you along, and our support team is here if you get stuck.

        Do I have to prompt my agent to use the NerdPress Connector?

        Not usually. Most agents use our Connector on their own when a request involves your site. If yours seems confused or answers without checking your site, say “use the NerdPress Guided Agent Connector” in your request.

        Can I connect both ChatGPT and Claude to my site?

        Yes! Each AI app you use can have its own connection and its own approval on your site, and there’s no limit on how many you connect. Add one connector per site, each with that site’s domain in the URL, and give them names you can tell apart. Each assistant you connect gets its own connection and its own approval, so Claude and ChatGPT are recorded separately in your activity log and can be revoked one at a time. It’s very likely that you’ll end up with multiple connections as AI agents and MCP connections become more popular.

        Can I try it on a staging site first?

        Yes, and it’s a good way to get comfortable with our Connector. Add a second connector using your staging domain instead of your live one, and give it whatever permissions you like. Your staging connector address will look something like https://support-mcp.nerdpress.net/mcp/staging.example.com/, depending on your host. On BigScoots, for example, it would be https://support-mcp.nerdpress.net/mcp/examplecom.bigscoots-staging.com/. Once your agent knows which site is staging, you can ask it to test changes there before touching your live site.

        Where can I see what my agent did?

        In your WordPress admin, go to Settings → Guided Agent Connector → Activity, or use the NerdPress menu → Guided Agent Connector Activity. The activity log shows every change an agent made, which agent made it, and who approved the connection. Where a change can be reversed, there’s an Undo button.

        How do I manage the connection?

        Everything lives under Settings → Guided Agent Connector in your WordPress Admin:

        Connected agents shows every assistant you’ve connected, what each one is allowed to do, and is where you’ll find the Disconnect button. Agent Activity tracks every change an agent made, what it was asked to do, who authorized the connection, and includes Undo for changes that can be reversed. Some changes are held for your approval before they happen. When that occurs, the assistant is told it’s waiting and will give you a link to an approval page in your WordPress dashboard.

        How do I change permissions or disconnect an agent later?

        Go to Settings → Guided Agent Connector. You’ll see every connected agent and what each one is allowed to do. You can change permissions or disconnect at any time, and changes take effect immediately. Disconnecting one agent doesn’t affect the others, and its activity history stays.

        Can I give my agent my own guidelines, like brand voice or what my site is about?

        Yes, but give them to your agent, not our Connector. NerdPress writes our Connector’s guidance, and it doesn’t learn from your site. Your agent can hold onto anything you give it: brand guidelines, your site’s history, who your readers are, what you’re trying to do. Most AI apps have projects or memory for this. The more context it has, the better its suggestions get. Here are a couple of helpful articles about memory in two of the leading apps:
        • Claude’s article on memory
        • ChatGPT’s article on memory

        Do you have sample prompts?

        We’re building a prompt library, but you can ask an agent to do just about anything with your website. For now, here are some ideas from our team:
        • Add “Ask me any questions before you start” to your request. Your agent will check with you before it makes choices, instead of guessing.
        • Start with a wish: “I wish I could…” plus the site chore you keep putting off.

        Tip: Unless you have multiple sites connected through the Agent Connector, you won’t need to reference your domain name over and over. After a few times your agent will remember your site name.

        You can also ask other clients how they’re using it in the NerdPress Facebook group.

        What kinds of things can I ask it to do?

        If you can do it in WordPress, and you’ve given your agent permission, it can probably do it.

        Things clients and the team have done so far:
        • Find old posts worth updating and what’s missing from them
        • Add missing meta descriptions and alt text
        • Merge duplicate tags and clean up categories
        • Catch recipe measurement mistakes or missing information
        • Move old FAQ sections into Yoast FAQ blocks
        • Add a synced pattern to every post in a category
        • Build a landing page or link-in-bio page that matches your site’s style
        • Migrate content from one plugin to another
        • Build out a landing page from a draft you wrote elsewhere, like a Google Doc

        Which AI app and model should I use?

        The model matters more than the app. Most AI apps let you choose between models, and the newer, more capable ones make fewer mistakes (or they’re supposed to). Use the most capable one your plan includes. NerdPress uses Claude, but ChatGPT works well too. If you already use one and like it, stick with it.

        What’s a “model”?

        A model is the program behind your AI app: It’s been trained on a large amount of text to recognize patterns and answer questions. Most AI apps offer several models that differ in speed, what tasks they’re best at performing, and how well they answer. Examples include Anthropic’s Haiku, Sonnet, Opus, and Fable and OpenAI’s ChatGPT Luna, Sol, and Astra (These are listed in order of increasing capabilities, but also increasing cost).


        Questions? Want us to set this up for you? Email support@nerdpress.net.