Vai al contenuto
DOTWICK

Server MCP

Cos’è

Il Model Context Protocol (MCP) è uno standard aperto che permette a un assistente IA di richiamare strumenti in un altro servizio. Dotwick gestisce un server MCP così che un assistente possa elencare i tuoi codici, crearli e cambiarli, taggarli e leggere i numeri delle tue scansioni.

Il server è un sottile strato sopra questa API. Ognuno dei suoi 11 strumenti chiama una route dell’API con l’ambito di quella route, con gli stessi limiti di richieste, quindi un assistente può fare ciò che farebbe a mano la sua chiave e nient’altro. Nulla elimina: rimuovere codici, cartelle e tag resta nell’app e nell’API REST, quindi nessun prompt può rompere un codice stampato.

Prima di iniziare

MCP è incluso con l’accesso API (Pro, Business ed Enterprise). Nell’app apri Settings → API e crea una chiave con gli ambiti di cui l’assistente ha bisogno: gli ambiti di lettura bastano per domande sulle tue scansioni, e codes:write, folders:write o tags:write gli permettono di cambiare le cose.

L’assistente vede solo gli strumenti che la sua chiave consente, quindi una chiave di sola lettura non elenca mai create_code. Ogni chiamata a uno strumento conta come una richiesta API sul limite di richieste e sul totale mensile della chiave; elencare gli strumenti no.

Collegalo

Il server parla Streamable HTTP all’indirizzo https://api.dotwick.com/mcp. Invia la chiave come bearer token nell’header Authorization.

esempioAggiungi il server
claude mcp add --transport http dotwick https://api.dotwick.com/mcp \  --header "Authorization: Bearer $DOTWICK_API_KEY"

Claude, ChatGPT e altri client

Claude Code aggiunge il server con il comando qui sopra. I client che leggono un file di configurazione MCP, come Cursor e VS Code, prendono il blocco JSON: tieni la chiave in una variabile d’ambiente e riferisciti a quella, non scriverla mai nel file.

ChatGPT e le altre app che aggiungono un server MCP remoto tramite il suo URL: inserisci l’URL del server e invia la chiave come bearer token dove l’app chiede una chiave API o un header. Un’app che può accedere solo con OAuth non può ancora connettersi. OAuth è previsto; oggi il server si raggiunge con le chiavi API.

Strumenti

Ogni strumento corrisponde a una route dell’API e richiede l’ambito di quella route. Gli strumenti di elenco restituiscono fino a 50 elementi e un cursore per la pagina successiva.

list_codes
Elenca i codici QR dello spazio di lavoro, dal più recente. Filtra per cartella, tag, tipo, stato o con una ricerca su nome e link breve.codes:read · GET /v1/codes
get_code
Un codice QR con la sua destinazione, le regole, i tag e le scansioni totali.codes:read · GET /v1/codes/{id}
create_code
Crea un codice QR che apre una pagina web. Dinamico per impostazione predefinita (la destinazione può cambiare dopo la stampa). Cartella, tag e parametri UTM facoltativi.codes:write · POST /v1/codes
update_code
Cambia nome, URL di destinazione, cartella, tag o data di scadenza di un codice, oppure mettilo in pausa o riprendilo.codes:write · PATCH /v1/codes/{id}
list_folders
Le cartelle dello spazio di lavoro.folders:read · GET /v1/folders
create_folder
Crea una cartella, anche dentro un’altra.folders:write · POST /v1/folders
list_tags
I tag dello spazio di lavoro e quanti codici ha ciascuno.tags:read · GET /v1/tags
create_tag
Crea un tag con nome e colore.tags:write · POST /v1/tags
tag_codes
Aggiungi o rimuovi tag su fino a 500 codici alla volta.codes:write · POST /v1/codes/tags
analytics_summary
Scansioni totali e uniche per un intervallo: lo spazio di lavoro, un codice, una cartella o un tag.analytics:read · GET /v1/analytics/summary
analytics_breakdown
Paesi, città, dispositivi, browser, codici o varianti A/B più frequenti per un intervallo.analytics:read · GET /v1/analytics/breakdown

Limiti e sicurezza

  • La chiave mantiene la sua restrizione di cartella, gli intervalli IP e i limiti di richieste: tramite MCP vede solo ciò che vede tramite l’API REST.
  • Nulla può essere eliminato tramite MCP.
  • Un assistente può sbagliare. Chiedigli di dire cosa sta per cambiare prima di scrivere, e controlla il risultato nell’app.