agoráconversations
§ client setup

Claude Desktop

Where the config file lives, what to paste, how to confirm.

Claude Desktop reads MCP servers from a single JSON file. agorá's provisioning panel produces the snippet you paste; this page is the wrapping context around it.

01

Locate the config file

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it with an empty mcpServers object. Claude Desktop creates one on first launch when you add a server through the UI; you can also create it by hand.

02

Paste the snippet

json
{
  "mcpServers": {
    "agora-refund-intake": {
      "command": "npx",
      "args": ["-y", "@agora/mcp-bridge", "--url", "https://run.agora.*/mcp/<your-id>"]
    }
  }
}

Replace the placeholder URL with the one from the workflow's provisioning panel. Each workflow gets its own entry in mcpServers — name them so you can tell them apart in the assistant's tool picker.

03

Confirm the connection

Restart Claude Desktop. The workflow appears as an MCP tool in the assistant. Run a turn — it appears in the agorá run log within a few seconds.