AWS Machine Learning出典公開日

AWS上のSmartsheet MCPによるAIエージェント向けワークフローコンテキスト

AIエージェントは、組織全体で行われている実際の業務に基づいて行動できるときに最も役立ちます。プロジェクトや業務の運営には、プロジェクトのタイムラインの更新、タスクの再割り当て、ステータスの可視化といった複雑な部門横断的なタスクが伴います。

AIエージェントは、組織全体で行われている実際の業務に基づいて行動できるときに最も役立ちます。プロジェクトや業務の運営には、プロジェクトのタイムラインの更新、タスクの再割り当て、ステータスの可視化といった複雑な部門横断的なタスクが伴います。AIエージェントは、誰もツールを切り替えることなく、これらの作業をサポートできます。 Smartsheet 一般提供(GA)となったModel Context Protocol(MCP)サーバーを発表しました。

とともに Smartsheet MCPサーバー, AIアシスタントは標準化されたプロトコルを通じてSmartsheetデータの読み取り、書き込み、管理を行うことができます。このプロトコルは、シート、行、列、オートメーションの探索・作成・管理のための40以上のツールを網羅しています。自然言語を通じて、タスクステータスの更新、行の作成、プロジェクト構造の変更を直接行うことができます。

この記事では、既存のワークフローに接続する2つの方法を紹介します。 Amazon Quick ビジネスユーザー、プロジェクトマネージャー、オペレーションチーム向けに構築されたエージェント型AIワークスペースです。ユーザーはコードを書かずに、自然言語で質問したり、シートを更新したり、ダッシュボードを構築したりできます。 Kiro は、開発者がMCPを通じてSmartsheetに接続し、コーディングのワークフローを離れることなくプロジェクトの仕様を参照したり、タスクのステータスを更新したり、依存関係を追跡したりできるエージェント型IDEです。

アーキテクチャの概要

以下の図は、Smartsheet MCP Server が AWS サービスに接続する中央の統合レイヤーとしてどのように位置しているかを示しています。Amazon Quick と Kiro は MCP クライアントとして直接接続します。

Amazon Quick は、自然言語を通じて Smartsheet の照会、更新、自動化を行いたいナレッジワーカー、プロジェクトマネージャー、オペレーションチームに対応します。Kiro を使えば、開発者はコーディングのワークフローを離れることなく、プロジェクトの仕様を参照し、タスクのステータスを更新し、依存関係を追跡できます。

以下のアーキテクチャ図は、これらの統合パスを示しています。中央に Smartsheet MCP Server があり、左側には MCP クライアントとして Amazon Quick と Kiro、右側には Smartsheet の API とデータレイヤーが配置されています。

Figure 1: Smartsheet MCP Serverのアーキテクチャ。Amazon QuickとKiroからのMCPクライアント接続が、サーバーを経由してSmartsheet APIレイヤーに接続される様子を示しています

Amazon Quick と Kiro によるスプリント管理

タスク、担当者、ステータス、ブロッカーがすべてプロジェクトシートに集約された状態で、Smartsheet でスプリントを管理するソフトウェアエンジニアリングチームを考えてみましょう。同じチームにとって、各パスがどのようなものになるかを以下に示します:

プロジェクトマネージャーなどのユーザーが今週どのスプリントタスクがブロックされているかを確認したい場合、自然言語でAmazon Quickに質問できます。Amazon QuickのチャットエージェントがSmartsheet MCP Serverにクエリを発行し、該当する行を取得して、担当者名と期日を含む要約を表示します。応答はレポートやダッシュボードを作成することなく、ライブのSmartsheetデータから生成されます。

バグ修正や機能開発に取り組む開発者は、Kiroに現在のスプリントシートを取得させ、自分に割り当てられた未完了のバックエンドタスクを表示するよう依頼できます。KiroはMCP経由でSmartsheetにクエリを実行し、リストをインラインで表示します。修正がコミットされると、Kiroのフックが自動的に該当行のステータスをCompleteに更新します。

前提条件

Smartsheet MCP Serverは、行の関係、列の型、セルの履歴、コメントを含む、正確に構造化されたコンテキストを提供します。これにより、生のAPIペイロードを返すのではなく、トークン効率の高いペイロードサイズが実現します。このエンジニアリング上の判断により、プロジェクトポートフォリオ全体で何百ものAI支援クエリを実行する際に、規模に応じてコスト削減とレイテンシー改善が積み重なります。SmartsheetがどのようにAWS上にリモートMCPサーバーを構築したかについては、以下をご覧ください。 SmartsheetはどのようにAWS上にリモートMCPサーバーを構築したか.

Smartsheet MCP Server を Amazon Quick および Kiro に接続する前に、以下が揃っていることを確認してください:

  • 接続するサービス(Amazon Quick、またはKiro)に適切なAWS Identity and Access Management (IAM) 権限を持つアクティブなAWSアカウント
  • Business、Enterprise、または AWM プランの Smartsheet アカウント。
  • お客様のクライアントがOAuthフローに対応している場合は、Smartsheetのパーソナルアクセストークン、またはOAuth認証情報をご用意ください。
  • Amazon Quick の場合: Amazon Quick アカウントの Author 以上の権限が必要です。
  • Kiro の場合: からインストールした Kiro IDE kiro.dev with Node.js お使いの環境で利用可能です。

