Introduzione al Model Context Protocol di Smartsheet

Smartsheet ha introdotto un server MCP (Model Context Protocol) disponibile per tutti gli utenti. Grazie a questo server, gli assistenti IA possono interagire con i fogli, le righe, le colonne e le automazioni di Smartsheet usando un protocollo uniforme che copre più di 40 strumenti.

Le operazioni più comuni – aggiornare lo stato di un’attività, creare nuove righe o modificare la struttura di un progetto – possono essere eseguite tramite comandi in linguaggio naturale, eliminando la necessità di passare da un’app all’altra.

Due scenari di integrazione

L’articolo illustra due modalità di connessione del MCP Server: Amazon Quick, uno spazio di lavoro IA per utenti business, project manager e team operativi, e Kiro, un IDE agentico per sviluppatori.

Entrambe le soluzioni fungono da client MCP, ma si rivolgono a pubblici differenti e offrono esperienze di interazione diverse.

Architettura di integrazione

Nel diagramma architetturale, il server Smartsheet MCP è il nodo centrale che collega i servizi AWS ai dati Smartsheet. Amazon Quick e Kiro si connettono direttamente al server come client MCP.

Amazon Quick è pensato per i knowledge worker: consente di porre domande, aggiornare fogli e creare dashboard senza scrivere codice.

Kiro, invece, è dedicato agli sviluppatori: permette di consultare specifiche di progetto, aggiornare lo stato di task e monitorare dipendenze direttamente dall’ambiente di sviluppo.

Flusso tipico di utilizzo

Un team di ingegneria software che gestisce lo sprint in Smartsheet può:

    • Usare Amazon Quick per chiedere “Quali task dello sprint sono bloccati questa settimana?”; l’agente interroga il MCP Server, estrae le righe rilevanti e restituisce un riepilogo con proprietari e date di scadenza.
    • Usare Kiro per richiedere “Mostrami i task backend aperti assegnati a me”; Kiro interroga il MCP, visualizza l’elenco inline e, al commit del fix, aggiorna automaticamente lo stato della riga a “Complete”.

Prerequisiti tecnici

Il server MCP fornisce un contesto strutturato – relazioni tra righe, tipi di colonna, cronologia delle celle e commenti – con payload più leggeri rispetto alle API tradizionali, riducendo costi e latenza in scenari di query massiva.

Prima di procedere con le integrazioni, è necessario verificare:

    • Un account AWS attivo con permessi IAM adeguati per Amazon Quick o Kiro.
    • Un account Smartsheet con piano Business, Enterprise o AWM.
    • Un Personal Access Token Smartsheet o credenziali OAuth.
    • Permessi “Author” o superiori in Amazon Quick.
    • Kiro IDE installato da kiro.dev con Node.js disponibile.

Il server MCP è disponibile in tre endpoint regionali (US, EU, AU) e utilizza trasporto HTTP streamable con specifiche MCP 2025‑06‑18 e 2025‑03‑26, autenticandosi via OAuth 2.0 o Personal Access Token.

Integrazione di Amazon Quick

Amazon Quick include Smartsheet come connettore pre‑configurato nella sua directory. Questo permette di leggere lo stato dei progetti, aggiornare righe, creare discussioni e segnalare rischi, il tutto nella stessa interfaccia utilizzata dagli utenti business.

Passaggi per la configurazione

    • Accedere alla console Amazon Quick e selezionare Connectors.
    • Trovare il connettore Smartsheet e cliccare sul relativo tile.
    • Inserire i dettagli di integrazione:
      • Name: nome descrittivo della connessione.
      • Base URL: https://mcp.smartsheet.com.
      • Client ID e Client Secret: ottenuti dalla registrazione dell’app in Smartsheet Developer Tools.
      • Token URL: https://api.smartsheet.com/2.0/token.
      • Auth URL: https://app.smartsheet.com/b/authorize.
    • Procedere con Next fino alla pagina Manage Tools & Permissions e confermare gli strumenti disponibili.
    • Pubblicare la connessione scegliendo chi può accedervi e cliccare Publish.

Dopo la configurazione, gli utenti possono interagire con Smartsheet mediante comandi naturali, ad esempio:

    • “Quali progetti del nostro portafoglio sono attualmente At Risk?”
    • “Aggiorna lo stato del task di autenticazione in Backend API a Complete.”
    • “Crea un riepilogo di tutti gli item scaduti del Q3 Roadmap e invialo al team.”

Integrazione di Kiro

Kiro è ideale per sviluppatori che desiderano avere il contesto di Smartsheet direttamente nell’IDE, senza cambiare ambiente.

Funzionalità “powers”

Le “powers” di Kiro sono bundle installabili con un click che includono server MCP pre‑configurati, file di steering e hook. Per Smartsheet, è sufficiente aggiungere un blocco JSON di configurazione e il agente Kiro potrà accedere ai dati di progetto in tempo reale.

Procedura di connessione

    • Aprire il file di configurazione kiro-mcp.json nella directory del progetto.
    • Aggiungere la sezione: 
      {

      "name": "smartsheet-mcp",
      

      "endpoint": "https://mcp.smartsheet.com",
      

      "auth": {
      

      "type": "personalAccessToken",
      

      "token": "YOURPERSONALACCESS_TOKEN"
      

      },
      

      "tools": ["sheets", "rows", "columns", "automations"]
      

      }

    • Eseguire kiro powers install smartsheet-mcp per attivare il bundle.
    • Utilizzare i comandi Kiro, ad esempio:
      • kiro get rows --sheetId 12345 --filter status=Open
      • kiro update row --sheetId 12345 --rowId 67890 --status Complete

Grazie a questi hook, quando un commit risolve un bug, Kiro aggiorna automaticamente la riga corrispondente in Smartsheet, mantenendo sincronizzati codice e stato del progetto.

Scelta tra Amazon Quick e Kiro

La decisione dipende dal ruolo e dall’infrastruttura:

    • Amazon Quick: soluzione gestita a livello aziendale, ideale per team ampi, nessuna registrazione di app necessaria, OAuth pre‑configurato, scalabilità garantita.
    • Kiro: approccio leggero per sviluppatori, richiede solo un file di configurazione e un token personale, nessuna infrastruttura aggiuntiva.

Entrambe le opzioni offrono lo stesso set di strumenti Smartsheet; la differenza sta nell’esperienza d’uso e nella governance.

Considerazioni finali e best practice

Utilizzare il Model Context Protocol di Smartsheet su AWS permette di:

    • Ridurre il tempo di risposta delle query IA grazie a payload ottimizzati.
    • Tagliare i costi operativi mantenendo le chiamate API al minimo indispensabile.
    • Garantire coerenza dei dati tra i sistemi di gestione progetti e gli ambienti di sviluppo.
    • Abilitare l’automazione di flussi di lavoro complessi tramite linguaggio naturale, aumentando la produttività di project manager e sviluppatori.

Seguendo le guide di configurazione presentate, le organizzazioni possono implementare rapidamente una pipeline di lavoro IA‑assisted, sfruttando la potenza di Smartsheet MCP e dei servizi AWS per trasformare la gestione dei progetti in un’esperienza più fluida e automatizzata.