Come collegare Payhip a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Payhip.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse