Workflow-Kontext für KI-Agenten mit Smartsheet MCP auf AWS

KI-Agenten sind am nützlichsten, wenn sie auf die echte Arbeit reagieren können, die in Ihrer Organisation stattfindet. Die Durchführung von Projekten und Operations umfasst komplexe, funktionsübergreifende Aufgaben wie das Aktualisieren von Projektzeitplänen, das Neuzuweisen von Aufgaben und das Aufzeigen des Status. KI-Agenten können Sie dabei unterstützen, ohne dass jemand die Tools wechseln muss. Smartsheet hat einen allgemein verfügbaren Model Context Protocol (MCP) Server veröffentlicht.

Mit dem Smartsheet MCP Server, können KI-Assistenten Smartsheet-Daten über ein standardisiertes Protokoll lesen, schreiben und verwalten. Das Protokoll umfasst mehr als 40 Tools zum Erkunden, Erstellen und Verwalten von Sheets, Zeilen, Spalten und Automatisierungen. Sie können Aufgabenstatus aktualisieren, Zeilen erstellen und die Projektstruktur direkt über natürliche Sprache ändern.

In diesem Beitrag gehen wir zwei Wege durch, wie Sie ihn an Ihre bestehenden Workflows anbinden können. Amazon Quick ist ein agentic AI Workspace für Geschäftsanwender, Projektmanager und Operations-Teams. Sie können Fragen stellen, Sheets aktualisieren und Dashboards über natürliche Sprache erstellen, ohne Code zu schreiben. Kiro ist eine agentische IDE, in der Entwickler über MCP eine Verbindung zu Smartsheet herstellen, um auf Projektvorgaben zu verweisen, den Aufgabenstatus zu aktualisieren und Abhängigkeiten zu verfolgen, ohne ihren Coding-Workflow zu verlassen.

Architekturübersicht

Das folgende Diagramm zeigt, wie der Smartsheet MCP Server als zentrale Integrationsschicht fungiert, die sich mit AWS-Services verbindet. Amazon Quick und Kiro verbinden sich direkt als MCP-Clients.

Amazon Quick richtet sich an Wissensarbeiter, Projektmanager und Operations-Teams, die Smartsheet über natürliche Sprache abfragen, aktualisieren und automatisieren möchten. Mit Kiro können Entwickler auf Projektvorgaben verweisen, den Aufgabenstatus aktualisieren und Abhängigkeiten verfolgen, ohne ihren Coding-Workflow zu verlassen.

Das folgende Architekturdiagramm veranschaulicht diese Integrationspfade: der Smartsheet MCP Server in der Mitte, mit Amazon Quick und Kiro als MCP-Clients auf der linken Seite und der Smartsheet-API- und Datenschicht auf der rechten Seite.

Abbildung 1: Smartsheet MCP Server-Architektur, die MCP-Client-Verbindungen von Amazon Quick und Kiro über den Server zur Smartsheet-API-Schicht zeigt

Sprint-Management mit Amazon Quick und Kiro

Betrachten wir ein Software-Engineering-Team, das seinen Sprint in Smartsheet verfolgt. Aufgaben, Verantwortliche, Status und Blocker befinden sich alle in einem Projekt-Sheet. So sieht jeder Pfad für dasselbe Team aus:

Wenn ein Nutzer, etwa ein Projektmanager, überprüfen möchte, welche Sprint-Aufgaben in dieser Woche blockiert sind, kann er Amazon Quick über natürliche Sprache fragen. Der Amazon Quick Chat-Agent fragt den Smartsheet MCP Server ab, zieht die relevanten Zeilen und liefert eine Zusammenfassung mit Namen der Verantwortlichen und Fälligkeitsdaten. Die Antwort wird aus Live-Smartsheet-Daten generiert, ohne dass ein Bericht oder Dashboard erstellt werden muss.

Entwickler, die Fehler beheben oder an Features arbeiten, können Kiro bitten, das aktuelle Sprint-Sheet abzurufen und ihnen die offenen Backend-Aufgaben anzuzeigen, die ihnen zugewiesen sind. Kiro fragt Smartsheet über MCP ab und zeigt die Liste inline an. Wenn der Fix committet wird, aktualisiert ein Kiro-Hook automatisch den Status der entsprechenden Zeile auf Complete.

