Как подключить Smartsheet к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Smartsheet, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Smartsheet + Claude

Smartsheet API 2.0 с персональным токеном доступа (US, EU, AU или Gov): поиск и чтение таблиц, строк, столбцов, сводок таблиц и истории ячеек, комментариев и вложений, рабочих пространств, папок, отчётов и дашбордов, пользователей и общего доступа; добавление и изменение строк и столбцов, комментарии, создание таблиц, общий доступ и запросы на обновление. Удаление строк отключено при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

SMARTSHEET_API_URL, SMARTSHEET_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен тариф Smartsheet с доступом к API (Pro, Business, Enterprise или Advanced Work Management).

1. Войдите в Smartsheet, нажмите на значок аккаунта внизу слева и откройте Apps & Integrations (или Personal Settings), затем API Access.
2. Нажмите Generate new access token, задайте имя, например AnythingMCP, и скопируйте токен. Он показывается только один раз.
3. Вставьте его в SMARTSHEET_ACCESS_TOKEN без слова Bearer.
4. Укажите в SMARTSHEET_API_URL хост региона вашего аккаунта: https://api.smartsheet.com/2.0 для app.smartsheet.com (US), https://api.smartsheet.eu/2.0 для app.smartsheet.eu, https://api.smartsheet.au/2.0 для app.smartsheet.au или https://api.smartsheetgov.com/2.0 для Smartsheet Gov. Токен работает только на хосте своего региона; на любом другом Smartsheet отвечает 401 «invalid access token».
5. Установите коннектор и запустите smartsheet_get_current_user: он покажет, чей это токен, и подтвердит его.

Чьи права: каждый вызов выполняется от имени владельца токена с его доступом к каждой таблице, и токен может всё, что этот пользователь может в Smartsheet. Если это важно, создайте токен под отдельным пользователем, у которого есть доступ только к тем таблицам, которые должен видеть ИИ.

Что он читает: поиск по всему, что пользователь может открыть (названия таблиц, отчётов, дашбордов, папок, рабочих пространств и шаблонов, данные ячеек, комментарии, вложения и поля сводки), с сужением через scopes, например sheetNames; таблицы со столбцами (тип, варианты выпадающего списка, основной столбец) и строками, у каждой номер строки, родительская строка для иерархии и ячейки в виде value и displayValue; отдельную строку; текстовый поиск внутри одной таблицы; поля сводки таблицы; историю изменений ячейки с тем, кто и когда её менял; ветки комментариев к таблицам и строкам; вложения со ссылкой на скачивание, действующей около 2 минут; рабочие пространства и папки с их содержимым; отчёты со строками из нескольких таблиц, ячейки по virtualColumnId; дашборды (в API они называются sights) с виджетами; пользователей аккаунта организации (системные администраторы видят всех, остальные ограниченный список) и то, с кем предоставлен общий доступ к элементу.

Большие таблицы: ИИ сначала получает список столбцов с их id и типами, затем читает страницу строк или только нужные строки через row_numbers, row_ids, column_ids или rows_modified_since.

Что он записывает: smartsheet_add_rows и smartsheet_update_rows (меняются только указанные ячейки; поле расположения перемещает строку), smartsheet_add_columns и smartsheet_update_column (смена типа столбца может преобразовать или удалить значения ячеек), новые ветки комментариев к таблицам и строкам и ответы в них, новые таблицы в рабочем пространстве или папке со своими столбцами или как копия шаблона или таблицы, smartsheet_share_asset и smartsheet_create_update_request. Эти инструменты включены при установке. Общий доступ и запросы на обновление с send_email отправляют письма, а подписчики таблицы могут получать уведомления о новых комментариях, поэтому ИИ сначала показывает вам получателей, уровень доступа и содержание и ждёт вашего «да».

Запись ячеек: ячейка задаётся как {"columnId": <id>, "value": <value>}. DATE принимает YYYY-MM-DD, CHECKBOX true или false, PICKLIST один из своих вариантов (другие значения отклоняются, если strict не false), CONTACT_LIST адрес e-mail, числа передаются как числа. Формула пишется в "formula": "=..." вместо value. Новым строкам нужно расположение: toBottom, toTop, parentId или siblingId. В столбцы с формулой столбца, системные столбцы (автонумерация, дата создания, кем изменено) и заблокированные столбцы записывать нельзя.

Отключено при установке: smartsheet_delete_rows, потому что удалённые строки вместе с дочерними строками, вложениями и комментариями нельзя восстановить через API. Администратор включает инструмент, когда он нужен команде.

Форматы данных: у таблиц, строк, столбцов, рабочих пространств, папок, отчётов и пользователей длинные числовые id (до 16 цифр), которые ИИ передаёт текстом в точности как получил. Даты и время в ISO 8601 в UTC; ячейки дат в формате YYYY-MM-DD. Ячейки с несколькими контактами или множественным выбором возвращаются текстом, если не передать level (2 или 3) и include=objectValue. accessLevel принимает значения VIEWER, COMMENTER, EDITOR, EDITOR_SHARE, ADMIN или OWNER. Вызовы записи отвечают {"message": "SUCCESS", "resultCode": 0, "result": ...}; resultCode 3 означает частичный успех.

Постраничная выдача: таблицы, столбцы, обсуждения, вложения, пользователи и история ячеек листаются через page и page_size (по умолчанию 100; в ответе есть totalPages и totalCount) или include_all. Рабочие пространства, содержимое пространств и папок, дашборды и общий доступ листаются по токену: ИИ передаёт lastKey из ответа как last_key, пока он не исчезнет.

Ограничения: 300 запросов в минуту на токен, для истории ячеек 30 в минуту. Ответ 429 (код ошибки 4003) означает, что нужно подождать минуту. Массовый вызов по строкам считается одним запросом; держите его в пределах нескольких сотен строк.

Частые ошибки: 401 (коды 1002, 1003, 1004) означает недействительный или просроченный токен либо хост другого региона. 403 (1004) означает, что пользователь токена не может открыть этот элемент: предоставьте ему доступ или используйте токен пользователя, у которого доступ есть. 404 (1006) означает, что id не существует или не виден пользователю. 400 приходит с errorCode и message, где названа проблема, например значение не из выпадающего списка, новая строка без расположения или запись в столбец с формулой столбца.

Коннектор не загружает файлы, не удаляет таблицы и столбцы и не создаёт рабочие пространства и папки.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Smartsheet, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Покажи все строки таблицы Project Tracker со статусом At Risk, с ответственным и сроком.»
• «Добавь строку в конец таблицы Marketing Calendar: Webinar, 2026-11-20, ответственный [email protected], статус Planned.»
• «Кто изменил ячейку бюджета в строке 14 таблицы Q4 Budget и какие значения были раньше?»
• «Найди все таблицы, комментарии и вложения, где упоминается Project Apollo.»
• «Прочитай сводку таблицы Website Relaunch и скажи общий статус и процент выполнения.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot