Embed, integrazioni e MCP

Come collegare un assistente AI a MyLaserTools (MCP)

Puoi collegare un assistente AI al tuo account MyLaserTools e chiedergli quello che vuoi realizzare. Cerca nella Libreria artistica, ti mostra le anteprime, scarica i file originali che il tuo account può aprire, apre nell'Editor di design i pezzi che scegli e compila generatori gratuiti, come quello di scritte con lettere unite o quello di segnapiante, con il tuo testo e le tue misure.

La connessione usa MCP (Model Context Protocol), lo standard aperto con cui assistenti come Claude e ChatGPT lavorano con altri servizi. Questa guida spiega come aggiungere il server, che cosa può fare l'assistente e come scollegarlo.

Cosa può fare il tuo assistente

  • Cercare nella Libreria artistica le illustrazioni che corrispondono a una descrizione e mostrarti anteprime, formati, condizioni di licenza e quanto costa ogni pezzo sul tuo account.
  • Scaricare i file originali. I pezzi gratuiti, quelli inclusi nel tuo piano e quelli che hai sbloccato arrivano come link di download. In Claude Code o in un altro assistente che può salvare file, può metterli direttamente nel tuo progetto.
  • Sbloccare pezzi a pagamento con le scintille, se lo consenti: l'assistente ti dice prima il costo e spende solo dopo che hai accettato.
  • Aprire pezzi nell'Editor di design. L'assistente crea un link che apre i pezzi che hai scelto, e il testo che hai chiesto, nell'editor del tuo account.
  • Compilare i generatori gratuiti. Per scritte con lettere unite, segnapiante, targhette per zaino e scatole per stampa 3D crea un link che apre il generatore con testo, misure, font e stile già impostati. Controlli l'anteprima e scarichi SVG, STL o 3MF nel browser.
  • Trovare il generatore giusto per un progetto di laser, CNC, stampa 3D, stampa o vinile, con un link alla sua pagina.
  • Controllare il tuo account: il tuo piano e il saldo di scintille.
L'assistente non acquista mai scintille e non cambia il tuo piano. Spende scintille solo se hai selezionato quel permesso e solo dopo che hai accettato il costo che ti mostra. Anche i link all'editor chiedono conferma prima che venga speso qualcosa.

Prima di iniziare

  • Un account MyLaserTools. Qualsiasi account può collegarsi, e i link ai generatori sono gratuiti.
  • I pezzi della Libreria artistica funzionano come sul sito: inclusi con Supporter e Pro, oppure sbloccati con le scintille.
  • Un assistente che supporta i server MCP remoti, a volte chiamati connettori personalizzati.

Passo 1: aggiungi il server MyLaserTools

Tutti gli assistenti usano lo stesso indirizzo del server:

Indirizzo del server
https://www.mylasertools.com/mcp

Claude (web e desktop)

  1. Apri Settings (Impostazioni), poi Connectors (Connettori).
  2. Scegli Add custom connector (Aggiungi connettore personalizzato).
  3. Chiamalo MyLaserTools, incolla https://www.mylasertools.com/mcp e salva.
  4. Scegli Connect (Collega) accanto al nuovo connettore per accedere (passo 2).

ChatGPT

Apri Settings (Impostazioni), poi Apps & Connectors (App e connettori), e crea un connettore con https://www.mylasertools.com/mcp e accesso OAuth. I connettori personalizzati sono disponibili solo in alcuni piani di ChatGPT e potresti dover prima attivare la modalità sviluppatore nelle impostazioni avanzate.

Claude Code

Esegui questo comando nel terminale, poi avvia Claude Code e usa /mcp per accedere:

Terminale
claude mcp add --transport http mylasertools https://www.mylasertools.com/mcp

Cursor e altri editor

Gli editor che leggono un file di impostazioni MCP (per esempio .cursor/mcp.json) accettano il server così:

File di impostazioni MCP
{
  "mcpServers": {
    "mylasertools": {
      "url": "https://www.mylasertools.com/mcp"
    }
  }
}

Passo 2: accedi e approva

La prima volta che l'assistente si collega, apre MyLaserTools nel browser. Accedi, se non l'hai già fatto, e vedrai che cosa l'assistente chiede di poter fare:

  • Cercare e visualizzare le illustrazioni. Sempre attivo: è lo scopo della connessione.
  • Scaricare i file delle illustrazioni. I file originali che il tuo account può già aprire. Deselezionalo se vuoi solo suggerimenti e link all'editor.
  • Spendere scintille per sbloccare illustrazioni. Disattivato se non lo selezioni. Anche in quel caso, l'assistente ti chiede conferma prima di ogni spesa.
  • Preparare link all'editor. Deselezionalo se vuoi solo suggerimenti.
  • Usare i generatori di design gratuiti. Deselezionalo per limitare l'assistente alla Libreria artistica.

