Contexte de workflow pour les agents d'IA avec Smartsheet MCP sur AWS

Les agents d'IA sont plus utiles lorsqu'ils peuvent agir sur le travail réel qui se déroule dans votre organisation. La gestion de projets et d'opérations implique des tâches complexes et transversales telles que la mise à jour des échéanciers de projet, la réaffectation des tâches et la présentation des statuts. Les agents d'IA peuvent vous aider dans ces tâches sans que personne n'ait à changer d'outils. Smartsheet a lancé un serveur Model Context Protocol (MCP) en disponibilité générale.

Avec le serveur MCP Smartsheet, les assistants d'IA peuvent lire, écrire et gérer les données Smartsheet via un protocole standardisé. Le protocole couvre plus de 40 outils pour explorer, créer et gérer des feuilles, des lignes, des colonnes et des automatisations. Vous pouvez mettre à jour les statuts des tâches, créer des lignes et modifier la structure d'un projet directement en langage naturel.

Dans cet article, nous présentons deux façons de le connecter à vos workflows existants. Amazon Quick est un espace de travail d'IA agentique conçu pour les utilisateurs métier, les chefs de projet et les équipes opérationnelles. Ils peuvent poser des questions, mettre à jour des feuilles et créer des tableaux de bord en langage naturel sans écrire de code. Kiro est un IDE agentique dans lequel les développeurs se connectent à Smartsheet via MCP pour consulter les spécifications du projet, mettre à jour le statut des tâches et suivre les dépendances sans quitter leur workflow de développement.

Présentation de l'architecture

Le diagramme suivant montre comment le serveur MCP Smartsheet sert de couche d'intégration centrale se connectant aux services AWS. Amazon Quick et Kiro se connectent directement en tant que clients MCP.

Amazon Quick s'adresse aux travailleurs du savoir, aux chefs de projet et aux équipes opérationnelles qui souhaitent interroger, mettre à jour et automatiser Smartsheet en langage naturel. Avec Kiro, les développeurs peuvent consulter les spécifications du projet, mettre à jour le statut des tâches et suivre les dépendances sans quitter leur workflow de développement.

Le diagramme d'architecture suivant illustre ces chemins d'intégration : le serveur MCP Smartsheet au centre, avec Amazon Quick et Kiro en tant que clients MCP à gauche, et l'API et la couche de données de Smartsheet à droite.

Figure 1 : Architecture du serveur MCP Smartsheet montrant les connexions des clients MCP depuis Amazon Quick et Kiro via le serveur vers la couche API de Smartsheet

Gestion des sprints avec Amazon Quick et Kiro

Prenons l'exemple d'une équipe d'ingénierie logicielle qui suit son sprint dans Smartsheet. Les tâches, les responsables, les statuts et les blocages se trouvent tous dans une feuille de projet. Voici à quoi ressemble chaque chemin pour la même équipe :

Lorsqu'un utilisateur tel qu'un chef de projet souhaite savoir quelles tâches du sprint sont bloquées cette semaine, il peut le demander à Amazon Quick en langage naturel. L'agent de chat Amazon Quick interroge le serveur MCP Smartsheet, extrait les lignes pertinentes et présente un résumé avec les noms des responsables et les échéances. La réponse est générée à partir des données Smartsheet en temps réel, sans avoir à créer un rapport ou un tableau de bord.

Pour les développeurs qui corrigent des bugs ou travaillent sur des fonctionnalités, ils peuvent demander à Kiro de récupérer la feuille du sprint en cours et de leur montrer les tâches backend ouvertes qui leur sont assignées. Kiro interroge Smartsheet via MCP et affiche la liste en ligne. Lorsque la correction est validée, un hook Kiro met automatiquement à jour le statut de la ligne correspondante en Terminé.

Prérequis

Le serveur MCP Smartsheet fournit un contexte précisément structuré, incluant les relations entre les lignes, les types de colonnes, l'historique des cellules et les commentaires. Cela produit des tailles de charge utile économes en jetons plutôt que de renvoyer des charges d'API brutes. Cette décision d'ingénierie se traduit par une réduction des coûts et une latence améliorée à grande échelle lors de l'exécution de centaines de requêtes assistées par IA sur un portefeuille de projets. Pour savoir comment Smartsheet a construit son serveur MCP distant sur AWS, voir Comment Smartsheet a construit un serveur MCP distant sur AWS.

Avant de connecter le serveur MCP Smartsheet à Amazon Quick et Kiro, vérifiez que vous disposez des éléments suivants :

• Un compte AWS actif avec les autorisations AWS Identity and Access Management (IAM) appropriées pour le service que vous connectez (Amazon Quick ou Kiro)
• Un compte Smartsheet sur un plan Business, Enterprise ou AWM.
• Un jeton d'accès personnel Smartsheet, ou des identifiants OAuth si votre client prend en charge le flux OAuth.
• Pour Amazon Quick : des autorisations Author ou supérieures dans votre compte Amazon Quick.
• Pour Kiro : l'IDE Kiro installé depuis kiro.dev avec Node.js disponible dans votre environnement.

