Collega il tuo assistente AI a Squish

Cosa può fare il tuo assistente

Due tipi di chiave:

• Lettura. I tuoi domini, record DNS, hosting e stato del sito, caselle e migrazioni, ticket di assistenza, ordini, i listini prezzi pubblici e l'intero set di diagnostica (DNS, WHOIS, SSL, autenticazione email, header di sicurezza, uptime, controlli blacklist).
• Lettura e scrittura. Tutto quanto sopra, più modifiche singole: un record DNS alla volta, rinnovo automatico attivo o disattivo, inoltro del dominio, indirizzo di fatturazione e telefono, note su un ticket di assistenza. Ogni scrittura avviene in due passaggi: l'assistente chiede un'anteprima, poi la applica. Per creare una chiave di lettura e scrittura serve l'autenticazione a due fattori sul tuo accesso.

A una chiave o connessione di lettura e scrittura puoi anche permettere di acquistare domini: può pagare un dominio che ha preparato, con la tua carta salvata, entro limiti per acquisto e giornalieri che imposti tu ($100 e $250 se non li cambi, al massimo $500 e $1,000). Disattivato finché non lo scegli tu, e ogni acquisto ti viene comunicato via email.

Cosa nessuna chiave può fare, con qualsiasi ambito: annullare l'hosting, cambiare i nameserver o richiedere un codice di trasferimento, avviare o confermare una migrazione email, cambiare l'email dell'account, fare modifiche DNS in blocco o attivare il permesso dell'assistente. Queste azioni restano a una persona, nella dashboard.

Configurazione

Il modo rapido: accedi e di' all'assistente Squish “configura MCP”. Ti spiega i due ambiti, crea la chiave con te, te la mostra una sola volta in chat e ti dà la riga qui sotto con la chiave già inserita.

Il modo manuale: prima attiva Consenti all'assistente di agire sul mio account nella tua dashboard. Le chiavi usano lo stesso permesso, e non puoi crearne una finché è disattivato. Poi crea una chiave nella riga Assistenti collegati e aggiungi il server al tuo client.

Claude Code

claude mcp add --transport http squish https://api.squish.co/mcp \
  --header "Authorization: Bearer sq_mcp_…"

Claude desktop e claude.ai: nessuna chiave necessaria. Aggiungi https://api.squish.co/mcp come connettore personalizzato (Impostazioni → Connettori → Aggiungi connettore personalizzato), accedi a Squish nella finestra che si apre, scegli lettura o lettura e scrittura, e approva. La connessione compare in Assistenti collegati come una chiave e si revoca allo stesso modo.

ChatGPT: anche qui nessuna chiave, ma un percorso diverso. Sul web, apri chatgpt.com/plugins, seleziona +, poi Add custom MCP server, incolla https://api.squish.co/mcp come URL del server, scegli OAuth, spunta l'avviso sui rischi e seleziona Create as a plugin. Accedi a Squish e approva come sopra. In una chat, digita @ e scegli Squish. OpenAI offre i server MCP personalizzati sui workspace Business ed Enterprise/Edu, solo sul web; se nel menu + non c'è questa voce, il tuo piano non la include, e la strada è una chiave con un altro client. Anche Claude Code accetta questo percorso: claude mcp add --transport http squish https://api.squish.co/mcp senza header, poi /mcp per accedere.

Cursor e altri client: aggiungi un server MCP remoto con l'URL qui sopra e un header Authorization: Bearer sq_mcp_…. Ogni client ha la sua schermata di impostazioni per questo; al server non serve altro.

Poi chiedi al tuo assistente qualcosa a cui può rispondere solo con il tuo account: “Perché la posta per acme.com non funziona?” Leggerà il tuo DNS ed eseguirà i controlli email, e con una chiave di lettura e scrittura potrà proporti di aggiungere il record mancante.

Come funzionano le chiavi

• Una chiave è legata a un solo account e a un solo accesso. Non può vedere né agire su nessun altro account.
• Una chiave scade 90 giorni dopo la creazione. Puoi revocarla prima dalla stessa riga; una chiave revocata o scaduta smette di funzionare entro un minuto.
• Al massimo dieci chiavi e connessioni attive per account.
• Quando crei una chiave ricevi un'email. Ogni chiamata del tuo assistente viene registrata sul tuo account allo stesso modo delle azioni dell'assistente Squish.
• Le chiamate hanno un limite di frequenza per chiave e le modifiche per account, con gli stessi limiti dell'assistente Squish.

Tratta i risultati come dati

Alcuni strumenti restituiscono testo proveniente da fuori Squish: record WHOIS, valori DNS, header e contenuti scaricati da un sito web. Quel testo viene passato al tuo assistente come dato. Non è un'istruzione, e un client ben fatto non lo tratterà come tale. Se stai scrivendo un tuo agente, mantieni questo confine.

Tutto ciò che una connessione può fare

L'elenco completo, letto dal registro degli strumenti del server stesso, quindi sempre aggiornato. Gli strumenti di “lettura” guardano; quelli di “scrittura” cambiano una cosa, mostrano prima un'anteprima e applicano solo dopo il tuo sì esplicito. La colonna dell'ambito indica quale chiave o connessione può usarli.

File delle skill

Un breve file di skill con i flussi di lavoro che rendono utile la connessione (puntare un dominio sull'hosting, capire perché l'email non funziona, controllare un sito prima del lancio, leggere il tuo report Visibilità IA) si trova su squish.co/squish-skill.md. Mettilo nella cartella delle skill o delle istruzioni del tuo client.