Come collegare Payhip a Gemini via MCP

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

Payhip + Gemini

Gestisci i codici coupon del tuo negozio Payhip e verifica le license key del tuo software da un agente AI: elenca e leggi i coupon, creane di nuovi con la tua approvazione, verifica la license key di un acquirente e, se lo consenti, disattivala, riattivala o conta le sue attivazioni.

Prerequisiti

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

PAYHIP_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti servono un negozio Payhip e la sua chiave API. Per le license key ti serve anche un prodotto con le license key attive.

1. In Payhip apri Settings → Developer e copia la API key.
2. Incolla solo la chiave in PAYHIP_API_KEY. La usano gli strumenti per i coupon.
3. Facoltativo, per le license key: apri il prodotto in Payhip, spunta Generate unique license keys se non è già attivo, e copia la product secret key che compare sotto quella casella in PAYHIP_PRODUCT_SECRET_KEY.
4. Installa il connettore ed esegui payhip_list_coupons: elenca i tuoi codici coupon e conferma che la chiave API funziona. Se hai impostato una product secret key, esegui payhip_verify_license con la chiave ricevuta da un tuo acquirente per controllare anche le licenze.

Un prodotto con licenza per installazione: una product secret key appartiene a un solo prodotto. Per verificare le chiavi di più prodotti, installa il connettore una volta per prodotto e dai a ogni installazione il nome del prodotto. I coupon funzionano in ogni installazione, perché usano la chiave API del negozio.

Cosa legge: i codici coupon del negozio con codice, tipo (un prodotto, tutti i prodotti o una collezione), sconto in percentuale o importo, date di inizio e fine, acquisto minimo, limite di utilizzo e note; e, per il prodotto configurato, lo stato di una license key: se è attiva, l'email dell'acquirente, prodotto e variante, quante volte è stata usata e quando è stata emessa.

Solo coupon e license key: oggi l'API di Payhip copre solo queste due aree. Prodotti, vendite, clienti e pagamenti non sono disponibili tramite l'API.

Come leggere i dati: gli importi (sconto fisso, acquisto minimo) sono in centesimi, lo sconto percentuale è una percentuale. Una risposta vuota da payhip_verify_license significa che la chiave non esiste per questo prodotto. Payhip disattiva una chiave in automatico quando l'acquisto viene rimborsato. Gli utilizzi di una chiave sono un contatore che il tuo software alza e abbassa; Payhip non impone limiti, li impone il tuo software.

Disattivati all'installazione: payhip_create_coupon, payhip_disable_license, payhip_enable_license, payhip_increase_license_usage e payhip_decrease_license_usage. Un nuovo coupon vale al checkout appena esiste, e una chiave disattivata lascia l'acquirente fuori dal tuo software finché non viene riattivata. I prodotti in abbonamento non possono ricevere coupon tramite l'API. Un amministratore attiva quelli che ti servono.

Chiede prima di ogni modifica: con uno strumento di scrittura attivo, l'AI ti mostra il codice, lo sconto e a cosa si applica, oppure la license key e cosa le succederà, e aspetta il tuo sì.

Limiti: gli elenchi dei coupon arrivano in pagine da massimo 100, quindi con un negozio grande l'AI li scorre a pagine invece di chiedere tutto insieme.

Errori comuni: 401 authentication_fail significa che la chiave API o la product secret key è sbagliata o manca: copia di nuovo PAYHIP_API_KEY da Settings → Developer e, per gli strumenti sulle licenze, controlla PAYHIP_PRODUCT_SECRET_KEY nella pagina del prodotto. Il firewall di Payhip mette alla prova le chiamate sui coupon che arrivano da indirizzi di data center, perciò queste passano dal proxy in uscita di AnythingMCP dove è configurato (come su AnythingMCP Cloud). Su un server self-hosted senza CONNECTOR_PROXY_URL le chiamate sui coupon possono rispondere 403 con una pagina HTML.

Il connettore non legge prodotti, vendite, clienti o pagamenti, e non emette rimborsi né nuove license key.

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 Payhip.

Tool disponibili

Esempi di prompt

• "La license key 7XK2-9QPL-44MZ-H1TR è valida? Chi l'ha comprata e quante volte è stata usata?"
• "Elenca i nostri codici coupon con lo sconto di ciascuno e dimmi quali scadono questo mese."
• "Quali sono le condizioni del coupon ESTATE25: acquisto minimo, limite di utilizzo e a quale prodotto si applica?"
• "Un acquirente dice che la sua chiave ha smesso di funzionare dopo un rimborso. Controlla se è ancora attiva e a quale email è associata."
• "Quali dei nostri coupon valgono per tutti i prodotti e quali solo per un prodotto o una collezione?"

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot