Come collegare Playtomic a Claude via MCP

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

Playtomic + Claude

Accesso completo a Playtomic per chi gioca a padel, tennis e calcetto: cerca circoli e disponibilità, trova partite aperte a cui unirti, leggi il tuo profilo, livello, statistiche, storico e consigli. 13 strumenti, accesso con email e password e rinnovo automatico del JWT.

Prerequisiti

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

PLAYTOMIC_EMAIL, PLAYTOMIC_PASSWORD

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti e ti servono solo email e password del tuo account Playtomic.

1. Inserisci la tua email Playtomic in PLAYTOMIC_EMAIL e la password in PLAYTOMIC_PASSWORD. Entrambe vengono salvate cifrate.
2. Installa il connettore. AnythingMCP accede a Playtomic al posto tuo e ottiene un token valido circa un'ora; lo rinnova un minuto prima della scadenza e ogni volta che Playtomic risponde 401.
3. Esegui playtomic_get_my_profile: mostra il tuo nome e la tua email. Poi chiedi il tuo livello, che playtomic_get_my_level legge per ogni sport.

Su AnythingMCP Cloud le chiamate passano da un proxy: Playtomic rifiuta le richieste che arrivano da indirizzi IP di data center (il login risponde 403 con una pagina web). Per questo ogni chiamata di questo connettore, login compreso, passa dal proxy dei connettori, che su AnythingMCP Cloud è già configurato per te e conta nella quota oraria di proxy del tuo workspace. In self-hosting da una connessione di casa o d'ufficio funziona direttamente; da un server in un data center imposta CONNECTOR_PROXY_URL. Il proxy termina il TLS, quindi la tua email e la tua password Playtomic passano attraverso di esso per arrivare a Playtomic.

Cosa legge: i circoli vicino a un luogo, con i loro campi, indirizzo e fuso orario; gli slot liberi di ogni campo in un giorno, con durata e prezzo (sconti soci del tuo account inclusi); le partite aperte che cercano giocatori in un intervallo di date, e i dettagli di una partita; le partite che Playtomic ti consiglia al tuo livello vicino a un punto; tornei e leghe; il tuo profilo, il tuo livello per sport (di solito da 0 a 7, con la sua affidabilità e, se vuoi, lo storico), i tuoi risultati totali (giocate, vinte, perse, pareggiate) e i circoli dove giochi più spesso.

Leggere i campi liberi: gli orari sono nel fuso orario del circolo. Lo stesso orario di inizio può comparire con 60, 90 e 120 minuti: sono prenotazioni alternative dello stesso slot, non campi liberi in più. I prezzi arrivano come testo, per esempio 48 EUR. Nome del campo, coperto o all'aperto, singolo o doppio e tipo di pareti (wall, crystal, panoramic) vengono dai dettagli del circolo.

Solo lettura, nulla da confermare: tutti i 13 strumenti leggono soltanto, e nessuno è disattivato all'installazione. Prenotare o pagare un campo, unirsi a una partita o crearne una e accettare richieste di partecipazione resta nell'app Playtomic.

Playtomic Lite: se ti servono solo la ricerca dei circoli e i campi liberi, il connettore più leggero Playtomic Lite ha solo i 4 strumenti per circoli e disponibilità.

Non è un'API pubblica documentata: il connettore usa l'API con cui lavora l'app Playtomic. Playtomic non la documenta e può cambiarla senza preavviso; se uno strumento smette di funzionare, controlla se c'è un aggiornamento del connettore.

Limiti: Playtomic non pubblica limiti di richieste, quindi l'AI resta su circa una richiesta al secondo. Una lista di consigli vuota è normale e vuol dire solo che al momento non ce ne sono.

Errori comuni: due 401 di fila significano che email o password sono sbagliate. Un 403 con una pagina web al posto dei dati significa che la chiamata è partita da un data center senza proxy.

Il connettore non prenota né cancella campi, non entra, crea o lascia partite, non accetta richieste di partecipazione, non paga e non scrive ad altri giocatori.

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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Playtomic, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Trovami un campo da padel libero domani sera tra le 19 e le 21 vicino a Milano Porta Romana, per 90 minuti, e dimmi quanto costa."
• "Ci sono partite di padel aperte al mio livello questo weekend vicino a Roma Eur in cui manca ancora qualcuno?"
• "Qual è il mio livello di padel su Playtomic adesso, com'è cambiato ultimamente e quante partite ho vinto e perso?"
• "Sabato mattina c'è un campo da tennis coperto libero nel circolo dove gioco più spesso?"
• "Quali tornei o leghe di padel iniziano il mese prossimo vicino a Torino, e quali sono adatti al mio livello?"

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

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