Come collegare GoAffPro a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → GoAffPro, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

GoAffPro + Gemini

Gestisci il tuo programma di affiliazione GoAffPro dalla tua AI: trova gli affiliati e i loro codici, guarda ordini, premi e traffico che portano, quanto devi loro e quanto hai già pagato, e con conferma approva affiliati e commissioni, assegna premi e registra i pagamenti.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GOAFFPRO_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti e serve l'accesso admin all'app di affiliazione GoAffPro del tuo negozio.

1. Accedi all'admin di GoAffPro del negozio, dall'app in Shopify, WooCommerce o nell'altra piattaforma del negozio, oppure su https://app.goaffpro.com.
2. Apri Settings → Advanced → API Keys e genera un access token.
3. Incollalo in GOAFFPRO_ACCESS_TOKEN e installa il connettore. Il token viene inviato solo a GoAffPro.

Cosa copre: affiliati con i loro codici referral, coupon e struttura delle commissioni; gruppi di affiliati (livelli); gli ordini attribuiti agli affiliati con commissione e stato di approvazione; premi come bonus di iscrizione, di reclutamento e al raggiungimento degli obiettivi; il registro di ogni accredito e addebito; quanto spetta oggi a ciascun affiliato, i pagamenti già fatti e le richieste di pagamento inviate dagli affiliati; e il traffico che gli affiliati portano al negozio.

Conferma prima: le scritture cambiano quanto guadagnano e vedono gli affiliati. L'AI indica l'affiliato e l'importo o lo stato e aspetta il tuo sì. Può creare affiliati, approvarli o rifiutarli, cambiarne la percentuale di commissione, il coupon o il codice referral, assegnare coupon, attribuire un ordine sfuggito al tracciamento, approvare o rifiutare una commissione, assegnare un premio, registrare un pagamento e aggiornare una richiesta di pagamento. goaffpro_record_payout registra soltanto un pagamento fatto altrove, per esempio con bonifico o PayPal: non invia mai denaro. goaffpro_delete_affiliate e goaffpro_delete_order sono disattivati all'installazione; rifiutare un affiliato o un ordine ne conserva lo storico.

Campi: la maggior parte degli elenchi restituisce solo i campi richiesti. Il connettore chiede un insieme predefinito utile, e l'AI ne chiede altri quando la domanda lo richiede.

Privacy: affiliati, ordini e traffico contengono nomi, indirizzi e-mail, dati di pagamento e IP dei visitatori. L'AI chiede solo i campi che servono alla domanda.

Errori comuni: 403 x-goaffpro-access-token missing from the headers: GoAffPro risponde così anche con un token sbagliato o eliminato; generane uno nuovo in Settings → Advanced → API Keys. 400 o un testo error: manca un parametro obbligatorio o un valore non è valido.

Il connettore non sposta affiliati nelle strutture multilivello, non modifica gruppi, commissioni speciali, materiali promozionali o la configurazione del negozio, non gestisce webhook e non usa gli endpoint lato affiliato.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di GoAffPro.

Tool disponibili

Esempi di prompt

• "Quali 10 affiliati hanno portato più fatturato da ordini approvati il mese scorso?"
• "Quanto dobbiamo a ciascun affiliato in questo momento? Ordina per importo."
• "Mostrami gli affiliati iscritti questa settimana ancora in attesa di approvazione, poi approva quelli che scelgo."
• "Registra un pagamento PayPal di 250 EUR a [email protected] per settembre."
• "Assegna a Marco un bonus di 50 EUR per aver raggiunto l'obiettivo di ottobre."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT