Skip to Main
schemawp
Back to docs

Connecting your AI agent

After installing and activating the Plugin, the MCP server is on by default on your site. The next step is to connect your site to your agent/AI client.

In the Settings page of the plugin, click How to Connect to see setup instructions for each client. Below are the steps for the most common ones.

Claude (chat)

  1. Go to Settings → Connectors → Add Custom Connector
  2. Name it anything (e.g. “ACSS MCP”)
  3. Paste your Server URL into the Remote MCP Server URL field
  4. Authorize access on your WordPress site
  5. Done — no Application Password needed

ChatGPT

  1. Go to Settings → Apps → Advanced Settings and enable Developer mode
  2. Click Create app, name it anything
  3. Paste your Server URL into the MCP Server URL field
  4. Set authentication to OAuth
  5. In Advanced Settings, set registration to Dynamic Client Registration (DCR)
  6. Accept terms and create the app
  7. Authorize access on your WordPress site
  8. Done

Cursor / Windsurf

1. Create a WordPress Application Password: Users → Profile → Application Passwords.

2. Open Terminal (macOS/Linux) or Git Bash (Windows), then run this command (replace the placeholders) and copy the output:

echo -n "username:xxxx xxxx xxxx xxxx" | base64

3. Open MCP settings:

  • Cursor: Settings → Tools & Integrations → MCP Servers
  • Windsurf: Settings → Cascade → Model Context Protocol

Paste this config (replace placeholders):

{
  "mcpServers": {
    "scwp-acss-mcp": {
      "type": "http",
      "url": "<https://yoursite.com/wp-json/scwp-acss-mcp/v1/mcp>",
      "headers": {
        "Authorization": "Basic <your-base64-string>"
      }
    }
  }
}

4. Replace <your-base64-string> with the output you copied from the terminal command.

Claude Code

1 . Create a WordPress Application Password: Users → Profile → Application Passwords.

2. Open Terminal, then run this command (replace the placeholders) and copy the output:

echo -n "username:xxxx xxxx xxxx xxxx" | base64

3. Add this to ~/.claude.json (replace placeholders):

{
  "mcpServers": {
    "scwp-acss-mcp": {
      "type": "http",
      "url": "<https://yoursite.com/wp-json/scwp-acss-mcp/v1/mcp>",
      "headers": {
        "Authorization": "Basic <your-base64-string>"
      }
    }
  }
}

4. Replace <your-base64-string> with the output you copied from the terminal command.

5. Restart Claude Code.

Verifying the connection

Once connected, ask your agent:

“What ACSS tools do you have access to?”

Or

Give me a summary of the the ACSS schema at my website

The agent should be able to fetch the live data from the connected site.

Happy prompting!