Server MCP

DimensionKit mette a disposizione un server MCP remoto, consentendo a un assistente IA di creare, aggiornare, pubblicare e verificare le tue scorecard per tuo conto.

https://app.dimensionkit.com/mcp

Incolla questo indirizzo in qualsiasi client compatibile con server MCP remoti. Consulta Connettere un client per la procedura di collegamento e Gestire le connessioni per consultare gli accessi o revocarli.

Operazioni supportate

• Creare scorecard, aggiungere dimensioni e domande, impostare fasce di punteggio e pubblicare
• Modificare o eliminare quesiti e dimensioni su scorecard già attive
• Consultare le risposte ricevute, inclusi i punteggi per dimensione e le scelte espresse
• Verificare se una scorecard sia pronta per la pubblicazione e rilevarne le criticità
• Ottenere link di anteprima per le bozze prima della messa online

Sequenza di creazione di una scorecard

Gli strumenti seguono l’ordine naturale con cui si struttura il lavoro:

1. scorecard_design_guide — Linee guida metodologiche, da leggere prima di redigere
2. create_scorecard — Creazione della bozza con impostazioni visive e di brand
3. add_dimension — Definizione degli ambiti di valutazione
4. add_questions — Aggiunta di tutte le domande di una dimensione in una sola operazione
5. set_dimension_tiers — Definizione dei livelli di risultato e relative considerazioni
6. check_scorecard — Controllo di conformità e individuazione di aspetti deboli
7. publish_scorecard — Pubblicazione definitiva

Una bozza non è visibile al pubblico. Le risposte degli strumenti indicano l’URL definitivo contrassegnato con urlIsLive: false, avvisando l’assistente di non condividerlo prematuramente.

Principi qualitativi oltre gli schemi tecnici

scorecard_design_guide raccoglie indicazioni che un semplice schema non può includere: quali domande porti prima di iniziare, come formulare quesiti privi di risposte scontate, come redigere considerazioni di livello incisive e quale tema visivo scegliere — consulta Temi e branding. L’assistente ti chiederà indicazioni sul target e sul tono desiderato invece di formulare ipotesi arbitrarie.

I client che supportano i prompt MCP hanno inoltre a disposizione tre comandi dedicati: build_scorecard, review_scorecard e choose_theme.

Anteprima delle bozze prima di pubblicare

Ogni chiamata relativa a una bozza restituisce una previewUrl: un link protetto, valido per 24 ore, che mostra la scorecard fedelmente come la vedranno i partecipanti. Presenta un avviso di bozza e i test inviati tramite questo link non vengono registrati nel database.

Due regole vincolanti del sistema

Gli intervalli dei livelli sono calcolati, mai inseriti a mano. Il punteggio di una dimensione oscilla tra la somma delle risposte minime e quella delle massime, e i livelli ripartiscono questo intervallo in modo continuo. Modificando le domande, gli estremi vengono ricalcolati automaticamente dal sistema.

Gli identificatori delle domande e le chiavi delle dimensioni sono definitivi. Le risposte e i punteggi rimangono associati a questi codici. Per salvaguardare lo storico, update_question e update_dimension permettono di aggiornare tutti i parametri tranne queste chiavi.

Modificare una scorecard già pubblicata

L’operazione è del tutto sicura. Ogni compilazione archivia i punteggi, il livello assegnato e il testo esatto visibile al momento dell’invio, abbinati a un codice hash della versione. Modifiche successive non alterano i dati già acquisiti.

Cosa viene deliberatamente escluso

• Nessuna richiesta interattiva avviata dal server. I meccanismi di campionamento o elicitazione MCP richiedono canali aperti persistenti che questo server non mantiene. Qualsiasi chiarimento avviene nella tua normale conversazione con l’assistente.
• Nessuno streaming. Il servizio evade singole richieste indipendenti senza tenere attive connessioni SSE prolungate.
• Nessun accesso alla fatturazione. Le autorizzazioni riguardano esclusivamente le scorecard e i relativi invii.
• Nessuna API REST di scrittura aperta. Le chiamate REST pubbliche restano limitate alla consultazione e all’invio dei form; le modifiche passano unicamente tramite MCP o interfaccia di amministrazione.