Un URL. Ogni client MCP. L'intero parco stampanti.
Incollare https://simplyprint.io/api/mcp nelle impostazioni del connettore di qualsiasi assistente compatibile con MCP, approvare la schermata di consenso OAuth e il gioco è fatto. Stesso modello di autenticazione del resto di SimplyPrint, stessi permessi, stessi dati, ma in linguaggio naturale anziché tramite clic nel pannello.
Cos'è MCP?
MCP (Model Context Protocol) è uno standard aperto, promosso da Anthropic e adottato da tutti i principali fornitori di AI, che consente a un assistente AI di chiamare strumenti esterni tramite un'unica interfaccia uniforme. Invece di far inventare a ogni assistente il proprio formato di plugin, MCP definisce un unico formato compreso da Claude, ChatGPT, Gemini, Cursor, Windsurf, Cline, Zed e altri.
SimplyPrint gestisce un server MCP ufficiale all'indirizzo https://simplyprint.io/api/mcp. Qualsiasi assistente che supporti connettori personalizzati o server MCP può collegarsi, un solo URL per tutti i client. È inoltre presente nel registro ufficiale Model Context Protocol come io.simplyprint/simplyprint, così i client che consultano il registro possono rilevarlo automaticamente.
Quasi tutto ciò che si può fare nel pannello, come strumenti AI nativi
Il server MCP espone le stesse operazioni del pannello, raggruppate in categorie tra cui sceglie l'assistente. Circa 70 strumenti in totale, tutti collegati agli stessi endpoint API che alimentano l'app web SimplyPrint: una stampante in una chiamata MCP è quindi lo stesso oggetto stampante restituito dall'API.
Ispezionare, inviare G-code, spostare gli assi, controllare le ventole, eseguire l'homing, mettere in pausa, riprendere, annullare.
Aggiungere, riordinare, modificare, approvare, rifiutare, riattivare, raggruppare e commentare.
Cercare, filtrare, stimare i costi, aggiornare i metadati, organizzare le cartelle.
Ispezionare le bobine, regolare il peso, assegnare, rimuovere l'assegnazione, contrassegnare come asciutte.
Filtrare i lavori precedenti, archiviare e visualizzare tasso di successo, filamento, tempo e costo.
Cosa chiedono davvero al loro assistente
Alcuni prompt reali che corrispondono direttamente a una chiamata di strumento, ripresi dall'interfaccia di esempio nell'articolo dell'helpdesk:
- Stampanti: "Cosa sta stampando ora?" - "Eseguire l'homing su tutti e tre gli assi della stampante 4." - "Annullare la stampa sulla K2."
- Coda: "Approva le tre voci di Sarah in sospeso." - "Metti in coda cinque copie di benchy.gcode per domani." - "Quale stampante del laboratorio può stampare più velocemente la prossima voce?"
- File: "Trovare tutti i file con tag 'prototype' ed eliminarli." - "Stimare il costo di stampa di battery-holder.gcode su X1C."
- Filamento: "Quali bobine hanno meno di 100 grammi?" - "Regolare il peso rimanente della bobina 42 a 820 grammi."
- Statistiche: «Quanto filamento è stato usato questa settimana?» - «Mostrami i dettagli della stampa più lunga di ieri.»
Client con file di configurazione: un blocco JSON
I client MCP per editor e CLI (Claude Desktop, Claude Code, Cursor, Cline e Zed) conservano l'elenco dei server MCP in un file di configurazione JSON. È sufficiente aggiungere SimplyPrint in mcpServers e il client gestisce la procedura OAuth al primo utilizzo.
{
"mcpServers": {
"simplyprint": {
"url": "https://simplyprint.io/api/mcp"
}
}
}
Ambiti granulari: concedere solo ciò che serve all'assistente
Ogni autorizzazione concede all'assistente una parte specifica dell'account. La schermata di consenso OAuth elenca ogni ambito richiesto da un assistente e permette di decidere cosa approvare, così un assistente che genera riepiloghi in sola lettura non ottiene mai accesso in scrittura e un'automazione solo per la coda non vede mai i dettagli del filamento.
- Visualizzare o gestire: quasi ogni categoria ha ambiti separati di lettura e scrittura. Per un assistente strettamente in sola lettura, omettere gli ambiti di gestione. Per l'automazione completa, concedere entrambi.
- Token per utente: il token è legato all'utente corrente, non all'amministratore dell'account. Eredita le autorizzazioni dell'utente nell'account, mai più di queste.
- Esclusi per scelta: fatturazione, modifiche all'abbonamento ed eliminazione dell'account non sono affatto esposte a MCP, nessun ambito può sbloccarle.
- Revocare subito: aprire impostazioni account → app connesse, visualizzare ogni assistente connesso con ambiti di autorizzazione e data/ora dell'ultimo utilizzo, quindi revocare l'accesso. L'assistente smette immediatamente di funzionare.
Stai sviluppando un client MCP?
Per chi scrive un client MCP personalizzato, il flusso di autenticazione usa una concessione standard Authorization Code OAuth 2.1 con https://simplyprint.io/oauth/authorize e https://simplyprint.io/oauth/token. La guida completa con curl, il riferimento agli scope e la semantica dei token sono disponibili nella documentazione API.
Funziona con ogni assistente compatibile con MCP
L'integrazione è identica in ogni client, stesso URL, stessa procedura OAuth, stessi strumenti. Sono disponibili guide dedicate per i client più comuni e la stessa configurazione funziona in ogni altro strumento compatibile con MCP.
Funziona in claude.ai, Claude Desktop e Claude Code.
Aggiungere un connettore personalizzato che punta all'URL MCP di SimplyPrint.
Installare l'estensione ufficiale o aggiungere direttamente l'URL MCP.
Qualsiasi editor o agente compatibile con MCP si connette tramite lo stesso flusso OAuth.
Cercare "simplyprint" nel registro MCP del client per aggiungerlo.
OAuth, token con ambiti limitati, revocabili in qualsiasi momento
La sicurezza segue lo stesso modello usato dal resto di SimplyPrint, solo adattato per i client IA.
- Flusso OAuth, non chiavi incollate: l'accesso avviene su simplyprint.io e l'assistente non vede mai la password. Il token ricevuto è opaco.
- Limitato agli ambiti: un token può chiamare solo gli strumenti corrispondenti agli ambiti approvati. Gli strumenti fuori ambito vengono rimossi dall'elenco e rifiutati alla chiamata.
- Vincolati al destinatario: i token sono vincolati all'URL MCP canonico per cui sono stati emessi, come previsto da RFC 8707. Un token per SimplyPrint può essere usato solo con SimplyPrint, senza possibilità di riutilizzarlo su altri server.
- Accesso breve, refresh a rotazione: i token di accesso durano 1 h, i token di refresh ruotano a ogni utilizzo e scadono dopo 90 giorni. Secondo la specifica MCP 2025-06-18.
- Per utente, mai condiviso: il token eredita le autorizzazioni dell'utente nell'account. Un assistente collegato da un utente con permessi di sola visualizzazione non può mai passare ad azioni amministrative.
- Registro completo delle chiamate: ogni chiamata MCP viene registrata lato server con metodo, parametri, durata ed esito, così è possibile verificare cosa ha effettivamente eseguito un assistente.
Si abbina all'API REST e ai webhook
MCP affianca il resto dell'offerta per sviluppatori di SimplyPrint: stesso modello di autenticazione, stessi formati dati, stesso sistema di autorizzazioni:
- L'SimplyPrint API è ciò che il codice usa per richiedere lo stato quando necessario.
- I Webhooks sono le notifiche che SimplyPrint invia non appena qualcosa cambia, così non sono necessarie interrogazioni periodiche.
- MCP è ciò che gli assistenti AI chiamano quando devono leggere o agire sullo stesso parco stampanti, tramite un registro di strumenti verificato e con ambiti limitati anziché endpoint grezzi.
Accesso per piano: quali piani includono MCP?
L'accesso MCP è incluso dal piano Pro in su, senza costi aggiuntivi. Nessun costo per strumento o chiamata, nessuna licenza AI separata. L'abbonamento dell'assistente (Claude Pro, ChatGPT Plus, Gemini ecc.) viene pagato al relativo fornitore, non a SimplyPrint.
| Funktion / Limit | Kostenlos | Einfach | Pro | Druckfarm | Enterprise | Schule | Cloud Slicer | Filament-Manager |
|---|---|---|---|---|---|---|---|---|
|
Accesso API MCP
Server MCP completo con tutti gli strumenti dell'interfaccia utente: stampanti, coda di stampa, file, filamento, lavori, statistiche. Basato su OAuth, con accesso limitato dagli scope, disponibile da Pro in su.
|
||||||||
|
API di base (in abbinamento a MCP)
Stessi piani, stesso modello di autenticazione. Usare la REST API per il proprio codice, MCP per gli assistenti AI: entrambi usano lo stesso sistema di autorizzazioni per utente. Consultare la pagina sulle funzionalità API per livelli e limiti.
|
||||||||
|
Webhooks (dal piano Print Farm in su)
Quando il workflow AI deve reagire agli eventi anziché interrogarli, MCP e webhook possono essere abbinati. Inclusi nei piani Print Farm, School ed Enterprise.
|
Möchtest du mehr über unsere Tarife erfahren?
Vollständigen Preis- und Funktionsvergleich anzeigenDomande frequenti
Cos'è MCP?
Qual è l'URL MCP di SimplyPrint?
Quali assistenti IA possono connettersi?
Quali assistenti IA supportano MCP?
Come funziona il rinnovo del token?
Cosa può fare davvero un assistente?
È necessario incollare una chiave API?
Come revocare l'accesso di un assistente?
I dati vengono usati per addestrare l'IA?
Quanto costa MCP su SimplyPrint?
Più assistenti possono connettersi allo stesso account?
In cosa MCP differisce dalle API REST e dai webhook?
Dove si trova la guida passo passo?
Guida passo passo alla configurazione
Per la guida completa per ogni client, incluse le specifiche per Claude, ChatGPT, Gemini CLI e client MCP negli editor, consultare l'articolo del centro assistenza collegare SimplyPrint a qualsiasi assistente AI tramite MCP.