Smartsheet MCP Serverは、3つのリージョンエンドポイントで利用可能です。Streamable HTTPトランスポート(MCP spec versions 2025-06-18 および 2025-03-26)を使用し、OAuth 2.0またはPersonal Access Tokenで認証されます。

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

どちらのオプションも同じSmartsheetツールセットを提供します。どちらを選ぶかは、作業をどこで行うかによって異なります:

チーム全体が利用できるフルマネージドの組織全体ソリューションが必要な場合は、Amazon Quickを選んでください。アプリ登録不要で、事前構築済みのOAuthのみを使用し、企業内のナレッジワーカー全体にスケールします。

インフラ不要で、設定ファイルとPersonal Access Tokenだけで済む軽量なソリューションを望む開発者で、自分自身のワークフローに限定したい場合は、Kiroを選んでください。

Amazon Quick integration

Amazon Quick は、ディレクトリにプリビルトコネクタとして Smartsheet を含んでいます。つまり、プロジェクトのステータスの読み取り、行の更新、ディスカッションの作成、リスクの可視化をすべて、ビジネスユーザーがすでに作業に使っている同じインターフェース内で行えるということです。

Amazon Quick は、その統合を組織全体で利用できるようにします。対象は、プロジェクトマネージャーや運用チームから、Smartsheet で業務を管理するビジネスユーザーにまで及びます。

Quick 統合を追加するには:

  1. そこで Amazon Quick コンソールに移動します コネクタ そして、ディレクトリでSmartsheetを探します。

Figure 2: Amazon Quick Connectorsディレクトリ内のSmartsheetコネクタ

  1. 「Select the」 Smartsheetコネクタ タイル。
  2. 以下の統合の詳細を入力してください:
    1. 名前 – Smartsheet連携のわかりやすい名前。
    2. 維持してください 接続タイプ および 認証設定 設定はそのままにします。
    3. ベースURL – https://mcp.smartsheet.com.
    4. クライアントID 「– お使いのSmartsheet Developer Toolsアプリ登録のアプリクライアントID。」
    5. クライアントシークレット – お使いの Smartsheet Developer Tools アプリ登録の App secret。
    6. トークンURL – https://api.smartsheet.com/2.0/token.
    7. 認証URL – https://app.smartsheet.com/b/authorize.

図3:Amazon QuickでSmartsheetの接続詳細を入力する

  1. 選択 次へ.
  2. その ツールと権限を管理 ページに、利用可能なツールのリストが表示されます。選択してください 次へ.

図4:Smartsheetコネクタの「ツールと権限の管理」ページ

  1. その 公開 ページで、この接続にアクセスできるユーザーを選択し、その後、「 公開.

Figure 5:公開ページでSmartsheet接続にアクセスできるユーザーを選択するところ

  1. 選択 次へ.

接続すると、Amazon Quick のチャットエージェントが自然言語を通じて Smartsheet のデータを操作できるようになります:

  • 「私たちのポートフォリオの中で、現在リスクあり(At Risk)とされているプロジェクトはどれですか?」
  • 「Backend APIシートの認証タスクのステータスをCompleteに更新して。」
  • 「第3四半期(Q3)ロードマップ全体の期限超過項目の要約を作成し、チームに送信してください。」

図6:Amazon Quick チャットが、Smartsheet のプロジェクトシートから期限超過のタスクを要約し、主要な所見と推奨アクションを提示した応答の例

Kiro 統合

Kiro 開発者がコードと併せて、コンテキストを切り替えることなく、開発環境の中で直接Smartsheetのプロジェクト情報を利用したい場合に適した選択肢です。

Kiroは仕様駆動開発を中心に構築されています。高レベルなプロンプトを構造化された仕様に変換し、さらに動作するコード、ドキュメント、テストへと変換します。MCPサーバーは、ドキュメント、データベース、API、エンタープライズシステムに接続することでKiroが現実世界のコンテキストを取得し、学習時の知識ではなくライブデータに基づいてエージェントを動作させる仕組みです。

powersと呼ばれるKiroの機能は、厳選されたMCPサーバーをステアリングファイルやフックとともにパッケージ化した、ワンクリックでインストールできるバンドルです。これにより、Kiroのコーディングエージェントにすぐに使える新しい能力が与えられます。Smartsheetの場合、接続の設定は単一のJSON設定ブロックだけで済み、それ以降、Kiroエージェントは開発ワークフローの一部として最新のプロジェクトデータを参照できるようになります。

Smartsheet MCPサーバーをKiroに接続するには、KiroのMCP構成に追加します(.kiro/settings/mcp.json 「ワークスペーススコープの場合)。完全な手順については、」 KiroとMCPサーバー入門:

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

この構成ではPersonal Access Token(APIキー)方式を使用します。本番環境へのデプロイには、OAuthが推奨されます。

