Connect Claude Desktop to your markets

Claude Desktop is a free app from Anthropic. Once you connect it to Convene, you can run your markets by chatting with Claude — no more clicking through admin pages.

Before you start

• Download Claude Desktop (Mac or Windows).
• Have your API key ready — see Create your API key if you haven't made one yet.

Step 1: Open Claude's settings file

In Claude Desktop, open Settings → Developer → Edit Config. This opens a file called claude_desktop_config.json.

📸 Screenshot: Claude Desktop Settings → Developer

Step 2: Add Convene

Paste this in, replacing YOUR_TOKEN_HERE with your actual key (the one that starts with fm_org_):

{
  "mcpServers": {
    "convene": {
      "url": "https://app.convene.markets/admin/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

If you already have other MCP servers configured, just add the "convene": { ... } block inside the existing "mcpServers" object.

Step 3: Restart Claude Desktop

Fully quit Claude Desktop and reopen it. Look for the small tools icon (🔧) at the bottom of the chat window — Convene should appear in the list.

Step 4: Try a prompt

Start a new chat and ask Claude something like:

• "Give me a summary of my Convene dashboard."
• "What applications are pending?"
• "Approve order 12345."
• "Send a payment reminder to anyone who hasn't paid for this Saturday."

Claude will ask your permission before doing anything that changes data — like approving an order or sending an email. You stay in control.

Troubleshooting

• "Convene" doesn't show up in Claude: Make sure you fully quit and reopened Claude Desktop. Check that your config file is valid JSON (no trailing commas, matching braces).
• Claude says it can't connect: Double-check your token was copied correctly — it should start with fm_org_ and be one long unbroken string.
• "Unauthorized": Your key may have been revoked. Visit /admin/api_keys to verify it's still Active, or create a new one.