Como Conectar o Cursor e Claude Desktop ao QuickerSpot via MCP

O que é o Model Context Protocol (MCP)?

O Model Context Protocol é o padrão aberto mantido pela comunidade e pela Anthropic que conecta modelos de linguagem (LLMs) a ferramentas externas e serviços de dados em tempo real. Com o servidor MCP do QuickerSpot, seu assistente deixa de apenas escrever texto e passa a **gerar o áudio comercial pronto para execução nas lojas**.

Passo 1: Gerando sua API Key no QuickerSpot

Para garantir segurança e isolamento de dados Multi-Tenant, todas as chamadas M2M executam sob o contexto da sua conta:

1. Acesse o dashboard em /settings.
2. Clique no botão "Criar Nova API Key".
3. Dê um nome identificador à sua chave (ex: Cursor Mac ou Claude Desktop).
4. Copie o token qs_live_... exibido no modal. Por motivos de segurança, ele é armazenado com hash SHA-256 no banco e só é exibido uma vez!

Passo 2: Configurando no Cursor IDE ou Claude Desktop

Adicione o snippet abaixo no seu arquivo de configuração mcp.json:

{
  "mcpServers": {
    "quickerspot": {
      "command": "python",
      "args": ["mcp-server/src/server.py"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}

Passo 3: Configurando para Agentes Autônomos (Hermes, OpenClaw)

Para agentes autônomos que consomem prompts de sistema, você pode copiar o bloco de instruções para que o agente saiba quando invocar cada ferramenta:

You have access to the QuickerSpot MCP Server tools:
- list_voices(): Catalog of ElevenLabs voice talents.
- create_campaign(name, free_text, voice_id): Creates a new radio commercial (PENDING).
- approve_script(campaign_id, script): Approves script and renders ElevenLabs V3 audio.
- get_campaign_status(campaign_id): Retrieves the finished MP3 audio URL.
- create_recado(text, voice_id): Instant audio notice with PA chime.

Catálogo de Ferramentas Expostas

Perguntas Frequentes (FAQ)