← Back to Quallaa

Install Quallaa as an MCP server

Quallaa is reachable as a Model Context Protocol server. Connect it to Claude Desktop, Cursor, Windsurf, Cline, or any other MCP client and Quallaa shows up alongside your other tools — same agent, same memory, same conversation as the web and SMS surfaces.

You're not signed in, so the snippets below show a placeholder api key. Sign in to see your real key inline. If you don't have a Quallaa account yet, talk to Quallaa first at /quallaa.

Server endpoint

Quallaa runs as a remote MCP server over Streamable HTTP. There's nothing to install locally — clients connect by URL.

https://www.quallaa.com/api/mcp

Auth: Authorization: Bearer <YOUR_QUALLAA_API_KEY>

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config) and add the Quallaa entry under mcpServers. Restart Claude Desktop.

Config location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "quallaa": {
      "url": "https://www.quallaa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_QUALLAA_API_KEY>"
      }
    }
  }
}

Cursor

Open Cursor settings → Features → MCP → Add new MCP server. Paste the JSON below or fill the form fields manually.

Config location: Cursor Settings → MCP

{
  "name": "quallaa",
  "url": "https://www.quallaa.com/api/mcp",
  "headers": {
    "Authorization": "Bearer <YOUR_QUALLAA_API_KEY>"
  }
}

Windsurf

Open Windsurf settings → Cascade → MCP servers → Edit config. Add the entry below.

Config location: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "quallaa": {
      "serverUrl": "https://www.quallaa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_QUALLAA_API_KEY>"
      }
    }
  }
}

Cline (VS Code)

Open Cline → Settings (gear icon) → MCP Servers → Edit configuration. Add the entry below.

Config location: VS Code → Cline → MCP Servers

{
  "mcpServers": {
    "quallaa": {
      "url": "https://www.quallaa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_QUALLAA_API_KEY>"
      }
    }
  }
}

ChatGPT (Developer mode)

In a custom GPT or the new Agents builder, enable Developer mode and add an MCP server. Use the URL and Bearer header below.

Config location: ChatGPT → Custom GPT → Configure → Developer mode

URL:    https://www.quallaa.com/api/mcp
Header: Authorization: Bearer <YOUR_QUALLAA_API_KEY>

What Quallaa exposes

  • talk_to_quallaa — open conversation with the trust layer agent. Same memory and signal log as the web and SMS surfaces. Use this for guidance, capability authorization, and team escalation.
  • list_conversations, get_conversation, list_escalations, resolve_escalation, get_contact_profile, get_business_profile, get_agent_status — read-side tools for inspecting your customer-facing AI deployment.
  • update_instructions, update_tool_config, update_business_info, send_message, schedule_followup — write-side tools for changing your deployment's configuration and behavior.

Trouble?

If the client says "authentication failed," double-check that the key is on the same line as Bearer and that you restarted the client after editing the config. If a tool call returns an error, paste the error into /quallaa and Quallaa will help you sort it out.