セット SMARTSHEET_API_TOKEN 環境内のSmartsheetパーソナルアクセストークンに接続します。Kiroは起動時にMCPサーバーをバックグラウンドプロセスとして読み込みます。初期化が完了すると、Smartsheetツールはチャット、スペック計画、フックベースの自動化など、すべてのモードでKiroエージェントから利用可能になります。詳細については、 Smartsheet MCPサーバー ドキュメント.

そこから、Kiro は開発ワークフローの一部として Smartsheet のデータを参照できます。

  • 「バックエンドAPIプロジェクトシートを確認して、未解決のバグを調べ、優先順位付きの修正リストを作成してください。」

Figure 7: KiroがBackend APIプロジェクトシートの未解決バグから優先順位付き修正リストを生成している様子

  • 「第3四半期(Q3)のロードマップシートを取り出して、In Progressマークが付いた機能の仕様書を作成して。」

図8: KiroがQ3ロードマップシートの進行中の機能からspecを作成している様子

エンタープライズガバナンス

規制された環境やエンタープライズ環境にデプロイする開発者にとって、Smartsheet MCP Server のセキュリティモデルは、Smartsheet REST API と同じインフラストラクチャおよび権限レイヤーの上に構築されています。新しい信頼境界ではありません。

  • OAuth 2.0およびパーソナルアクセストークン認証: お使いのMCPクライアントがサポートする認証方式を選択してください。
  • ユーザーレベルの権限強制: エージェントは認証されたユーザーが閲覧権限を持つデータにのみアクセスできます。自然言語プロンプトによる権限昇格は行えません。
  • 組織レベルのAI管理「: システム管理者はAI機能をグローバルにオンまたはオフにできます。書き込みツールへのアクセスはユーザーグループごとに設定可能です。」
  • Streamable HTTPトランスポート「: ファイアウォールの許可リストは IP アドレスではなく、完全修飾ドメイン名 (FQDN)(mcp.smartsheet.com)によって行われます。」

コンプライアンスアーキテクトにとって、MCP Serverはプロンプトを保存せず、プロンプトの内容はAIクライアントとモデルの間にとどまります。Smartsheetが見るのは、構造化されたツール呼び出しその結果のみです。

クリーンアップ

このウォークスルーに従った後、統合を後で取り除きたい場合は、それぞれの方法を元に戻す手順は以下のとおりです:

Amazon Quick

  1. Amazon Quick コンソールで、次の場所に移動します コネクタ.
  2. Smartsheetコネクタを選択します。
  3. 選択 削除 接続を削除します。これによりOAuthトークンが取り消され、エージェントによるSmartsheetデータへのアクセスが停止されます。

Kiro

  1. MCP設定ファイルを開きます(.kiro/settings/mcp.json).
  2. 削除してください smartsheet-us 以下からのエントリー: mcpServers オブジェクト。
  3. サーバーをアンロードするには、Kiroを再起動してください。

次のステップ

サーバーの仕組みに関する背景情報については、以下を参照してください SmartsheetがどのようにAWS上にリモートMCPサーバーを構築したかお好みのシステムに Smartsheet MCP Server を接続した後、試してみることをおすすめする4つのアクションをご紹介します:

チャットエージェントに、アクティブなプロジェクトシートの監視や、Blocked または At Risk とマークされた行の特定を依頼できます。ディスカッションコメントでプロジェクトに注記を付けることや、好みのチャネルを通じてチームに構造化されたサマリーを配信することも依頼できます。これは、以下を連鎖させるワークフローの例です。 get_sheet_summary, search、および create_discussion_on_row.

エージェントは Smartsheet MCP Server を通じてデータを取得し、イシュートラッカーと Smartsheet プロジェクトプランの間でタスクのステータスを突き合わせることもできます。両者の間のズレを検出し、影響を受けた行を更新できます。その際に使用するのは get_sheet_summary, get_columns, update_rows、および create_discussion_on_row 順番に。

レポートやダッシュボード全体でプロジェクトの健全性シグナルを集約してみることもできます。手動でのデータ収集を行わずに、以下を活用して構造化されたブリーフィングを作成できます。 list_reports, get_report, list_dashboards, get_dashboard、および search.

最後に、エージェントを使って、すべての書き込みの後に、何が変更され、なぜ変更されたのかを説明するディスカッションコメントを追記させることができます。これにより、以下の組み合わせを通じて、Smartsheet 内に人間が読める監査証跡が作成されます。 update_rows および create_discussion_on_row.

これら4つのパターンはすべて、前述の各パスで機能します。ビジネスユーザー向けのワークフローにはAmazon Quick、開発者が開始するアクションにはKiroが対応します。

Smartsheet MCP と AWS で何かを作っていますか?取り組んでいる内容をコメントで共有するか、までご連絡ください。 Smartsheet 開発者コミュニティ.


著者について

原文の出典

AWS Machine Learning

内容について

原文の公開と権利は出典元に帰属します。

機械翻訳 · 原文をご参照ください