Сервер Smartsheet MCP
Сервер Model Context Protocol (MCP), который обеспечивает бесшовную интеграцию с Smartsheet, позволяя выполнять автоматизированные операции с документами Smartsheet через стандартизированный интерфейс. Этот сервер заполняет пробел между инструментами автоматизации на базе ИИ и мощной платформой совместной работы Smartsheet.
Обзор
Сервер Smartsheet MCP предназначен для упрощения интеллектуального взаимодействия со Smartsheet, предоставляя надежный набор инструментов для управления документами, операций с данными и настройки столбцов. Он служит критически важным компонентом в автоматизированных рабочих процессах, позволяя системам ИИ программно взаимодействовать с данными Smartsheet, сохраняя при этом целостность данных и обеспечивая соблюдение бизнес-правил.
Основные преимущества
- Интеллектуальная интеграция : бесшовное подключение систем искусственного интеллекта к платформе совместной работы Smartsheet
- Целостность данных : обеспечивает соблюдение правил проверки и поддерживает ссылочную целостность во всех операциях.
- Управление формулами : автоматически сохраняет и обновляет ссылки на формулы.
- Гибкая конфигурация : поддерживает различные типы столбцов и сложные структуры данных.
- Устойчивость к ошибкам : реализует комплексную обработку ошибок и проверку на нескольких уровнях.
- Аналитика в здравоохранении : специализированные возможности анализа клинических и исследовательских данных
- Пакетная обработка : эффективная обработка больших наборов медицинских данных
- Индивидуальная оценка : гибкие системы оценки для инициатив и исследований в сфере здравоохранения
Варианты использования
- Аналитика клинических исследований
- Оценка соответствия протоколу
- Анализ данных пациентов
- Оценка влияния исследования
- Обработка данных клинических испытаний
- Автоматизированное резюмирование исследовательских заметок
- Больничные операции
- Анализ использования ресурсов
- Оценка удовлетворенности пациентов
- Показатели эффективности отдела
- Аналитика эффективности работы персонала
- Отслеживание показателей качества
- Инновации в здравоохранении
- Оценка педиатрического выравнивания
- Оценка влияния инноваций
- Приоритетность исследований
- Анализ осуществимости реализации
- Оценка клинической ценности
- Автоматизированное управление документами
- Программные изменения структуры листа
- Динамическое создание и управление столбцами
- Автоматическая проверка и форматирование данных
- Операции с данными
- Массовые обновления данных с проверкой целостности
- Интеллектуальное обнаружение дубликатов
- Модификации с учетом формулы
- Системная интеграция
- Настройка листов с помощью ИИ
- Автоматизированные рабочие процессы отчетности
- Синхронизация данных между системами
Точки интеграции
Сервер интегрируется с:
- API Smartsheet для операций с данными
- Протокол MCP для стандартизированной связи
- Локальные инструменты разработки через интерфейс stdio
- Системы мониторинга посредством структурированного ведения журнала
Функции
Инструменты
get_column_map (Чтение)- Извлекает сопоставление столбцов и выборку данных из Smartsheet
- Предоставляет подробные метаданные столбцов, включая:
- Типы столбцов (системные столбцы, формулы, списки выбора)
- Правила проверки
- Характеристики формата
- Конфигурации автонумерации
- Возвращает выборку данных для контекста
- Включает примеры использования для записи данных.
smartsheet_write (Создать)- Записывает новые строки в Smartsheet с интеллектуальной обработкой:
- Системно-управляемые столбцы
- Множественный выбор значений списка выбора
- Формульные столбцы
- Реализует автоматическое обнаружение дубликатов
- Возвращает подробные результаты операции, включая идентификаторы строк.
smartsheet_update (Обновление)- Обновляет существующие строки в Smartsheet
- Поддерживает частичные обновления (изменение определенных полей)
- Поддерживает целостность данных с проверкой
- Последовательно обрабатывает поля с множественным выбором
- Возвращает подробную информацию об успехе/неуспехе для каждой строки
smartsheet_delete (Удалить)- Удаляет строки из Smartsheet
- Поддерживает пакетное удаление нескольких строк.
- Проверяет наличие строки и разрешения
- Возвращает подробные результаты операции
smartsheet_search (Поиск)- Выполняет расширенный поиск по листам
- Поддерживает несколько режимов поиска:
- Текстовый поиск с поддержкой регулярных выражений
- Точное соответствие значений для столбцов PICKLIST
- Чувствительность к регистру и параметры целого слова
- Возможности поиска по конкретным столбцам
- Возврат:
- Совпадающие идентификаторы строк (первичный результат)
- Подробная информация о матче
- Поиск метаданных и статистики
smartsheet_add_column (Управление столбцами)- Добавляет новые столбцы в Smartsheet
- Поддерживает все типы столбцов:
- ТЕКСТ_НОМЕР
- ДАТА
- ФЛАЖОК
- СПИСОК ВЫБОРА
- СПИСОК_КОНТАКТОВ
- Настраиваемые параметры:
- Индекс позиции
- Правила проверки
- Определения формул
- Параметры списка выбора
- Обеспечивает ограничение столбцов (400) с проверкой
- Возвращает подробную информацию о столбце
smartsheet_delete_column (Управление столбцами)- Безопасное удаление столбцов с проверкой зависимостей
- Проверяет ссылки на формулы перед удалением
- Предотвращает удаление столбцов, используемых в формулах
- Возвращает подробную информацию о зависимостях
- Поддерживает возможность принудительного удаления
smartsheet_rename_column (Управление столбцами)- Переименовывает столбцы, сохраняя связи
- Автоматически обновляет ссылки на формулы
- Поддерживает целостность данных
- Проверяет уникальность имени
- Возвращает подробную информацию об обновлении
smartsheet_bulk_update (условные обновления)- Выполняет условные массовые обновления на основе правил
- Поддерживает комплексную оценку состояния:
- Несколько операторов (равно, содержит, больше, чем и т. д.)
- Сравнения по типу (текст, даты, числа)
- Пустые/непустые чеки
- Пакетная обработка с настраиваемым размером
- Комплексная обработка ошибок и откат
- Подробное отслеживание результатов операции
start_batch_analysis (аналитика здравоохранения)
- Обрабатывает целые листы или выбранные строки с помощью анализа ИИ
- Поддерживает несколько типов анализа:
- Резюме клинических заметок
- Анализ настроений пациентов
- Индивидуальная оценка для инициатив в сфере здравоохранения
- Оценка влияния исследования
- Функции:
- Автоматическая пакетная обработка (50 строк в пакете)
- Отслеживание прогресса и мониторинг статуса
- Обработка ошибок с подробными отчетами
- Настраиваемые цели анализа
- Поддержка нескольких исходных столбцов
get_job_status (Анализ Мониторинга)
- Отслеживает ход анализа партии
- Предоставляет подробную статистику работы:
- Всего строк для обработки
- Количество обработанных строк
- Неудачное количество строк
- Обработка временных меток
- Обновления статуса в реальном времени
- Подробный отчет об ошибках
cancel_batch_analysis (Управление заданиями)
- Отменяет выполнение заданий пакетного анализа
- Мягкое завершение процесса
- Поддерживает согласованность данных
- Возвращает окончательный статус задания
list_workspaces (Управление рабочим пространством)
- Список всех доступных рабочих пространств
- Возвращает идентификаторы рабочих областей, имена и постоянные ссылки.
- Включает информацию об уровне доступа
- Поддерживает обнаружение рабочего пространства в масштабах всей организации
get_workspace (Управление рабочим пространством)
- Извлекает подробную информацию о рабочем пространстве
- Возвращает содержащиеся листы, папки, отчеты и панели мониторинга
- Предоставляет сведения об уровне доступа и разрешениях
- Поддерживает исследование содержимого рабочего пространства
create_workspace (Управление рабочим пространством)
- Создает новое рабочее пространство с указанным именем.
- Возвращает новый идентификатор рабочего пространства и подтверждение.
- Обеспечивает программную организацию рабочего пространства
- Поддерживает миграцию с устаревших конечных точек папок
create_sheet_in_workspace (Управление рабочим пространством)
- Создает новый лист непосредственно в рабочей области.
- Поддерживает все типы и конфигурации столбцов
- Возвращает новый идентификатор листа и сведения
- Позволяет создавать и организовывать программные листы
list_workspace_sheets (Управление рабочим пространством)
- Перечисляет все листы в определенной рабочей области.
- Возвращает идентификаторы листов, названия и постоянные ссылки
- Включает временные метки создания и изменения.
- Поддерживает обнаружение содержимого рабочего пространства
Ключевые возможности
- Управление типом столбца
- Обрабатывает системные типы столбцов (AUTO_NUMBER, CREATED_DATE и т. д.)
- Поддерживает анализ формул и отслеживание зависимостей
- Управляет параметрами списка выбора и множественным выбором значений
- Комплексные операции со столбцами (добавление, удаление, переименование)
- Сохранение и обновление ссылок на формулы
- Проверка данных
- Автоматическое обнаружение дубликатов
- Проверка типа столбца
- Проверка формата данных
- Анализ зависимости столбцов
- Проверка уникальности имени
- Функциональность поиска
- Расширенные возможности поиска
- Поиск с учетом типа:
- Точное соответствие значениям PICKLIST
- Сопоставление шаблонов для текстовых полей
- Числовые сравнения
- Настраиваемые параметры поиска:
- Чувствительность к регистру
- Сопоставление целых слов
- Фильтрация столбцов
- Комплексные результаты:
- Идентификаторы строк для сопоставленных строк
- Подробный контекст матча
- Статистика поиска
- Обработка метаданных
- Извлекает и обрабатывает метаданные столбцов
- Обрабатывает правила проверки
- Управляет спецификациями формата
- Отслеживает зависимости формул
- Поддерживает отношения столбцов
- Аналитика здравоохранения
- Резюме клинической заметки
- Анализ настроений пациентов
- Оценка соответствия протоколу
- Оценка влияния исследования
- Анализ использования ресурсов
- Пакетная обработка
- Автоматическое пакетирование рядов (50 рядов в партии)
- Отслеживание и мониторинг прогресса
- Обработка ошибок и восстановление
- Настраиваемые цели обработки
- Поддержка многоколоночного анализа
- Управление работой
- Мониторинг состояния в реальном времени
- Подробное отслеживание прогресса
- Отчеты об ошибках и ведение журнала
- Поддержка отмены работы
- Управление пакетными операциями
Настраивать
Предпосылки
- Node.js и npm
- Conda (для управления окружающей средой)
- Токен доступа API Smartsheet
Настройка среды
- Создайте выделенную среду conda:
conda create -n cline_mcp_env python=3.12 nodejs -y
conda activate cline_mcp_env
- Установите зависимости Node.js:
- Установите пакет Python:
cd smartsheet_ops
pip install -e .
cd ..
- Создайте сервер TypeScript:
Конфигурация
Сервер требует правильной настройки в настройках MCP. Вы можете использовать его как с Claude Desktop, так и с Cline.
1. Получите свой ключ API Smartsheet
- Войти в Smartsheet
- Перейдите в раздел «Учетная запись» → «Персональные настройки» → «Доступ к API».
- Сгенерировать новый токен доступа
2. Настроить для Клайна
Путь конфигурации зависит от вашей операционной системы:
macOS :
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Окна :
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Линукс :
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
{
"mcpServers": {
"smartsheet": {
"command": "/Users/[username]/anaconda3/envs/cline_mcp_env/bin/node",
"args": ["/path/to/smartsheet-server/build/index.js"],
"env": {
"PYTHON_PATH": "/Users/[username]/anaconda3/envs/cline_mcp_env/bin/python3",
"SMARTSHEET_API_KEY": "your-api-key",
"AZURE_OPENAI_API_KEY": "your-azure-openai-key",
"AZURE_OPENAI_API_BASE": "your-azure-openai-endpoint",
"AZURE_OPENAI_API_VERSION": "your-api-version",
"AZURE_OPENAI_DEPLOYMENT": "your-deployment-name"
},
"disabled": false,
"autoApprove": [
"get_column_map",
"smartsheet_write",
"smartsheet_update",
"smartsheet_delete",
"smartsheet_search",
"smartsheet_add_column",
"smartsheet_delete_column",
"smartsheet_rename_column",
"smartsheet_bulk_update",
"start_batch_analysis",
"get_job_status",
"cancel_batch_analysis",
"list_workspaces",
"get_workspace",
"create_workspace",
"create_sheet_in_workspace",
"list_workspace_sheets"
]
}
}
}
Запуск сервера
Сервер запустится автоматически, когда Cline или Claude Desktop в нем нуждаются. Однако вы также можете запустить его вручную для тестирования.
macOS/Linux :
# Activate the environment
conda activate cline_mcp_env
# Start the server
PYTHON_PATH=/Users/[username]/anaconda3/envs/cline_mcp_env/bin/python3 SMARTSHEET_API_KEY=your-api-key node build/index.js
Окна :
:: Activate the environment
conda activate cline_mcp_env
:: Start the server
set PYTHON_PATH=C:\Users\[username]\anaconda3\envs\cline_mcp_env\python.exe
set SMARTSHEET_API_KEY=your-api-key
node build\index.js
Проверка установки
- При запуске сервер должен вывести сообщение «Сервер Smartsheet MCP запущен на stdio».
- Проверьте соединение с помощью любого инструмента MCP (например, get_column_map)
- Проверьте, установлен ли в среде Python пакет Smartsheet:
conda activate cline_mcp_env
pip show smartsheet-python-sdk
Примеры использования
// Get column mapping and sample data
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "get_column_map",
arguments: {
sheet_id: "your-sheet-id",
},
});
Запись данных (создание)
// Write new rows to Smartsheet
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "smartsheet_write",
arguments: {
sheet_id: "your-sheet-id",
column_map: {
"Column 1": "1234567890",
"Column 2": "0987654321",
},
row_data: [
{
"Column 1": "Value 1",
"Column 2": "Value 2",
},
],
},
});
Поиск данных
// Basic text search
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "smartsheet_search",
arguments: {
sheet_id: "your-sheet-id",
pattern: "search text",
options: {
case_sensitive: false,
whole_word: false,
columns: ["Column1", "Column2"], // Optional: limit search to specific columns
},
},
});
// Search PICKLIST column with exact matching
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "smartsheet_search",
arguments: {
sheet_id: "your-sheet-id",
pattern: "In Progress",
options: {
columns: ["Status"], // PICKLIST column
case_sensitive: true,
whole_word: true,
},
},
});
Обновление данных (Обновление)
// Update existing rows
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "smartsheet_update",
arguments: {
sheet_id: "your-sheet-id",
column_map: {
Status: "850892021780356",
Notes: "6861293012340612",
},
updates: [
{
row_id: "7670198317295492",
data: {
Status: "In Progress",
Notes: "Updated via MCP server",
},
},
],
},
});
Удаление данных (Удалить)
// Delete rows from Smartsheet
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "smartsheet_delete",
arguments: {
sheet_id: "your-sheet-id",
row_ids: ["7670198317295492", "7670198317295493"],
},
});
Примеры аналитики в здравоохранении
// Example 1: Pediatric Innovation Scoring
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "start_batch_analysis",
arguments: {
sheet_id: "your-sheet-id",
type: "custom",
sourceColumns: ["Ideas", "Implementation_Details"],
targetColumn: "Pediatric_Score",
customGoal:
"Score each innovation 1-100 based on pediatric healthcare impact. Consider: 1) Direct benefit to child patients, 2) Integration with pediatric workflows, 3) Implementation feasibility in children's hospital, 4) Safety considerations for pediatric use. Return only a number.",
},
});
// Example 2: Clinical Note Summarization
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "start_batch_analysis",
arguments: {
sheet_id: "your-sheet-id",
type: "summarize",
sourceColumns: ["Clinical_Notes"],
targetColumn: "Note_Summary",
},
});
// Example 3: Patient Satisfaction Analysis
const result = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "start_batch_analysis",
arguments: {
sheet_id: "your-sheet-id",
type: "sentiment",
sourceColumns: ["Patient_Feedback"],
targetColumn: "Satisfaction_Score",
},
});
Примеры управления рабочим пространством
// List all accessible workspaces
const workspaces = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "list_workspaces",
arguments: {},
});
// Get details of a specific workspace
const workspace = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "get_workspace",
arguments: {
workspace_id: "6621332407379844",
},
});
// Create a new workspace
const newWorkspace = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "create_workspace",
arguments: {
name: "Project Management",
},
});
// Create a sheet in a workspace
const newSheet = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "create_sheet_in_workspace",
arguments: {
workspace_id: "6621332407379844",
name: "Task Tracker",
columns: [
{ title: "Task Name", type: "TEXT_NUMBER" },
{ title: "Due Date", type: "DATE" },
{
title: "Status",
type: "PICKLIST",
options: ["Not Started", "In Progress", "Completed"],
},
],
},
});
// List all sheets in a workspace
const sheets = await use_mcp_tool({
server_name: "smartsheet",
tool_name: "list_workspace_sheets",
arguments: {
workspace_id: "6621332407379844",
},
});
Разработка
Для разработки с автоматической пересборкой:
Отладка
Поскольку серверы MCP взаимодействуют через stdio, отладка может быть сложной. Сервер реализует комплексное ведение журнала ошибок и предоставляет подробные сообщения об ошибках через протокол MCP.
Основные возможности отладки:
- Ошибка регистрации в stderr
- Подробные сообщения об ошибках в ответах MCP
- Проверка типа на нескольких уровнях
- Комплексная отчетность о результатах операции
- Анализ зависимости для операций со столбцами
- Отслеживание ссылок на формулы
Обработка ошибок
Сервер реализует многоуровневый подход к обработке ошибок:
- МКП слой
- Проверяет параметры инструмента
- Обрабатывает ошибки на уровне протокола
- Предоставляет форматированные ответы об ошибках
- Управляет тайм-аутами и повторными попытками
- Уровень CLI
- Проверяет аргументы команды
- Обрабатывает ошибки выполнения
- Форматирует сообщения об ошибках в формате JSON
- Проверяет операции со столбцами
- Операционный уровень
- Обрабатывает ошибки API Smartsheet
- Проверяет типы и форматы данных
- Предоставляет подробный контекст ошибки
- Управляет зависимостями столбцов
- Проверяет ссылки на формулы
- Обеспечивает целостность данных
Внося вклад
Вклады приветствуются! Пожалуйста, убедитесь, что:
- Код TypeScript/Python следует существующему стилю
- Новые функции включают соответствующую обработку ошибок.
- Изменения сохраняют обратную совместимость.
- Обновления включают соответствующую документацию.
- Операции со столбцами поддерживают целостность данных
- Ссылки на формулы обрабатываются правильно