Smartsheet MCP サーバー
Smartsheetとのシームレスな統合を実現するモデルコンテキストプロトコル(MCP)サーバー。標準化されたインターフェースを通じてSmartsheetドキュメントの自動操作を可能にします。このサーバーは、AIを活用した自動化ツールとSmartsheetの強力なコラボレーションプラットフォーム間のギャップを埋めます。
概要
Smartsheet MCP Serverは、Smartsheetとのインテリジェントな連携を促進するように設計されており、ドキュメント管理、データ操作、列のカスタマイズのための堅牢なツールセットを提供します。自動化されたワークフローの重要なコンポーネントとして機能し、AIシステムがSmartsheetデータをプログラム的に操作しながら、データの整合性を維持し、ビジネスルールを適用できるようにします。
主なメリット
インテリジェントな統合: AIシステムをSmartsheetのコラボレーションプラットフォームにシームレスに接続します
データ整合性: 検証ルールを適用し、操作全体で参照整合性を維持します。
数式管理: 数式参照を自動的に保存および更新します
柔軟な構成: さまざまな列タイプと複雑なデータ構造をサポート
エラー耐性: 複数のレイヤーで包括的なエラー処理と検証を実装します
ヘルスケア分析:臨床および研究データに特化した分析機能
バッチ処理:大規模な医療データセットの効率的な処理
カスタムスコアリング:ヘルスケアの取り組みと研究のための柔軟なスコアリングシステム
ユースケース
臨床研究分析
プロトコルコンプライアンススコアリング
患者データ分析
研究影響評価
臨床試験データ処理
自動研究ノート要約
病院運営
リソース利用分析
患者満足度スコア
部門効率指標
スタッフのパフォーマンス分析
品質指標の追跡
ヘルスケアイノベーション
小児アライメントスコアリング
イノベーションの影響評価
研究の優先順位付け
実装実現可能性分析
臨床的価値評価
自動ドキュメント管理
プログラムによるシート構造の変更
動的な列の作成と管理
自動データ検証とフォーマット
データ操作
整合性チェックを伴う一括データ更新
インテリジェントな重複検出
数式を考慮した変更
システム統合
AIによるシートのカスタマイズ
自動レポートワークフロー
システム間のデータ同期
統合ポイント
サーバーは以下と統合されます:
データ操作用の Smartsheet API
標準化された通信のためのMCPプロトコル
stdioインターフェース経由のローカル開発ツール
構造化ログによるシステムの監視
建築
サーバーは、MCP と Smartsheet 間のブリッジ アーキテクチャを実装します。
TypeScript MCP レイヤー(
src/index.ts)MCPプロトコル通信を処理する
利用可能なツールを登録および管理します
リクエストをPython実装にルーティングする
構成とエラー処理を管理します
Python CLI レイヤー(
smartsheet_ops/cli.py)操作用のコマンドラインインターフェースを提供する
引数の解析と検証を処理する
重複検出を実装
JSONデータのフォーマットを管理する
コア操作レイヤー(
smartsheet_ops/__init__.py)Smartsheet APIインタラクションを実装
複雑な列タイプの管理を処理
データの正規化と検証を提供します
システム列と数式解析を管理します
列管理フロー
エラー処理フロー
特徴
ツール
get_column_map(読み取り)Smartsheet から列マッピングとサンプルデータを取得します
以下を含む詳細な列メタデータを提供します:
列の種類(システム列、数式、選択リスト)
検証ルール
フォーマット仕様
自動番号設定
コンテキストのサンプルデータを返します
データの書き込みに関する使用例が含まれています
smartsheet_write(作成)次の処理をインテリジェントに実行して、新しい行を Smartsheet に書き込みます。
システム管理の列
複数選択リストの値
数式ベースの列
自動重複検出を実装
行IDを含む詳細な操作結果を返します
smartsheet_update(更新)Smartsheet の既存の行を更新します
部分的な更新をサポート(特定のフィールドの変更)
検証によりデータの整合性を維持
複数選択フィールドを一貫して処理します
行ごとに成功/失敗の詳細を返します
smartsheet_delete(削除)Smartsheet から行を削除します
複数行の一括削除をサポート
行の存在と権限を検証します
詳細な操作結果を返します
smartsheet_add_column(列管理)Smartsheet に新しい列を追加します
すべての列タイプをサポートします:
テキスト番号
日付
チェックボックス
ピックリスト
連絡先リスト
設定可能なオプション:
位置インデックス
検証ルール
数式の定義
ピックリストオプション
検証により列制限(400)を強制する
詳細な列情報を返します
smartsheet_delete_column(列管理)依存関係をチェックしながら安全に列を削除します
削除前に数式参照を検証します
数式で使用されている列の削除を防止します
詳細な依存関係情報を返します
強制削除オプションをサポート
smartsheet_rename_column(列管理)関係性を維持しながら列の名前を変更します
数式参照を自動的に更新します
データの整合性を維持
名前の一意性を検証する
詳細な更新情報を返します
smartsheet_bulk_update(条件付き更新)ルールに基づいて条件付き一括更新を実行します
複雑な条件評価をサポートします:
複数の演算子 (equals、contains、greaterThan など)
型別の比較(テキスト、日付、数値)
空/空でない小切手
設定可能なサイズでのバッチ処理
包括的なエラー処理とロールバック
詳細な操作結果の追跡
start_batch_analysis(ヘルスケア分析)AI分析でシート全体または選択した行を処理します
複数の分析タイプをサポートします:
臨床記録の要約
患者のフィードバックの感情分析
ヘルスケアイニシアチブのカスタムスコアリング
研究影響評価
特徴:
自動バッチ処理(バッチあたり50行)
進捗状況の追跡とステータスの監視
詳細なレポートによるエラー処理
カスタマイズ可能な分析目標
複数のソース列のサポート
get_job_status(分析監視)
バッチ分析の進行状況を追跡します
詳細なジョブ統計を提供します:
処理する行の合計
処理された行数
失敗した行数
処理タイムスタンプ
リアルタイムのステータス更新
包括的なエラー報告
cancel_batch_analysis(ジョブ制御)
実行中のバッチ分析ジョブをキャンセルします
正常なプロセス終了
データの一貫性を維持する
最終的なジョブステータスを返します
主な機能
列タイプの管理
システム列タイプ (AUTO_NUMBER、CREATED_DATE など) を処理します
数式解析と依存関係の追跡をサポート
ピックリストオプションと複数選択値を管理します
包括的な列操作(追加、削除、名前変更)
数式参照の保存と更新
データ検証
自動重複検出
列の種類の検証
データ形式の検証
列依存性分析
名前の一意性の検証
メタデータ処理
列のメタデータを抽出して処理する
検証ルールを処理する
フォーマット仕様を管理する
数式の依存関係を追跡する
列の関係を維持する
ヘルスケア分析
臨床ノートの要約
患者のフィードバック感情分析
プロトコルコンプライアンススコアリング
研究影響評価
リソース利用分析
バッチ処理
自動行バッチ処理(バッチあたり 50 行)
進捗状況の追跡と監視
エラー処理と回復
カスタマイズ可能な処理目標
複数列分析のサポート
ジョブ管理
リアルタイムステータス監視
詳細な進捗状況の追跡
エラー報告とログ記録
求人キャンセルサポート
バッチ操作制御
設定
前提条件
Node.jsとnpm
Conda(環境管理用)
Smartsheet API アクセス トークン
環境設定
専用の conda 環境を作成します。
Node.js の依存関係をインストールします。
Python パッケージをインストールします。
TypeScript サーバーを構築します。
構成
サーバーはMCP設定で適切に設定する必要があります。Claude DesktopとClineの両方で使用できます。
1. Smartsheet APIキーを取得する
Smartsheetにログイン
アカウント→個人設定→APIアクセスへ移動
新しいアクセストークンを生成する
2. Cline 用の設定
構成パスはオペレーティング システムによって異なります。
macOS :
ウィンドウズ:
リナックス:
3. Claude Desktop 用の設定(オプション)
構成パスはオペレーティング システムによって異なります。
macOS :
ウィンドウズ:
リナックス:
サーバーの起動
ClineまたはClaude Desktopで必要なときにサーバーが自動的に起動します。ただし、テストのために手動で起動することもできます。
macOS/Linux :
ウィンドウズ:
インストールの確認
サーバーは起動時に「Smartsheet MCP server running on stdio」を出力する必要があります。
任意の MCP ツール(例:get_column_map)を使用して接続をテストします。
Python 環境に smartsheet パッケージがインストールされていることを確認します。
conda activate cline_mcp_env pip show smartsheet-python-sdk
使用例
列情報の取得(読み取り)
データの書き込み(作成)
データの更新(更新)
データの削除(削除)
ヘルスケア分析の例
列の管理
条件付き一括更新
smartsheet_bulk_updateツールは、強力な条件付き更新機能を提供します。以下に、単純なものから複雑なものまで、さまざまな例を示します。
単純な条件の例
型固有の比較
複雑な複数条件の例
一括更新操作では次の機能が提供されます。
オペレーターサポート:
equals: 正確な値の一致contains: 部分文字列の一致greaterThan: 数値/日付の比較lessThan: 数値/日付の比較isEmpty: null/空チェックisNotEmpty: 現在の値チェック
タイプ固有の機能:
TEXT_NUMBER: 文字列と数値の比較
DATE: ISO日付の解析と比較
ピックリスト: オプション検証
チェックボックス: ブール処理
処理オプション:
batchSize: 更新バッチサイズを制御する(デフォルトは500)lenientMode: エラーが発生しても続行するリクエストごとに複数のルール
ルールごとに複数の更新
結果追跡:
試行された行の合計数
成功/失敗のカウント
詳細なエラー情報
行ごとの障害の詳細
発達
自動リビルドを使用した開発の場合:
デバッグ
MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。サーバーは包括的なエラーログを実装し、MCPプロトコルを通じて詳細なエラーメッセージを提供します。
主なデバッグ機能:
stderrへのエラーログ
MCP 応答の詳細なエラー メッセージ
複数レベルでの型検証
包括的な運用結果レポート
列操作の依存性分析
数式参照の追跡
エラー処理
サーバーは、多層エラー処理アプローチを実装します。
MCPレイヤー
ツールパラメータを検証する
プロトコルレベルのエラーを処理する
フォーマットされたエラー応答を提供する
タイムアウトと再試行を管理する
CLIレイヤー
コマンド引数を検証する
実行エラーを処理する
エラーメッセージをJSONとしてフォーマットします
列操作を検証する
運用レイヤー
Smartsheet API エラーを処理します
データ型と形式を検証する
詳細なエラーコンテキストを提供する
列の依存関係を管理する
数式参照を検証する
データの整合性を保証する
貢献
貢献を歓迎します!以下の点にご注意ください。
TypeScript/Pythonコードは既存のスタイルに従います
新しい機能には適切なエラー処理が含まれる
変更により下位互換性が維持される
更新には適切なドキュメントが含まれます
列操作はデータの整合性を維持します
数式参照は適切に処理されます
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Smartsheet とのシームレスな統合を提供し、AI を活用した自動化ツールと Smartsheet のコラボレーション プラットフォームを橋渡しする標準化されたインターフェースを通じて、Smartsheet ドキュメントに対する自動操作を可能にします。
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityProvides integration with OpenRouter.ai, allowing access to various AI models through a unified interface.Last updated -5861Apache 2.0
- -security-license-qualityEnables integration with Google Drive for listing, reading, and searching over files, supporting various file types with automatic export for Google Workspace files.Last updated -63452MIT License
- -security-license-qualityIntegrates with Google Drive to enable listing, searching, and reading files, plus reading and writing to Google Sheets.Last updated -196210MIT License
- -security-license-qualityIntegrates with Google Drive to enable listing, reading, and searching over files, with automatic export of Google Workspace documents to appropriate formats.Last updated -634