Le serveur MCP Smartsheet est disponible sur trois points de terminaison régionaux. Il utilise le transport Streamable HTTP (versions 2025-06-18 et 2025-03-26 de la spécification MCP) et s'authentifie soit avec OAuth 2.0, soit avec un Personal Access Token.

• Commercial US : https://mcp.smartsheet.com.
• UE : https://mcp.smartsheet.eu.
• AU : https://mcp.smartsheet.au.

Les deux options exposent le même ensemble d'outils Smartsheet. Le bon choix dépend de l'endroit où votre travail s'effectue :

Choisissez Amazon Quick si vous avez besoin d'une solution entièrement gérée et à l'échelle de l'organisation que toute votre équipe peut utiliser : pas d'enregistrement d'application, uniquement un OAuth préconfiguré, et une extensibilité pour les travailleurs du savoir de votre entreprise.

Choisissez Kiro si vous êtes un développeur à la recherche d'une solution légère : pas d'infrastructure, seulement un fichier de configuration et un personal access token, limité à votre propre flux de travail.

Intégration Amazon Quick

Amazon Quick inclut Smartsheet comme connecteur préconfiguré dans son annuaire. Cela signifie lire l'état des projets, mettre à jour des lignes, créer des discussions et mettre en évidence les risques, le tout dans la même interface que vos utilisateurs métier utilisent déjà.

Amazon Quick rend cette intégration disponible dans toute l'organisation, des chefs de projet et des équipes opérationnelles aux utilisateurs métier qui gèrent leur travail dans Smartsheet.

Pour ajouter l'intégration Quick :

1. Dans la console Amazon Quick, accédez à Connectors et recherchez Smartsheet dans l'annuaire.

Figure 2 : Le connecteur Smartsheet dans l'annuaire Amazon Quick Connectors

1. Sélectionnez la tuile Smartsheet connector .
2. Saisissez les détails d'intégration suivants :
   1. Name – Nom descriptif de votre intégration Smartsheet.
   2. Conservez les paramètres Connection type et Auth configuration tels quels.
   3. Base URL – https://mcp.smartsheet.com.
   4. Client ID – ID client de l'application issue de l'enregistrement de votre application dans Smartsheet Developer Tools.
   5. Client Secret – Secret de l'application issue de l'enregistrement de votre application dans Smartsheet Developer Tools.
   6. Token URL – https://api.smartsheet.com/2.0/token.
   7. Auth URL – https://app.smartsheet.com/b/authorize.

Figure 3 : Saisie des détails de connexion Smartsheet dans Amazon Quick

1. Choisissez Suivant.
2. Sur la Manage Tools & Permissions page, vous voyez une liste des outils disponibles. Choisissez Suivant.

Figure 4 : La page Manage Tools and Permissions du connecteur Smartsheet

1. Sur la Publish page, choisissez qui peut accéder à cette connexion, puis choisissez Publish.

Figure 5 : Choix des personnes pouvant accéder à la connexion Smartsheet sur la page Publish

1. Choisissez Suivant.

Une fois connecté, votre agent de chat Amazon Quick peut travailler avec les données Smartsheet en langage naturel :

• « Quels projets de notre portefeuille sont actuellement À Risque ? »
• « Mets à jour le statut de la tâche d'authentification dans la feuille Backend API à Terminé. »
• « Crée un résumé de tous les éléments en retard dans la feuille Q3 Roadmap et envoie-le à l'équipe. »

Figure 6 : Réponse du chat Amazon Quick résumant les tâches en retard d'une feuille de projet Smartsheet avec les observations clés et les actions recommandées

Intégration Kiro

Kiro est la voie à suivre lorsque les développeurs veulent que le contexte de projet Smartsheet soit disponible directement dans leur environnement de développement, à côté de leur code, sans changer de contexte.

Kiro est conçu autour du développement piloté par les spécifications. Il transforme des requêtes de haut niveau en spécifications structurées, puis en code, documentation et tests fonctionnels. Les serveurs MCP sont la manière dont Kiro obtient un contexte réel en se connectant à la documentation, aux bases de données, aux API et aux systèmes d'entreprise afin d'ancrer son agent dans des données en direct plutôt que dans des connaissances issues de l'entraînement.

Une fonctionnalité de Kiro appelée powers est un paquet installable en un clic qui regroupe un serveur MCP sélectionné avec des fichiers de pilotage et des hooks. Elle donne à l'agent de codage Kiro une nouvelle capacité prête à l'emploi. Pour Smartsheet, la configuration de la connexion ne nécessite qu'un seul bloc de configuration JSON et, à partir de là, l'agent Kiro peut référencer des données de projet en direct dans le cadre d'un flux de travail de développement.

