Сервер MCP Flatfile

Сервер Flatfile MCP позволяет помощникам ИИ, таким как Claude Desktop, Claude Code, Cursor и другим, напрямую взаимодействовать с данными Flatfile. Этот сервер MCP создает бесшовный мост между помощниками ИИ и Flatfile.

✨ Особенности

Поддерживает более 100 конечных точек API Flatfile
Просмотр и управление листами, рабочими книгами, пространствами и многим другим
Добавление, редактирование и удаление записей
Задавайте вопросы о ваших данных
Генерация таблиц на естественном языке
Создание новых рабочих книг с нуля
И многое другое!

🛠️ Настройка

Вам понадобится либо персональный токен доступа Flatfile, либо ключ API Flatfile.

API-ключ

Получите доступ к своему ключу API, следуя этим инструкциям .

Персональный токен доступа

Создайте персональный токен доступа Flatfile, следуя этим инструкциям .

Инструменты фильтрации

Flatfile предоставляет более 100 конечных точек API с инструментом для взаимодействия с каждой из них. Настоятельно рекомендуется отфильтровать инструменты, чтобы включить только те, которые вам нужны. Это можно сделать, передав флаг --enabled-tools серверу MCP вместе со списком инструментов, разделенных запятыми, которые вы хотите включить. Если флаг --enabled-tools не передан, будут включены все инструменты.

Пример:

{
  "mcpServers": {
      // ...
      "mcp-server-flatfile": {
         "command": "npx",
         "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "getRecords,updateRecords"],
         // ...
      }
      // ...
  }
}

Использование с Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json :

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

Использование с кодом Клода

Добавьте следующее в ваш .claude/code/config.json :

claude mcp add mcp-server-flatfile -e FLATFILE_API_URL=https://platform.flatfile.com/api/v1 -e FLATFILE_BEARER_TOKEN=pat_your_token_here -- npx -y @flatfile/mcp-server --enabled-tools ... // Replace with the tools you want to enable

Инструкции Клода Кода по добавлению сервера MCP.

Использование с курсором

Добавьте следующее в ваш .cursor/mcp.json :

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

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

