Remote MCP per i pagamenti
zahls.ch espone l’API REST come tool MCP. Collega Cursor, Claude o framework di agenti — crea link di pagamento, genera fatture, verifica lo stato. Senza un backend proprio in mezzo.
Collegato in pochi minuti
Bastano un endpoint e due header. Chiave API e nome istanza li trovi nella dashboard sotto API e integrazioni.
- Endpoint
- https://www.zahls.ch/mcp
- Header
- X-API-KEY, X-Instance
Esempio (Cursor / JSON MCP)
{
"mcpServers": {
"zahls-ch": {
"url": "https://www.zahls.ch/mcp",
"headers": {
"X-API-KEY": "DEIN_API_SCHLUESSEL",
"X-Instance": "deine-instanz"
}
}
}
}Sostituisci i placeholder, ricarica il client — fatto.
Cosa possono fare i tool
Link di pagamento
Crea, condividi e gestisci link — una tantum o per abbonamenti.
Fatture e donazioni
Crea fatture formali e moduli di donazione direttamente dall’agente.
Stato e rimborsi
Interroga le transazioni e avvia rimborsi.
Funziona con il tuo client
Qualsiasi client con remote MCP (HTTP) e header personalizzati.
Cursor
Config MCP di progetto o utente — i tool compaiono nell’elenco.
Claude
I client remote MCP con header custom usano lo stesso endpoint.
OpenClaw
Gateway open source per agenti: registra zahls.ch come server MCP.
Hermes
Hermes Agent con client MCP nativo — tool come capability di prima classe.
Casi d’uso tipici
Creare e inviare un link di pagamento in una chat di supporto
Generare una fattura o un link di donazione per una campagna
Verificare lo stato prima dell’azione successiva dell’agente
Creare un abbonamento o preparare un rimborso
MCP + webhook
MCP è adatto ad azioni sincrone (creare, interrogare). Per eventi asincroni all’arrivo di un pagamento configura anche i webhook — si completano a vicenda.
Webhook nella guidaUso sicuro
- Chiave API dedicata al client MCP — da ruotare se serve
- Mai chiavi in prompt o repo pubblici
- Limita azioni critiche (importi alti, rimborsi) nel prompt
Pronto per la prima chiamata MCP?
Crea un account, genera una chiave API, collega il client — senza costi di attivazione.