Come collegare Gumroad a Cursor via MCP

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

Gumroad + Cursor

Fai leggere alla tua AI il tuo negozio Gumroad: prodotti, vendite con filtri, iscritti alle membership, codici sconto, campi del checkout, chiavi di licenza e webhook. Dopo la tua conferma può pubblicare o ritirare un prodotto e creare un codice sconto. I rimborsi sono disattivati. Token di accesso dalla tua applicazione Gumroad.

Prerequisiti

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

GUMROAD_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti e ti serve solo il tuo account Gumroad.

1. Accedi a Gumroad e apri Settings → Advanced → Applications.
2. Crea un'applicazione: un nome qualsiasi e un indirizzo https qualsiasi come redirect URI (il connettore non lo usa). Fai clic su Create application.
3. Sulla nuova applicazione fai clic su Generate access token e copia il token in GUMROAD_ACCESS_TOKEN, senza la parola Bearer.
4. Installa il connettore ed esegui gumroad_get_user: mostra l'account a cui appartiene il token.

Tieni il token riservato: un token Gumroad ha tutti i permessi che Gumroad offre, rimborsi compresi, e chi lo possiede può gestire il tuo negozio. Il connettore usa solo ciò che serve ai suoi tool. Per revocare l'accesso elimina l'applicazione o genera un nuovo token.

Cosa legge: i tuoi prodotti con prezzo, valuta, stato di pubblicazione, dettagli della membership, tag, numero di vendite e ricavi; un singolo prodotto con descrizione, varianti e opzioni; le vendite, dalla più recente, filtrate per data, prodotto, e-mail o nome dell'acquirente, numero d'ordine o chiave di licenza, ognuna con prezzo, commissione Gumroad, quantità, varianti, codice sconto, stato di rimborso e contestazione; gli iscritti a una membership con stato (attivo, disdetta in corso, pagamento non riuscito, disdetto) e relative date; i codici sconto e quante volte sono stati usati; i campi aggiuntivi che un prodotto chiede al checkout; le chiavi di licenza; e i webhook configurati per il tuo account.

Ricavi su un periodo: Gumroad restituisce 10 vendite per pagina, quindi per un mese o un anno l'AI scorre tutte le vendite, le somma e ti dice quante ne ha contate. Gli importi sono in centesimi della valuta del prodotto e le date in UTC.

Le verifiche di licenza non consumano attivazioni: gumroad_verify_license ti dice se una chiave è valida per un prodotto, quante volte è stata usata e a quale acquisto appartiene, senza contare un utilizzo (a meno che tu non lo chieda). Un 404 significa che la chiave non esiste per quel prodotto, è disattivata o l'acquisto ha perso l'accesso.

Chiede prima di ogni modifica: gumroad_enable_product mette subito in vendita un prodotto, gumroad_disable_product lo ritira dalla vendita (chi l'ha già comprato mantiene l'accesso) e gumroad_create_offer_code crea un codice sconto che i clienti possono usare subito. Prima di ognuno l'AI ti mostra il prodotto, oppure il codice con sconto e limiti, e aspetta il tuo sì.

Disattivato all'installazione: gumroad_refund_sale. I rimborsi restituiscono denaro all'acquirente e non si possono annullare. Un amministratore lo attiva consapevolmente; l'AI ti mostra poi la vendita, l'acquirente e l'importo e rimborsa solo dopo la tua conferma. Nessun tool elimina prodotti, codici sconto o campi aggiuntivi.

Dati dei clienti: vendite e iscritti contengono indirizzi e-mail, nomi e chiavi di licenza degli acquirenti. L'AI legge solo ciò che serve alla tua domanda e non li copia altrove.

Errori comuni: 401 significa che il token è errato o che l'applicazione è stata eliminata; genera un nuovo token. "Not found" significa che Gumroad non conosce quell'id di prodotto, vendita o iscritto.

Il connettore non crea, modifica né elimina prodotti, varianti o file, non segna vendite come spedite, non revoca accessi, non reinvia ricevute, non gestisce pagamenti o moduli fiscali, non invia e-mail né gestisce workflow e non crea né elimina webhook.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Gumroad.

Tool disponibili

Esempi di prompt

• "Quante vendite ho fatto il mese scorso, e quanto ha incassato ciascun prodotto?"
• "Quali iscritti alla mia membership hanno disdetto o hanno un pagamento non riuscito questo mese?"
• "Questa chiave di licenza è valida per Plugin Pro, e quante volte è stata usata? Non contare la verifica come utilizzo."
• "Crea per il Notion Template Pack un codice sconto BLACKFRIDAY del 20%, limitato a 100 utilizzi. Mostrami prima i dettagli."
• "Ritira dalla vendita il mio vecchio corso del 2024, così nessuno può più comprarlo."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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