Scegli Consenti e torni al tuo assistente. Resta collegato per un massimo di 30 giorni prima di chiederti di approvarlo di nuovo. Approva solo un assistente che hai aggiunto tu.

Passo 3: chiedi quello che vuoi realizzare

Parla con l'assistente come faresti con un amico che conosce il sito. Per esempio:

  • «Trova un girasole da incidere su un cartello da giardino e aprilo nell'editor con il testo Il giardino di Rosie.»
  • «Crea dei segnapiante traforati per basilico, menta e timo.»
  • «Voglio una scatola stampata in 3D per le mie viti, 120 per 80 mm e profonda 40 mm, con coperchio.»
  • «Quali generatori possono creare una targhetta per zaino con il nome in due colori per la mia stampante 3D?»
  • «Scarica l'SVG originale di quel bordo con foglie di quercia.»
  • «Quante scintille mi restano?»

L'assistente risponde con file o link. Un link di download ti dà il file originale. Apri un link all'editor dopo aver effettuato l'accesso a MyLaserTools per portare i pezzi nel tuo design. Un link a un generatore lo apre con tutto già compilato, pronto da regolare e scaricare.

Illustrazioni a pagamento e scintille

  • I risultati di ricerca, le anteprime e i preventivi di download indicano se ogni pezzo è gratuito, incluso nel tuo piano, già sbloccato o quante scintille costa.
  • Gli abbonati Supporter e Pro scaricano la libreria a pagamento senza spendere scintille, proprio come sul sito.
  • Gli account gratuiti possono sbloccare pezzi a pagamento con le scintille: l'assistente mostra il costo, aspetta che tu accetti e spende solo se hai consentito la spesa.
  • I pezzi che hai già sbloccato si scaricano di nuovo gratuitamente, e il tuo saldo si aggiorna appena sblocchi un pezzo.
  • Se resti a corto di scintille, l'assistente te lo dice; ne ottieni altre sul sito. Non acquista mai scintille.
  • Quando apri un link all'editor che include un pezzo che costa scintille, l'editor mostra il tuo saldo e il costo e aspetta la tua risposta.
  • I link ai generatori non costano mai nulla e funzionano senza accedere.

Uso corretto

Le richieste degli assistenti possono avere limiti di frequenza. I download rientrano negli stessi limiti del sito. Se il tuo assistente dice di aver raggiunto un limite, aspetta un po' e riprova.

Gli assistenti servono a trovare le illustrazioni che hai chiesto. L'estrazione massiva del catalogo e la copia della libreria non sono supportate, e gli account che ci provano possono essere messi in pausa per una revisione.

Cosa registra MyLaserTools

Per ogni connessione registriamo quali strumenti ha usato e quando, le parole di ricerca che ha inviato, quali illustrazioni le sono state mostrate, quali file ha scaricato e se i suoi link sono stati aperti e hanno portato a un'importazione. Se accetti i cookie di analisi, annotiamo anche quando un generatore aperto da uno dei suoi link avvia un download. I registri delle attività si conservano per 90 giorni e l'elenco delle illustrazioni mostrate per 35 giorni. Non vediamo mai la tua conversazione con l'assistente, solo le chiamate agli strumenti che effettua.

Scollegamento

Apri le impostazioni dell'account e scegli Scollega accanto all'assistente. La sua sessione si chiude subito e non può più usare i suoi link. Puoi collegarlo di nuovo in qualsiasi momento.

Risoluzione dei problemi

  • L'assistente dice che deve accedere di nuovo. La connessione è scaduta o è stata scollegata. Ricollegalo dalle impostazioni dei connettori del tuo assistente.
  • Un link all'editor non si apre più. I link all'editor scadono dopo poco tempo e si aprono solo sull'account che ha collegato l'assistente. Chiedine uno nuovo.
  • Un link di download ha smesso di funzionare. I link di download scadono dopo poco tempo. Chiedi all'assistente di scaricare di nuovo il pezzo; i pezzi che hai già sbloccato non vengono addebitati due volte.
  • L'assistente ti chiede di approvarlo di nuovo. Ha bisogno di un permesso che non hai concesso, come il download o la spesa di scintille. Approvalo solo se vuoi che l'assistente lo faccia.
  • L'assistente dice che è stato raggiunto un limite. Le richieste possono avere limiti di frequenza. Aspetta un po' e riprova; puoi comunque cercare e scaricare sul sito.
  • Non succede nulla dopo aver scelto Consenti. Ricarica la pagina di approvazione e riprova, e controlla che il browser permetta alla pagina di tornare al tuo assistente.