ackEvent — Подтверждение события: Подтверждение события
ackJob - Подтверждение задания: Подтверждение задания и возврат задания
ackOutcomeJob — Подтверждение результата работы: Подтверждение результата работы и возврат работы
archiveSpace — архивирует пространство: устанавливает временную метку archivedAt для пространства
assignAgentRole — Назначить роль агенту: назначает роль агенту.
assignGuestRole — Назначить роль гостю: назначает роль гостю.
assignUserRole — Назначить роль пользователю: назначает роль пользователю.
bulkCreateActions - Создать несколько действий: Создать несколько действий
bulkDeleteSpace - Удаление пробелов: удаление нескольких пробелов по идентификатору
cancelJob - Отменить работу: Отменить работу и вернуть ее
completeJob - Завершить работу: Завершить работу и вернуть работу
createAction - Создать действие: Создать действие
createAgent - Создать агента: Создать агента
createAndInviteUser — Создать и пригласить пользователя: создает и приглашает нового пользователя в вашу учетную запись.
createApp - Создать приложение: Создает приложение
createAssistant - Создать подсказку: Создает подсказку
createCanvasArea — Создать область холста: Создает новую область холста
createConstraintApp — Создать ограничение: создает новое ограничение для приложения.
createDataRetentionPolicy — создание политики хранения данных: добавление новой политики хранения данных в пространство
createDocument - Создать документ: Добавить новый документ в пространство
createDraftSpace - Создать черновик пространства: Создает черновик пространства
createEnvironment - Создать среду: Создать новую среду
createEvent - Создать событие: Создать событие
createGuidanceSpace — Создать новое руководство: Создает новое руководство.
createGuideEnvironment - Создать руководство: Создает руководство
createIdVersion - createId: createId
createJob - Создать работу: Создать работу
createMappingProgram — создание сопоставления между двумя схемами: создает список правил сопоставления на основе двух предоставленных схем.
createRoutine - Создать процедуру: Создает новую процедуру
createRulesMapping - Добавить правила сопоставления в программу: Добавить правила сопоставления в программу
createRunbook — создание книги заданий: создает новую книгу заданий.
createSnapshot - Создать снимок: Создает снимок листа.
createSpace - Создать пространство: создает новое пространство на основе существующей конфигурации пространства.
createView - Создать представление: Добавить новое представление в пространство
createWorkbook — создание рабочей книги: создает рабочую книгу и добавляет ее в пространство.
deleteAction - Удалить действие: Удалить действие
deleteAgent - Удалить агента: удаляет одного агента.
deleteAgentExport - Удалить экспорт агента: Удалить экспорт агента
deleteAgentRole — Удалить роль у агента: удаляет роль у агента.
deleteAllHistoryForUserMapping — удалить всю историю для аутентифицированного пользователя: удаляет всю историю для аутентифицированного пользователя.
deleteApp - Удалить приложение: удаляет приложение.
deleteAssistant - Удалить подсказки: Удаляет подсказки.
deleteCanvasArea — Удалить область холста: удаляет определенную область холста.
deleteConstraintApp - Удалить ограничение: удаляет определенное ограничение
deleteDataRetentionPolicy — удаление политики хранения данных: удаляет отдельную политику хранения данных.
deleteDocument — Удалить документ: удаляет один документ.
deleteEnvironment — Удалить среду: удаляет одну среду.
deleteFile - Удалить файл: Удалить файл
deleteGuest - Удалить гостя: удаляет одного гостя.
deleteGuestRole — Удалить роль гостя: удаляет роль гостя.
deleteGuidanceSpace — Удалить руководство: удаляет руководство по его идентификатору.
deleteGuideEnvironment - Удалить руководство: Удаляет руководство.
deleteJob - Удалить работу: Удалить работу
deleteMappingProgram - Удалить программу картографирования: Удаляет программу картографирования.
deleteMultipleRulesMapping — удаление нескольких правил сопоставления: удаляет несколько правил сопоставления из программы.
deleteRecords - Удалить записи: удаляет записи с листа рабочей книги.
deleteRoutine - Удалить процедуру: Удаляет процедуру
deleteRuleMapping — Удалить правило сопоставления: удаляет правило сопоставления из программы.
deleteRunbook — Удалить книгу заданий: Удаляет книгу заданий.
deleteSecret - Удалить секрет по нему
deleteSheet — Удалить лист: удаляет определенный лист из рабочей книги.
deleteSnapshot - Удалить снимок: удаляет снимок листа.
deleteSpace - Удалить пробел: Удалить пробел
deleteUser - Удалить пользователя: Удаляет пользователя.
deleteUserRole — Удалить роль у пользователя: удаляет роль у пользователя.
deleteView - Удалить представление: удаляет одно представление.
deleteWorkbook — удаление рабочей книги: удаляет рабочую книгу и все ее записи навсегда.
downloadAgentExport - Загрузить экспорт агента: Загрузить экспорт агента
downloadFile - Загрузить файл: Загрузить файл
duplicateSheet — Дублировать лист: создает копию листа, включая все его данные, в той же рабочей книге.
executeJob - Выполнить задание: Выполнить задание и вернуть его
failJob - Провалить работу: Провалить работу и вернуть ее
getAction - Получить действие: Получить действие
getAgent - Получить агента: Получить агента
getAgentExport - Получить экспорт агента: Получить экспорт агента
getAgentLog - Получить журнал агента: Получить журнал агента
getAgentLogs - Получить журналы для агента: Получить журналы для агента
getAllActions — Получить все действия для пространства: Получить все действия для пространства
getApp — Получить приложение: Возвращает приложение.
getAssistant — Получить подсказку: Возвращает подсказку
getCalculationsSheet — Список вычислений: Возвращает все вычисления для листа
getCanvasArea — Получить область холста: Возвращает определенную область холста по идентификатору
getCellValuesSheet — Получить ячейки записи по полю: Возвращает значения ячеек записи, сгруппированные по всем полям на листе.
getCommit — Получить версию коммита: Возвращает сведения о версии коммита
getConstraintByIdApp — Получить ограничение по идентификатору: возвращает определенное ограничение
getConstraintsApp — Получить ограничения: Возвращает ограничения для приложения.
getConstraintVersionApp — Получить версию ограничения: Возвращает указанную версию определенного ограничения
getConstraintVersionsApp — Получить версии ограничений: возвращает версии определенного ограничения.
getCurrentAccounts - Получить текущий счет: Получить текущий счет
getDataRetentionPolicy — Получить политику хранения данных: Возвращает одну политику хранения данных.
getDocument — Получить документ: Возвращает один документ
getEnvironment — Получить среду: Возвращает одну среду
getEnvironmentAgentExecutionsAgents — Получить все выполнения в вашей среде: Получить все выполнения в вашей среде
getEnvironmentAgentLogsAgents — Получить все журналы агентов в вашей среде: Получить все журналы агентов в вашей среде
getEvent - Получить событие: Получить событие
getEventTokenEvents — Получить учетные данные подписки: получить токен, который можно использовать для подписки на события для этого пространства.
getExecutionPlanJob - Получить работу
getFile - Получить файл: Получить файл
getGuest — Получить гостя: Возвращает одного гостя
getGuestToken — Получить токен гостя: Возвращает один токен гостя
getGuidanceSpace — Получить руководство: Извлекает руководство по его идентификатору
getGuideEnvironment — Получить руководство: Возвращает руководство
getGuideVersionEnvironment — Получить версию руководства: Возвращает указанную версию определенного руководства.
getJob - Получить работу: Получить работу
getMappingProgram - Получить программу картографирования: Получить программу картографирования
getRecordCountsSheet — Получить количество записей: Возвращает количество записей из листа
getRecords — Получить записи: Возвращает записи с листа в рабочей книге.
getRecordsAsCsvSheet — загрузка записей в виде CSV-файла: возвращает записи с листа в рабочей книге в виде CSV-файла.
getRoutine — Получить процедуру: Возвращает процедуру
getRuleMapping - Получить правило сопоставления: Получить правило сопоставления из программы
getRunbook — Получить книгу заданий: Возвращает книгу заданий
getSftpCredentialsAuth — получение учетных данных SFTP для Space: получение учетных данных SFTP для Space
getSheet — Получить лист: Возвращает лист в рабочей книге.
getSheetCommits — Получить версии коммитов для листа: Возвращает версии коммитов для листа
getSnapshot - Получить снимок: Получает снимок листа
getSnapshotRecords — Получить записи из снимка: Получает записи из снимка листа
getSpace — Получить пробел: Возвращает один пробел
getUser — Получить пользователя: Получает пользователя
getView — Получить представление: Возвращает одно представление
getWorkbook — Получить рабочую книгу: Возвращает одну рабочую книгу.
getWorkbookCommits — Получить коммиты для рабочей книги: Возвращает коммиты для рабочей книги.
indexRecords - Получить индексы записей: Возвращает индексы записей с листа в рабочей книге.
insertRecords - Вставить записи: добавляет записи на лист рабочей книги.
listAgentExports - Список экспортов агентов: Список экспортов агентов
listAgentRoles — список ролей агента: выводит список ролей, назначенных агенту.
listAgents - Список агентов: Список агентов
listApps — Список приложений: Возвращает приложения в аккаунте.
listAssistant — Список подсказок: Возвращает подсказки, созданные пользователем.
listCanvasAreas — Список областей холста: Возвращает список областей холста, отфильтрованных по холсту, пространству или среде.
listDocuments - Список документов: возвращает все документы для пространства
listEntitlements — список прав: возвращает все права, соответствующие фильтру resourceId
listEnvironments - Список сред: Получить все среды
listEvents — список событий: темы событий, которые отправляет платформа Flatfile.
listFiles - Список файлов: Список файлов
listGuestRoles — список ролей гостя: выводит список ролей, назначенных гостю.
listGuests - Список гостей: Возвращает всех гостей.
listGuidanceSpace - Список руководств: Списки руководств
listGuidesEnvironment - Список руководств: Возвращает руководства в учетной записи
listJobs - Список вакансий: Список вакансий
listMappingPrograms - Список картографических программ: Список всех картографических программ
listRoles - Список ролей: список всех ролей для учетной записи
listRoutines - Список процедур: Возвращает список процедур.
listRulesMapping - Список правил сопоставления: Список всех правил сопоставления в программе
listRunbooks — Список книг запуска: возвращает список книг запуска.
listSecrets - Список секретов: извлечение всех секретов для указанного environmentId и, при необходимости, применение переопределений пространства
listSheets - Список листов: Возвращает листы в рабочей книге.
listSnapshots - Список снимков: список всех снимков листа
listSpaceDrafts — Список черновиков для пространства: Список черновиков для пространства
listSpaces — список пространств: возвращает все пространства для учетной записи или среды.
listUserRoles — список ролей пользователя: выводит список ролей, назначенных пользователю.
listUsers - Список пользователей: Получает список пользователей.
listVersionsAgent - Список версий агента для агента: Список версий агента для агента
listViews — Список представлений по листу: возвращает все представления для листа.
listWorkbooks — список рабочих книг: возвращает все рабочие книги, соответствующие фильтру для учетной записи или пространства.
lockSheet - Блокировка листа: Блокирует лист.
previewMutationJob — Предварительный просмотр мутации: Предварительный просмотр результатов мутации
resendInviteUser — повторно отправить приглашение пользователю: повторно отправляет приглашение пользователю для вашей учетной записи.
restoreSnapshot - Восстановление снимка: восстанавливает снимок листа.
retryJob - Повторить неудачное задание: Повторить неудачное задание и вернуть задание
revertAgent - Возврат к определенной версии агента: Возврат к определенной версии агента
splitJob - Разделить работу: Разделить работу и вернуть работу
unarchiveSpace — разархивирует пространство: устанавливает временную метку archivedAt пространства на ноль
unlockSheet — Разблокировать лист: снимает блокировку с листа.
updateAction - Обновить действие: Обновить действие
updateApp — Обновление приложения: обновляет приложение.
updateAssistant — Обновить подсказку: Обновляет подсказку
updateCanvasArea — обновление области холста: обновляет существующую область холста.
updateConstraintApp — Обновление ограничения: обновляет определенное ограничение.
updateCurrentAccount - Обновление текущего счета: Обновление текущего счета
updateDataRetentionPolicy — обновление политики хранения данных: обновляет отдельную политику хранения данных.
updateDocument — обновление документа: обновляет только текст и заголовок отдельного документа.
updateEnvironment — обновление среды: обновляет отдельную среду, например, для изменения имени.
updateExecutionPlanFieldsJob — обновление задания
updateExecutionPlanJob — заменить задание
updateFile — обновить файл: обновить файл, например, чтобы изменить идентификатор рабочей книги.
updateGuest — обновление гостя: обновление отдельного гостя, например, для изменения имени или адреса электронной почты.
updateGuidanceSpace — Обновить руководство: Обновляет руководство с указанным идентификатором.
updateGuideEnvironment - Обновление руководства: Обновляет руководство
updateJob - Обновить вакансию: Обновить вакансию
updateMappingProgram - Обновление картографической программы: Обновляет картографическую программу.
updateRecords — обновление записей: обновление существующих записей на листе рабочей книги.
updateRoutine — Обновить процедуру: Обновляет процедуру
updateRuleMapping — обновление правила сопоставления: обновляет правило сопоставления в программе.
updateRulesMapping — обновление списка правил сопоставления: обновляет список правил сопоставления в программе.
updateRunbook — обновление книги заданий: обновляет книгу заданий.
updateSheet - Обновить лист: Лист обновлений
updateSpace - Обновить пространство: обновить пространство, например, чтобы изменить имя.
updateUser - Обновление пользователя: Обновляет пользователя.
updateView — обновление представления: обновляет одно представление.
uploadFile - Загрузить файл: Загрузить файл
upsertSecret - Upsert a Secret: вставить или обновить Secret по имени для среды или пространства
validateSheet — проверка листа: запуск обработчиков данных и проверки для листа

Flatfile MCP Server

Integrations