Documentation menu

Connect Claude Desktop

Claude Desktop reaches a remote MCP server through the mcp-remote bridge, which needs Node.js installed.

  1. In WordPress, create an agent and copy its token (Install).
  2. In Claude Desktop, open Settings → Developer → Edit Config.
  3. Add Agent Warden under mcpServers, with your site address and token:
json
{
  "mcpServers": {
    "agentwarden": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://example.com/wp-json/agentwarden/mcp", "--header", "Authorization:${AGENTWARDEN_AUTH}"],
      "env": { "AGENTWARDEN_AUTH": "Bearer <YOUR_TOKEN>" }
    }
  }
}
  1. Restart Claude Desktop. Agent Warden's tools appear in the tools menu: only the abilities the agent's policy allows or holds.

The token is passed through an environment variable, so it does not appear in the process list.

Check it works#

Ask Claude to list your recent posts. The request appears in Agent Warden → Activity within a few seconds. Then ask it to do something the policy does not allow. It is refused with a readable reason, and the refusal is logged.