Servidor MCP

O que é o servidor MCP do SocialGO?

O servidor MCP do SocialGO expõe o painel como um conjunto de ferramentas para agentes de IA via Model Context Protocol. Uma vez conectado, um assistente pode navegar pelo catálogo de serviços, criar e acompanhar pedidos, solicitar refills e gerenciar o saldo, sem nenhum código de integração personalizado. É uma camada fina de leitura e ação sobre a mesma API que o seu dashboard usa, então os agentes ficam dentro dos limites e preços da sua conta.

Funciona com qualquer cliente compatível com MCP, incluindo Claude Desktop, Claude Code, Cursor e seus próprios agentes construídos sobre um SDK do MCP.

Adicione ao seu cliente

O servidor é distribuído como o pacote @socialgo/mcp e roda via stdio com npx, então não há nada para instalar ou auto-hospedar. Adicione a seguinte entrada à configuração do seu cliente MCP:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Com o Claude Code você pode registrá-lo em um único comando a partir do seu terminal:

claude mcp add socialgo -- npx @socialgo/mcp

Depois de adicioná-lo, lembre-se de definir SOCIALGO_API_KEY no ambiente para que o comando acima consiga lê-la.

Autenticação

O servidor lê uma única variável de ambiente, SOCIALGO_API_KEY. Gere uma chave nas configurações da sua conta, mantenha-a em segredo e nunca a commite no controle de versão. Toda chamada de ferramenta é autenticada e autorizada com essa chave, e os pedidos são cobrados do saldo da conta correspondente. Rotacione a chave pelo dashboard a qualquer momento para revogar o acesso.

Ferramentas principais

O servidor mantém uma superfície de ferramentas pequena e estável que cobre todo o ciclo de vida do pedido:

• search_services — Encontre serviços por plataforma, tipo ou palavra-chave. É o ponto de entrada de todo fluxo de trabalho.
• get_service — Obtenha os detalhes completos de um serviço: tarifa, quantidade mínima/máxima e opções suportadas.
• create_order — Crie um pedido para um serviço contra um link ou nome de usuário de destino.
• order_status — Consulte o status ao vivo, o progresso e a quantidade restante de um pedido.
• balance — Leia o saldo atual da conta e a moeda.
• refill — Solicite um refill em um pedido elegível que caiu abaixo da quantidade entregue.
• cancel — Cancele um pedido que ainda seja cancelável e recupere os fundos restantes.
• list_orders — Navegue pelos pedidos recentes com o status atual de cada um.
• add_funds — Crie uma intenção de recarga para adicionar saldo à conta.

O design "buscar-e-agir"

Um painel SMM típico carrega milhares de serviços em dezenas de plataformas. Registrar uma ferramenta por serviço inundaria a lista de ferramentas do agente, estouraria a janela de contexto e deixaria o modelo mais lento e menos preciso. O SocialGO evita isso completamente.

Em vez disso, o catálogo vive atrás de uma única ferramenta de descoberta. O agente primeiro chama search_services para reduzir milhares de opções a um punhado de resultados relevantes, inspeciona um com get_service e só então age com create_order. As mesmas nove ferramentas cobrem todo o catálogo por maior que ele fique, então adicionar novos serviços no backend nunca altera a superfície de ferramentas que o agente vê.

Um fluxo completo se parece com isto:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Isso mantém a lista de ferramentas mínima e previsível, permite que o catálogo escale para milhares de serviços e dá ao agente um passo confiável de confirmação antes de gastar, toda vez.