Connect Claude Desktop

Claude Desktop supports MCP servers natively. After this setup, the Qyvo tools appear in the tool picker and Claude can drive your workspace directly.

1. Generate a Qyvo token

If you haven't already, follow MCP Quickstart.

2. Edit the config file

Open claude_desktop_config.json:

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

Add a qyvo entry under mcpServers:

{
  "mcpServers": {
    "qyvo": {
      "transport": {
        "type": "http",
        "url": "https://www.qyvo.io/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

If you already have other MCP servers configured, add qyvo alongside them — same mcpServers map, no need to nest.

3. Restart Claude Desktop

Fully quit and reopen Claude Desktop. The first request bootstraps the connection — you'll see a small status indicator at the bottom of the input pane while it initializes.

4. Verify the connection

Open a new conversation and click the tools picker. The Qyvo tools should be listed (35 of them, grouped by name). If they aren't, see Troubleshooting below.

Try a simple read first:

List my five most-engaged contacts in the last 30 days.

Claude will call list_contacts (or compose list_contacts + get_analytics) and answer.

5. Auto-approve the safe tools

Claude Desktop honors the IsReadOnly / IsIdempotent annotations the Qyvo server ships. Read-only tools (list_*, get_*) auto-approve by default. Write tools (create_*, send_message, trigger_*) prompt for approval per call — that's the safe default. You can grant per-tool always-allow in the dialog.

Troubleshooting

• No tools show up — Claude Desktop's settings → MCP servers panel will show the connection state. A red dot means the handshake failed; check the token, then check ~/Library/Logs/Claude/mcp-server-qyvo.log (macOS) for the exact error.
• "Bad Request" on every call — your token is missing the mcp scope. Generate a new token from the dashboard; the new ones include it by default.
• Tools work, but sends fail — check Settings → WhatsApp → Templates in Qyvo. The template you're trying to send must be APPROVED for the language you pass.

Security notes

• The config file lives in plaintext on disk. Treat it like an SSH key — don't sync it to a non-encrypted backup, don't paste it in screenshots.
• One token per Claude install, per machine. If you switch laptops, generate a new token; revoke the old one when you're done.