Voraussetzungen

Der Smartsheet MCP Server liefert präzise strukturierten Kontext, einschließlich Zeilenbeziehungen, Spaltentypen, Zellenhistorie und Kommentaren. Dies führt zu token-effizienten Payload-Größen, anstatt rohe API-Payloads zurückzugeben. Diese technische Entscheidung wirkt sich bei hunderten KI-gestützter Abfragen über ein Projektportfolio hinweg auf Skalenebene in reduzierten Kosten und verbesserter Latenz aus. Um zu erfahren, wie Smartsheet ihren remote MCP Server auf AWS aufgebaut hat, siehe How Smartsheet built a remote MCP server on AWS.

Bevor Sie den Smartsheet MCP Server mit Amazon Quick und Kiro verbinden, stellen Sie sicher, dass Sie Folgendes eingerichtet haben:

• Ein aktives AWS-Konto mit geeigneten AWS Identity and Access Management (IAM)-Berechtigungen für den Service, den Sie anbinden (Amazon Quick oder Kiro)
• Ein Smartsheet-Konto mit einem Business-, Enterprise- oder AWM-Plan.
• Ein Smartsheet Personal Access Token oder OAuth-Anmeldedaten, falls Ihr Client den OAuth-Ablauf unterstützt.
• Für Amazon Quick: Author- oder höhere Berechtigungen in Ihrem Amazon Quick-Konto.
• Für Kiro: Kiro IDE installiert von kiro.dev mit Node.js in Ihrer Umgebung verfügbar.

Der Smartsheet MCP Server ist an drei regionalen Endpunkten verfügbar. Er nutzt Streamable HTTP Transport (MCP spec versionen 2025-06-18 und 2025-03-26) und wird entweder mit OAuth 2.0 oder einem Personal Access Token authentifiziert.

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

Beide Optionen stellen dasselbe Smartsheet-Toolset bereit. Die richtige Wahl hängt davon ab, wo Ihre Arbeit stattfindet:

Wählen Sie Amazon Quick, wenn Sie eine vollständig verwaltete, organisationsweite Lösung benötigen, die Ihr gesamtes Team nutzen kann: keine App-Registrierung, nur vorgefertigtes OAuth, und es skaliert über Wissensarbeiter in Ihrem Unternehmen.

Wählen Sie Kiro, wenn Sie ein Entwickler sind, der eine schlanke Lösung möchte: keine Infrastruktur, nur eine Konfigurationsdatei und ein persönliches Zugriffstoken, zugeschnitten auf Ihren eigenen Workflow.

Amazon Quick integration

Amazon Quick enthält Smartsheet als vorgefertigten Connector in seinem Verzeichnis. Das bedeutet: Projektstatus lesen, Zeilen aktualisieren, Diskussionen erstellen und Risiken aufzeigen – alles in derselben Oberfläche, in der Ihre Geschäftsanwender bereits arbeiten.

Amazon Quick stellt diese Integration organisationsweit bereit, von Projektmanagern und Operationsteams bis hin zu Geschäftsanwendern, die ihre Arbeit in Smartsheet verwalten.

So fügen Sie die Quick-Integration hinzu:

1. Navigieren Sie in der Amazon Quick consolezu Connectors und suchen Sie Smartsheet im Verzeichnis.

Abbildung 2: Der Smartsheet-Connector im Amazon Quick Connectors-Verzeichnis

1. Wählen Sie die Kachel Smartsheet connector aus.
2. Geben Sie die folgenden Integrationsdetails ein:
   1. Name – Beschreibender Name für Ihre Smartsheet-Integration.
   2. Belassen Sie die Einstellungen Connection type und Auth configuration wie sie sind.
   3. Base URL – https://mcp.smartsheet.com.
   4. Client ID – App-Client-ID aus Ihrer App-Registrierung in den Smartsheet Developer Tools.
   5. Client Secret – App-Secret aus Ihrer App-Registrierung in den Smartsheet Developer Tools.
   6. Token URL – https://api.smartsheet.com/2.0/token.
   7. Auth URL – https://app.smartsheet.com/b/authorize.

Abbildung 3: Eingabe der Smartsheet-Verbindungsdetails in Amazon Quick

