Setup Guide

Connect your AI to your FluentCart store in about five minutes. Most of that is waiting for npm.

Five minutes. Generate a password in WordPress, paste a config snippet into your AI client, done. Three paths depending on how much you enjoy terminals.

Generate an Application Password

Every setup path needs this. It's how the MCP server authenticates with your store — no actual login password involved.

Go to WordPress admin → Users → Profile

Scroll down to the Application Passwords section. Type a name — FluentCart MCP works — and click Add New Application Password.

Copy the password immediately

It looks like this: aBcD eFgH iJkL mNoP qRsT uVwX

One Chance

WordPress shows this password exactly once. Close the page without copying and you'll need to generate a new one.

Have your three values ready

Value	Example
WordPress URL	`https://your-store.com`
Username	`admin`
Application Password	`aBcD eFgH iJkL mNoP qRsT uVwX`

The URL is the root of your site — no trailing slash, no /wp-admin/, no /wp-json/. The username is your WordPress login name, not your display name.

Use an Admin Account

The MCP server needs admin-level access. A limited role (Editor, Subscriber) will get 403 errors on nearly everything.

Pick Your Path

Three ways to connect, from easiest to most manual.

No terminal. No JSON. No Node.js. Download a file, double-click it, fill in three fields.

1. Download fluentcart-mcp.mcpb from the latest release.

2. Double-click the file. Claude Desktop picks it up automatically. Or drag it into the app, or go to Settings → Extensions → Install Extension.

3. Enter your credentials — WordPress URL, username, and Application Password.

4. Open a new chat and try: "Show me today's orders"

See store data? Done.

Claude Desktop Only

The extension only works with Claude Desktop. For other AI clients, use the Setup Wizard or Manual Config tabs.

A guided terminal walkthrough. Asks three questions, tests the connection, saves the config.

Requires Node.js 22+

Check with node --version. Don't have it? Grab it from nodejs.org.

Run this:

npx fluentcart-mcp setup

It looks like this:

┌  fluentcart-mcp setup
│
◇  WordPress URL
│  https://your-store.com
│
◇  WordPress username
│  admin
│
◇  Application Password
│  ••••••••••••••••••••••••
│
◇  Connected to Your Store Name
│
◇  Config written to ~/.config/fluentcart-mcp/config.json
│
└  You're all set. Run fluentcart-mcp to start the server.

If the credentials are wrong, it tells you why and offers to retry. If they work, it saves a config file at ~/.config/fluentcart-mcp/config.json. After that, your AI client configs don't need credentials at all — the MCP server reads them from the saved file.

Then configure your AI client using the simplified snippet (no env vars needed):

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"]
    }
  }
}

Where to paste this depends on your client — see the Manual Config tab for the exact location.

Full control. You'll need Node.js 22+ installed (node --version to check — grab it from nodejs.org if needed).

Pick your AI client below:

Prefer the Easy Way?

The Claude Desktop Extension tab above does this without any JSON editing.

Open the config file:

macOS: Claude menu → Settings → Developer → Edit Config
Windows: File → Settings → Developer → Edit Config

Or find it manually at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Paste this (replace with your actual values):

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://your-store.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "aBcD eFgH iJkL mNoP qRsT uVwX"
      }
    }
  }
}

Restart Claude Desktop completely (quit and reopen, not just close the window). Look for the hammer icon in the chat input.

Already Have Other MCP Servers?

Don't replace the whole file. Add "fluentcart": {...} inside your existing mcpServers object.

One command:

claude mcp add fluentcart \
  -e FLUENTCART_URL=https://your-store.com \
  -e FLUENTCART_USERNAME=admin \
  -e FLUENTCART_APP_PASSWORD="aBcD eFgH iJkL mNoP qRsT uVwX" \
  -- npx -y fluentcart-mcp

Start a new session and ask about your store. Verify with claude mcp list.

Settings → Cursor Settings → MCP → Add new global MCP server. This opens mcp.json.

Paste this:

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://your-store.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "aBcD eFgH iJkL mNoP qRsT uVwX"
      }
    }
  }
}

Save. Back in Settings → MCP, fluentcart should show a green dot. Red means something's wrong — click it for the error.

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://your-store.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "aBcD eFgH iJkL mNoP qRsT uVwX"
      }
    }
  }
}

Switch to Agent mode in Copilot Chat using the mode selector at the top. Regular Chat mode doesn't use MCP servers — that's Microsoft's design choice.

Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → search "Open MCP Config". This opens mcp_config.json.

Paste this:

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://your-store.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "aBcD eFgH iJkL mNoP qRsT uVwX"
      }
    }
  }
}

Save. Windsurf picks up the change automatically.

Add to ~/.codex/config.json:

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://your-store.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "aBcD eFgH iJkL mNoP qRsT uVwX"
      }
    }
  }
}

Start a Codex session and ask about your store.

For a persistent endpoint that remote clients (ChatGPT, custom agents, other machines) can reach. No Node.js needed.

docker run -d \
  -p 3000:3000 \
  -e FLUENTCART_URL=https://your-store.com \
  -e FLUENTCART_USERNAME=admin \
  -e FLUENTCART_APP_PASSWORD="aBcD eFgH iJkL mNoP qRsT uVwX" \
  -e FLUENTCART_MCP_API_KEY=pick-a-strong-secret \
  --name fluentcart-mcp \
  vcodesh/fluentcart-mcp

Your endpoint is at http://localhost:3000/mcp. Verify with curl http://localhost:3000/health.

For remote access, put it behind a reverse proxy or Cloudflare Tunnel — the Deployment Guide covers the details.

Set FLUENTCART_MCP_API_KEY

Without it, anyone who finds your URL gets full access to your store. Set the key.

Multiple Stores

Managing more than one store? Create separate MCP server entries:

{
  "mcpServers": {
    "store-production": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://shop.example.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "xxxx xxxx xxxx xxxx"
      }
    },
    "store-staging": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"],
      "env": {
        "FLUENTCART_URL": "https://staging.example.com",
        "FLUENTCART_USERNAME": "admin",
        "FLUENTCART_APP_PASSWORD": "yyyy yyyy yyyy yyyy"
      }
    }
  }
}

Tell the AI which store you mean: "Check orders on production" or "Create a test product on staging."

Test the Connection

Ask your AI:

"Show me the FluentCart dashboard stats"

See store data? You're done. If not, head to Troubleshooting.

Generate an Application Password

Pick Your Path

Multiple Stores

Test the Connection

Next Steps

Usage & Examples

Tool Reference

On this page