Server MCP

Cos'è il server MCP di SocialGO?

Il server MCP di SocialGO espone il pannello come un set di strumenti per gli agenti IA tramite il Model Context Protocol. Una volta collegato, un assistente può sfogliare il catalogo dei servizi, creare e monitorare ordini, richiedere ricariche e gestire il saldo, senza alcun codice di integrazione personalizzato. È un sottile livello di lettura e azione sopra la stessa API usata dalla tua dashboard, così gli agenti restano entro i limiti e i prezzi del tuo account.

Funziona con qualsiasi client compatibile con MCP, inclusi Claude Desktop, Claude Code, Cursor e i tuoi agenti basati su un SDK MCP.

Aggiungilo al tuo client

Il server viene distribuito come pacchetto @socialgo/mcp e gira su stdio tramite npx, quindi non c'è nulla da installare o ospitare in autonomia. Aggiungi la seguente voce alla configurazione del tuo client MCP:

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

Con Claude Code puoi registrarlo con un singolo comando dal terminale:

claude mcp add socialgo -- npx @socialgo/mcp

Dopo averlo aggiunto, ricordati di impostare SOCIALGO_API_KEY nell'ambiente affinché il comando qui sopra possa rilevarla.

Autenticazione

Il server legge una singola variabile d'ambiente, SOCIALGO_API_KEY. Genera una chiave dalle impostazioni del tuo account, mantienila segreta e non committarla mai nel version control. Ogni chiamata agli strumenti viene autenticata e autorizzata con questa chiave, e gli ordini vengono addebitati sul saldo dell'account corrispondente. Ruota la chiave dalla tua dashboard in qualsiasi momento per revocare l'accesso.

Strumenti principali

Il server mantiene una superficie di strumenti ridotta e stabile che copre l'intero ciclo di vita dell'ordine:

• search_services — Trova i servizi per piattaforma, tipo o parola chiave: il punto di partenza di ogni flusso di lavoro.
• get_service — Recupera tutti i dettagli di un servizio: tariffa, quantità min/max e opzioni supportate.
• create_order — Crea un ordine per un servizio verso un link o un nome utente di destinazione.
• order_status — Controlla lo stato in tempo reale, l'avanzamento e la quantità residua di un ordine.
• balance — Leggi il saldo attuale dell'account e la valuta.
• refill — Richiedi una ricarica su un ordine idoneo sceso al di sotto della quantità consegnata.
• cancel — Annulla un ordine ancora annullabile e recupera i fondi residui.
• list_orders — Sfoglia gli ordini recenti con il loro stato attuale.
• add_funds — Crea un'intenzione di ricarica per aggiungere saldo all'account.

Il design "cerca-poi-agisci"

Un tipico pannello SMM offre migliaia di servizi su decine di piattaforme. Registrare uno strumento per servizio inonderebbe l'elenco di strumenti dell'agente, farebbe esplodere la finestra di contesto e renderebbe il modello più lento e meno preciso. SocialGO evita del tutto questo problema.

Il catalogo vive invece dietro un unico strumento di ricerca. L'agente chiama prima search_services per restringere migliaia di opzioni a una manciata di risultati pertinenti, ne esamina uno con get_service e solo allora agisce con create_order. Gli stessi nove strumenti coprono l'intero catalogo per quanto cresca: aggiungere nuovi servizi sul backend non cambia mai la superficie di strumenti vista dall'agente.

Un flusso completo si presenta così:

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

Questo mantiene l'elenco di strumenti minimo e prevedibile, consente al catalogo di scalare fino a migliaia di servizi e offre all'agente un affidabile passaggio di conferma prima della spesa, ogni volta.