Black Friday20% off ProPlans →
Back to docs
Step 11 of 13Pro

Set up Claude Desktop

Claude Desktop reaches DocxToWP through a small helper, mcp-remote, that it starts for you. Set it up once and use it from any chat.

Before you start

  • DocxToWP Pro 1.6.0 or later, with your licence active.
  • The Claude Desktop app for Windows or Mac. (This is not the same as Claude in a web browser, which is not supported yet.)
  • Node.js 18 or later: run node -v in a terminal to check, or install it from nodejs.org.
  • In WordPress, DocxToWP Pro → AI Agents: the connection switched on and a key created. See Connect an AI agent.

1. Open the config file

In Claude Desktop, open Settings → Developer → Edit Config. This opens claude_desktop_config.json in a text editor.

2. Add DocxToWP

Paste the snippet from DocxToWP Pro → AI Agents → Connect apps → Claude Desktop, which has your Server URL and key filled in. It looks like this:

{
  "mcpServers": {
    "docxtowp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-site.com/wp-json/docxtowp/v1/mcp",
        "--header",
        "X-API-Key:dwpk_…"
      ]
    }
  }
}

If the file already lists other servers under mcpServers, add only the "docxtowp" part, separated from the others by a comma. The key is sent as X-API-Key here on purpose: it has no space in it, which avoids a known problem with spaces in arguments on Windows.

3. Restart Claude Desktop

Quit Claude Desktop completely (on Windows, also from the tray icon) and open it again. In a new chat, the tools menu should list docxtowp with four tools.

4. Ask for a post

Paste a prompt from the Prompt library, such as FAQ Content Creator, or ask in your own words. When Claude asks to use a DocxToWP tool, click Allow. It replies with an edit link and a preview link for the new draft.

If something goes wrong

  • DocxToWP does not appear: check node -v shows 18 or later, then read the log, on Windows %APPDATA%\Claude\logs\mcp-server-docxtowp.log, on a Mac ~/Library/Logs/Claude/.
  • The config does not load: it must be valid JSON. A missing comma between two servers is the usual cause.
  • More messages and fixes: Connect an AI agent → If it does not connect.

Disconnect

Remove the "docxtowp" entry from the config file, restart Claude Desktop, and revoke the key in DocxToWP Pro → AI Agents → Keys.

Still stuck? Email support@docxtowp.com and we will walk you through it.