Pour connecter le serveur MCP Smartsheet à Kiro, ajoutez-le à votre configuration Kiro MCP (.kiro/settings/mcp.json pour la portée de l'espace de travail). Pour une présentation complète, consultez Getting Started with Kiro and MCP Servers:

{
  "mcpServers": {
    "smartsheet-us": {
      "type": "http",
      "url": "https://mcp.smartsheet.com",
      "headers": {
        "Authorization": "Bearer <SMARTSHEET_API_TOKEN>"
      }
    }
  }
}

Cette configuration utilise l'approche par jeton d'accès personnel (clé API). Pour les déploiements en production, OAuth est recommandé.

Ensemble SMARTSHEET_API_TOKEN à votre Smartsheet Personal Access Token dans votre environnement. Kiro charge les serveurs MCP en tant que processus en arrière-plan au démarrage. Une fois initialisé, les outils Smartsheet sont disponibles pour l'agent Kiro dans tous les modes : chat, planification de spécifications et automatisation basée sur des hooks. Tous les détails dans le Documentation du serveur MCP Smartsheet.

À partir de là, Kiro peut référencer les données Smartsheet dans le cadre des workflows de développement :

• « Consulte la feuille de projet Backend API pour trouver les bugs ouverts et génère une liste de corrections priorisée. »

Figure 7 : Kiro générant une liste de corrections priorisée à partir des bugs ouverts dans la feuille de projet Backend API

• « Récupère la feuille Roadmap T3 et crée une spécification pour les fonctionnalités marquées In Progress. »

Figure 8 : Kiro créant une spécification à partir des fonctionnalités en cours dans la feuille Roadmap T3

Gouvernance d'entreprise

Pour les développeurs déployant dans des environnements réglementés ou d'entreprise, le modèle de sécurité du Smartsheet MCP Server repose sur la même couche d'infrastructure et de permissions que l'API REST Smartsheet. Ce n'est pas une nouvelle frontière de confiance :

• Authentification OAuth 2.0 et Personal Access Token: choisissez la méthode d'authentification prise en charge par votre client MCP.
• Application des permissions au niveau utilisateur: les agents ne peuvent accéder qu'aux données que l'utilisateur authentifié est autorisé à voir. Aucune élévation de privilèges via des invites en langage naturel.
• Contrôles IA au niveau de l'organisation: les administrateurs système peuvent activer ou désactiver les fonctionnalités IA globalement. L'accès aux outils d'écriture est configurable par groupe d'utilisateurs.
• Transport HTTP streamable: l'ajout à la liste d'autorisation du pare-feu se fait par nom de domaine complet (FQDN) (mcp.smartsheet.com), et non par adresse IP.

Pour les architectes de conformité, le MCP Server ne stocke pas les invites, et le contenu des invites reste entre le client IA et le modèle. Smartsheet ne voit que les appels d'outils structurés et leurs résultats.

Nettoyage

Si vous avez suivi cette procédure pas à pas et souhaitez ensuite supprimer l'intégration, voici comment annuler chaque chemin :

Amazon Quick

1. Dans la console Amazon Quick, accédez à Connectors.
2. Sélectionnez votre connecteur Smartsheet.
3. Choisissez Delete pour supprimer la connexion. Cela révoque le token OAuth et met fin à l'accès des agents aux données Smartsheet.

Kiro

1. Ouvrez votre fichier de configuration MCP (.kiro/settings/mcp.json).
2. Supprimez l'entrée smartsheet-us du mcpServers objet.
3. Redémarrez Kiro pour décharger le serveur.

Prochaines étapes

Pour des informations générales sur le fonctionnement du serveur, consultez How Smartsheet built a remote MCP server on AWS. Après avoir connecté le Smartsheet MCP Server au système de votre choix, voici quatre actions que nous vous recommandons d’essayer :

Vous pouvez demander à l’agent de chat de surveiller vos feuilles de projet actives et d’identifier les lignes marquées Blocked ou At Risk. Vous pouvez également lui demander d’annoter les projets avec un commentaire de discussion et de livrer un résumé structuré à votre équipe via votre canal préféré. Voici un exemple de flux de travail qui enchaîne get_sheet_summary, search, et create_discussion_on_row.

L’agent peut également récupérer des données via le Smartsheet MCP Server pour rapprocher les statuts des tâches entre votre outil de suivi des incidents et votre plan de projet Smartsheet. Il peut signaler les divergences entre les deux et mettre à jour les lignes concernées, en utilisant get_sheet_summary, get_columns, update_rows, et create_discussion_on_row en séquence.

Vous pouvez également essayer d’agréger les signaux de santé des projets à partir de vos rapports et tableaux de bord. Vous pouvez l’utiliser pour produire un briefing structuré sans collecte manuelle de données, en vous appuyant sur list_reports, get_report, list_dashboards, get_dashboard, et search.

Enfin, vous pouvez utiliser l’agent pour faire suivre chaque écriture d’un commentaire de discussion expliquant ce qui a changé et pourquoi. Cela crée une piste d’audit lisible par l’humain dans Smartsheet grâce à la combinaison de update_rows et create_discussion_on_row.

Ces quatre modèles fonctionnent avec les chemins précédents : Amazon Quick pour les flux de travail destinés aux utilisateurs métier, et Kiro pour les actions initiées par les développeurs.

Vous construisez quelque chose avec Smartsheet MCP et AWS ? Partagez ce sur quoi vous travaillez dans les commentaires, ou retrouvez-nous sur la Smartsheet Developer Community.

À propos des auteurs