Qyvo

This page takes you from "no token" to "MCP server is reachable" in three steps. After that, pick a client setup page to plug it into Claude Desktop, Cursor, ChatGPT, or n8n.

1. Generate a token

In Settings → API Tokens, click Create token. Name it after the client you'll connect (e.g. Claude Desktop). Copy the value — Qyvo only shows it for 90 seconds.

The token works for both /api/v1/* and /mcp. See Authentication for the full token model.

2. Verify the handshake

You can call the MCP server directly with curl to confirm it's reachable and your token is accepted. The first message in any MCP session is initialize:

curl -X POST https://www.qyvo.io/mcp \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "curl-smoke", "version": "1" }
    }
  }'

A successful response includes the server name Qyvo, version 1.0.0, and the capabilities (tools, prompts, resources):

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": { "listChanged": false },
      "prompts": { "listChanged": false },
      "resources": { "listChanged": false }
    },
    "serverInfo": { "name": "Qyvo", "version": "1.0.0" }
  }
}

A 401 means the token is wrong. A 404 is a deploy-version issue — open a ticket.

3. List the tools

Same session, follow up with tools/list to confirm the 35 tools are exposed:

curl -X POST https://www.qyvo.io/mcp \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

You'll get back the catalogue with each tool's description, input schema, and IsDestructive / IsReadOnly annotations. See Tools reference: Contacts for the human-readable version.

4. Connect a client

Pick the client you'll be using:

Claude Desktop — drop a JSON config in claude_desktop_config.json
Cursor — Settings → MCP → Add server
ChatGPT — when MCP support ships
n8n — install n8n-nodes-qyvo from the community registry, or wire MCP Client node directly

Troubleshooting

401 Unauthorized — token revoked, expired, or the mcp scope was stripped. Generate a new one.
404 / Personal access client not found — outdated server. Wait for the next deploy.
No workspace context available — the user behind the token has no tenant. Check workspace setup in Settings → Workspace.
Tools listed but send_message returns Meta 132012 / 132001 — the template language doesn't have an APPROVED translation. Open Settings → WhatsApp → Templates and resync.