English Français العربية

QuickerSpot MCP Server

السجل الرسمي أخرى

Servidor MCP do QuickerSpot para vinhetas, rádio indoor e sonorização comercial com IA.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع QuickerSpot MCP Server؟

  • list_voices() — Retorna o catálogo de vozes comerciais disponíveis (Camila, Helena, Marcos, Carlos, Ricardo).
  • create_campaign(name, data, voice_tone, free_text) — Cria uma nova campanha comercial e gera o roteiro síncrono via IA.
  • approve_script(campaign_id, script, background_music) — Aprova o roteiro e dispara a síntese de voz pura em estúdio.
  • remix_campaign_audio(campaign_id, background_music, audio_style) — Aplica ou substitui a trilha sonora de fundo e masterização sem custo adicional de síntese de voz (TTS).
  • get_campaign_status(campaign_id) — Consulta o status (PENDING, PROCESSING, COMPLETED), roteiro e URLs de download dos MP3s.
  • list_campaigns() — Lista todas as campanhas ativas da sua conta.
  • create_recado(text, voice_id) — Gera áudio instantâneo de recado/aviso para loja com vinheta (fast-lane sem fluxo HITL).

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package quickerspot-mcp
Claude Code 
claude mcp add quickerspot-mcp-server -e 'QUICKERSPOT_API_KEY=<your quickerspot_api_key>' -e 'QUICKERSPOT_API_URL=https://voz-comercial-backend-bvbcktwqoq-uc.a.run.app' -- uvx quickerspot-mcp==0.1.7
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "quickerspot-mcp-server": {
            "command": "uvx",
            "args": [
                "quickerspot-mcp==0.1.7"
            ],
            "env": {
                "QUICKERSPOT_API_KEY": "<your quickerspot_api_key>",
                "QUICKERSPOT_API_URL": "https://voz-comercial-backend-bvbcktwqoq-uc.a.run.app"
            }
        }
    }
}

متغيرات البيئة

  • QUICKERSPOT_API_KEY إلزامي سري API Key M2M gerada no painel do QuickerSpot (/settings)
  • QUICKERSPOT_API_URL URL do backend do QuickerSpot em produção

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Servidor MCP QuickerSpot
  2. 🚀 Como Usar em 2 Passos
  3. 🛠️ Ferramentas MCP Disponíveis (tools)
  4. 💻 Execução com Python Local (Opcional)

mcp-name: io.github.raphaelInacio/quickerspot-mcp

Servidor MCP QuickerSpot

Servidor oficial Model Context Protocol (MCP) para a plataforma QuickerSpot — Automação de vinhetas, rádio indoor e sonorização comercial com IA.

Conecte seus Assistentes de IA (Cursor IDE, Claude Desktop, Antigravity, Hermes Agent, OpenClaw) diretamente ao motor de voz ElevenLabs V3, gerador de roteiros por IA e mixer de rádio indoor do QuickerSpot.

🚀 Como Usar em 2 Passos

1. Obter sua API Key

Acesse o painel do QuickerSpot em quickerspot.com/settings e crie uma nova API Key (ex: qs_live_...).

2. Configurar o mcp.json

Adicione a definição do servidor no seu arquivo mcp.json (ou claude_desktop_config.json):

{
  "mcpServers": {
    "quickerspot": {
      "command": "uvx",
      "args": ["quickerspot-mcp"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}

O quickerspot-mcp conecta-se automaticamente ao backend de produção do QuickerSpot. Se você estiver desenvolvendo localmente, pode adicionar "QUICKERSPOT_API_URL": "http://localhost:8000" no bloco env.

🛠️ Ferramentas MCP Disponíveis (tools)

  1. list_voices() — Retorna o catálogo de vozes comerciais disponíveis (Camila, Helena, Marcos, Carlos, Ricardo).
  2. create_campaign(name, data, voice_tone, free_text) — Cria uma nova campanha comercial e gera o roteiro síncrono via IA.
  3. approve_script(campaign_id, script, background_music) — Aprova o roteiro e dispara a síntese de voz pura em estúdio.
  4. remix_campaign_audio(campaign_id, background_music, audio_style) — Aplica ou substitui a trilha sonora de fundo e masterização sem custo adicional de síntese de voz (TTS).
  5. get_campaign_status(campaign_id) — Consulta o status (PENDING, PROCESSING, COMPLETED), roteiro e URLs de download dos MP3s.
  6. list_campaigns() — Lista todas as campanhas ativas da sua conta.
  7. create_recado(text, voice_id) — Gera áudio instantâneo de recado/aviso para loja com vinheta (fast-lane sem fluxo HITL).

💻 Execução com Python Local (Opcional)

Se preferir rodar localmente com Python:

{
  "mcpServers": {
    "quickerspot": {
      "command": "python",
      "args": ["-m", "quickerspot_mcp.server"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}

الأسئلة الشائعة

ما هو QuickerSpot MCP Server؟

Servidor MCP do QuickerSpot para vinhetas, rádio indoor e sonorização comercial com IA.

كيف أثبّت QuickerSpot MCP Server؟

يعمل على جهازك. في Claude Code: claude mcp add quickerspot-mcp-server -e 'QUICKERSPOT_API_KEY=<your quickerspot_api_key>' -e 'QUICKERSPOT_API_URL=https://voz-comercial-backend-bvbcktwqoq-uc.a.run.app' -- uvx quickerspot-mcp==0.1.7. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج QuickerSpot MCP Server إلى مفتاح API؟

نعم. يتطلب QUICKERSPOT_API_KEY، وتضبطها في إعداداته.

هل QuickerSpot MCP Server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون QuickerSpot MCP Server؟

ينشره raphaelInacio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.