1. Wählen Sie Weiter.
2. Auf der Manage Tools & Permissions -Seite sehen Sie eine Liste der verfügbaren Tools. Wählen Sie Weiter.

Abbildung 4: Die Seite „Manage Tools and Permissions“ für den Smartsheet-Connector

1. Auf der Publish -Seite legen Sie fest, wer auf diese Verbindung zugreifen kann, und wählen dann Publish.

Abbildung 5: Auswählen, wer auf der Publish-Seite auf die Smartsheet-Verbindung zugreifen kann

1. Wählen Sie Weiter.

Nachdem die Verbindung hergestellt wurde, kann Ihr Amazon Quick Chat-Agent mit Smartsheet-Daten über natürliche Sprache arbeiten:

• „Welche Projekte in unserem Portfolio sind derzeit At Risk?“
• „Aktualisiere den Status der Authentifizierungsaufgabe im Backend-API-Sheet auf Complete.“
• „Erstelle eine Zusammenfassung aller überfälligen Elemente im Q3 Roadmap und sende sie an das Team.“

Abbildung 6: Amazon Quick Chat-Antwort, die überfällige Aufgaben aus einem Smartsheet-Projektsheet mit wichtigsten Beobachtungen und empfohlenen Maßnahmen zusammenfasst

Kiro-Integration

Kiro ist der richtige Weg, wenn Entwickler Smartsheet-Projektkontext direkt in ihrer Entwicklungsumgebung, neben ihrem Code, verfügbar haben möchten, ohne den Kontext wechseln zu müssen.

Kiro basiert auf spec-driven development. Es wandelt Prompts auf hoher Ebene in strukturierte Specs und daraus in funktionierenden Code, Dokumentation und Tests um. MCP-Server sind die Art und Weise, wie Kiro echten Weltkontext erhält, indem es sich mit Dokumentation, Datenbanken, APIs und Enterprise-Systemen verbindet, um seinen Agenten auf Live-Daten statt auf Trainingszeit-Wissen zu stützen.

Eine Kiro-Funktion namens powers ist ein per Klick installierbares Paket, das einen kuratierten MCP-Server zusammen mit Steering-Dateien und Hooks bündelt. Es verleiht dem Kiro-Coding-Agenten eine neue Fähigkeit ab Werk. Für Smartsheet erfordert die Konfiguration der Verbindung nur einen einzigen JSON-Konfigurationsblock, und von diesem Zeitpunkt an kann der Kiro-Agent im Rahmen eines Entwicklungsworkflows auf Live-Projektdaten verweisen.

Um den Smartsheet MCP Server mit Kiro zu verbinden, fügen Sie ihn Ihrer Kiro MCP-Konfiguration hinzu (.kiro/settings/mcp.json für Workspace-Scope). Eine vollständige Anleitung finden Sie unter Getting Started with Kiro and MCP Servers:

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

Diese Konfiguration verwendet den Personal Access Token (API key)-Ansatz. Für Produktionsumgebungen wird OAuth empfohlen.

Set SMARTSHEET_API_TOKEN Token für Smartsheet Personal Access Token in Ihrer Umgebung. Kiro lädt MCP-Server beim Start als Hintergrundprozesse. Nach der Initialisierung stehen die Smartsheet-Tools dem Kiro-Agenten in allen Modi zur Verfügung: Chat, Spec-Planung und Hooks-basierte Automatisierung. Vollständige Details in der Smartsheet MCP Server Dokumentation.

Von dort aus kann Kiro auf Smartsheet-Daten als Teil von Entwicklungs-Workflows verweisen:

• „Sieh dir das Projektblatt der Backend-API offene Bugs an und erstelle eine priorisierte Fix-Liste.“

Abbildung 7: Kiro erstellt eine priorisierte Liste mit Fehlerbehebungen aus offenen Bugs im Projekt-Backend API

• „Ziehe das Q3-Roadmap-Sheet und erstelle eine Spezifikation für die Features, die als In Progress markiert sind.“

Abbildung 8: Kiro erstellt eine Spec aus den laufenden Features im Q3-Roadmap-Sheet

Enterprise-Governance

Für Entwickler, die in regulierten oder Enterprise-Umgebungen deployen, basiert das Sicherheitsmodell des Smartsheet MCP Server auf derselben Infrastruktur- und Berechtigungsschicht wie die Smartsheet REST API. Es handelt sich nicht um eine neue Vertrauensgrenze:

• OAuth 2.0- und Personal Access Token-Authentifizierung: wählen Sie die von Ihrem MCP-Client unterstützte Authentifizierungsmethode.
• Durchsetzung von Berechtigungen auf Benutzerebene: Agents können nur auf Daten zugreifen, die der authentifizierte Benutzer sehen darf. Keine Rechteausweitung durch Prompts in natürlicher Sprache.
• KI-Kontrollen auf Organisationsebene: Systemadministratoren können KI-Funktionen global ein- oder ausschalten. Der Zugriff auf Write-Tools ist pro Benutzergruppe konfigurierbar.
• Streamable HTTP Transport: Das Firewall-Allowlisting erfolgt über den vollqualifizierten Domänennamen (FQDN) (mcp.smartsheet.com), nicht über die IP-Adresse.

Für Compliance-Architekten: Der MCP Server speichert keine Prompts, und der Prompt-Inhalt bleibt zwischen dem KI-Client und dem Modell. Smartsheet sieht nur die strukturierten Tool-Aufrufe und deren Ergebnisse.

Aufräumen

Wenn Sie dieser Anleitung gefolgt sind und die Integration anschließend entfernen möchten, so heben Sie die einzelnen Wege wieder auf:

Amazon Quick

1. Navigieren Sie in der Amazon Quick-Konsole zu Connectors.
2. Wählen Sie Ihren Smartsheet-Connector aus.
3. Wählen Sie Delete aus, um die Verbindung zu entfernen. Dadurch wird das OAuth-Token widerrufen und der Agent-Zugriff auf Smartsheet-Daten gestoppt.

Kiro

1. Öffnen Sie Ihre MCP-Konfigurationsdatei (.kiro/settings/mcp.json).
2. Entfernen Sie den smartsheet-us -Eintrag aus der mcpServers object.
3. Starten Sie Kiro neu, um den Server zu entladen.

Nächste Schritte

Hintergrundinformationen zur Funktionsweise des Servers finden Sie unter How Smartsheet built a remote MCP server on AWS. Nachdem Sie den Smartsheet MCP Server mit dem System Ihrer Wahl verbunden haben, empfehlen wir Ihnen, die folgenden vier Aktionen auszuprobieren:

Sie können den Chat-Agenten bitten, Ihre aktiven Projekt-Tabellen zu überwachen und Zeilen zu identifizieren, die mit Blocked oder At Risk markiert sind. Sie können auch darum bitten, Projekte mit einem Diskussionskommentar zu versehen und eine strukturierte Zusammenfassung über Ihren bevorzugten Kanal an Ihr Team zu übermitteln. Dies wäre ein Beispiel-Workflow, der get_sheet_summary, search, und create_discussion_on_row.

verkettet. Der Agent kann zudem Daten über den Smartsheet MCP Server abrufen, um Aufgabenstatus zwischen Ihrem Issue-Tracker und Ihrem Smartsheet-Projektablauf abzugleichen. Er kann Abweichungen zwischen beiden kennzeichnen und die betroffenen Zeilen aktualisieren, indem er get_sheet_summary, get_columns, update_rows, und create_discussion_on_row der Reihe nach verwendet.

Sie können außerdem versuchen, projektbezogene Zustandssignale über Ihre Berichte und Dashboards hinweg zu aggregieren. Damit lässt sich ein strukturiertes Briefing ohne manuelle Datenerfassung erstellen, das auf list_reports, get_report, list_dashboards, get_dashboard, und search.

zugreift. Schließlich können Sie den Agenten nutzen, um jedem Schreibvorgang einen Diskussionskommentar folgen zu lassen, der erklärt, was sich geändert hat und warum. Dies schafft einen gut lesbaren Audit-Trail in Smartsheet durch die Kombination von update_rows und create_discussion_on_row.

Alle vier Muster funktionieren über die zuvor genannten Pfade hinweg: Amazon Quick für Workflows für Geschäftsanwender und Kiro für Entwickler-initiierte Aktionen.

Bauen Sie etwas mit Smartsheet MCP und AWS? Teilen Sie mit, woran Sie arbeiten, in den Kommentaren, oder treten Sie mit uns in Kontakt in der Smartsheet Developer Community.

Über die Autoren