Настройка Tulip MCP

Новые функции
  • Опубликовано Aug 7, 2025
  • 3 минут чтения
  • Pete Hartnett
 Prev Next

Как настроить Tulip MCP?

Подробная документация по настройке Tulip MCP доступна в официальном репозитории: https://github.com/tulip/tulip-mcp/tree/master.

Настройка Tulip MCP была упрощена. Новый процесс включает в себя три ключевых шага:

  1. Настроить учетные данные
  2. Запустить сервер
  3. Подключение к MCP-клиенту

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

Прежде чем приступить к работе, убедитесь, что в вашей системе установлен Node.js. Это необходимо для запуска сервера.

Проверка версии npm и Node.jsВыполнитеследующие команды в терминале/Windows Terminal (Command Prompt, PowerShell):

node -vnpm -vЕсливы получите название версии, значит, все в порядке, и вы можете продолжить выполнение шага 1. Если нет, зайдите на сайт node.js и установите последнюю версию для вашей операционной системы.

Настройка учетных данных API Tulip

Чтобы подключиться к Tulip через API, вам нужно создать файл .env, в котором будут надежно храниться ваши учетные данные API.

1. Создайте папку конфигурации

Выберите или создайте папку, в которой будет храниться файл конфигурации среды.

Руководство: Создание файла .env

В этом файле будут храниться ваши учетные данные Tulip. Пример файла .env доступен здесь.

Пользователи Mac:

  1. Откройте Терминал и выполните следующие команды:

bashtouch .envnano .env2. Вставьте шаблон учетных данных (в следующем шаге) в новый файл.3. После добавления учетных данных следуйте инструкциям по сохранению ниже.

Пользователи Windows:

  1. Откройте Блокнот.
  2. Вставьте шаблон учетных данных (в следующем шаге) в новый файл.
  3. После добавления учетных данных следуйте инструкциям по сохранению, приведенным ниже.

2. Добавление учетных данных Tulip

Скопируйте и вставьте в файл .env следующие слова, заменив их на реальные учетные данные:

TULIP_API_KEY=ваш_api_ключ_здесьTULIP_API_SECRET=ваш_api_secret_здесьTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: Это URL, который вы используете для доступа к Tulip.
    Пример: https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: содержится в URL-адресе Tulip после /w/.
    Пример: В https://my-company.tulip.co/w/DEFAULT идентификатор рабочего пространства - DEFAULT.

::::(Предупреждение) (Важно) Указывайте TULIP_WORKSPACE_ID только в том случае, если вы используете API-ключ учетной записи (из настроек учетной записи).

Если вы используете API-ключ рабочего пространства (из настроек рабочего пространства), вы можете оставить этот field пустым.
:::
Сохраните файл и убедитесь, что он находится в указанной вами папке.

3. Запустите сервер

После того как файл .env настроен, вы можете запустить сервер.

Откройте терминал или командную строку, перейдите в папку с файлом .env и выполните следующую команду:

bashnpx @tulip/mcp-server Этакоманда загрузит последнюю версию сервера Tulip MCP и запустит его. Теперь сервер запущен и готов к подключению MCP-клиента.

4. Подключение к Tulip MCP

Когда MCP-клиент запускает сервер, он может находиться не в той же директории, что и ваш .env-файл, поэтому он не найдет учетные данные автоматически. Чтобы исправить это, необходимо указать полный путь к вашему .env-файлу с помощью флага --env в конфигурации клиента.

Руководство: Поиск пути к файлу .env

  1. Перейдите в папку, в которой вы создали файл .env.
  2. В Windows: Щелкните правой кнопкой мыши файл .env, удерживая клавишу Shift, и выберите "Копировать как путь".
  3. В macOS: Щелкните правой кнопкой мыши файл .env, удерживая клавишу Option, затем выберите "Копировать .env как имя пути".
  4. Вы будете использовать этот скопированный путь в конфигурации клиента ниже.

Руководство: Claude Desktop

  1. В строке меню Claude Desktop выберите "Настройки... " > "Разработчик " > "Редактировать конфигурацию".
  2. Откроется файл claude_desktop_config.json.
  3. Добавьте конфигурацию сервера в объект mcpServers. Вы должны заменить "C:\\path\\\to\\your\\\.env" на реальный путь, который вы скопировали. json { " mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\path\\\to\\your\\\.env" ] } } }
  4. Сохраните файл и перезапустите Claude Desktop.

Более подробную информацию можно найти в официальном руководстве Claude Desktop MCP Quickstart.

Курсор

Для самой простой настройки нажмите кнопку ниже. Это приведет к предварительному заполнению команды в Cursor.

Подключиться к Cursor

После нажатия на кнопку необходимо заменить текст-заместитель(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) на полный путь к вашему файлу .env, который вы скопировали ранее.

Расширенная конфигурация

Получение учетных данных API Tulip

Вы можете создать учетные данные API (токены) в настройках Tulip instance.

  1. Войти: Зайдите на свой сайт Tulip instance.
  2. Перейдите в раздел Токены API: Перейдите в раздел Настройки > Токены API.
  3. Создайте новый API-токен: Сгенерируйте новый токен, дав ему описательное имя (например, "MCP Server").
  4. Настройте диапазоны: Предоставьте токену необходимые разрешения (диапазоны). Хорошим начальным набором диапазонов для базового доступа является следующий: станции:читать, пользователи:читать, таблицы:читать, машины:читать, приложения:читать, урлы:подписывать.
  5. Скопируйте учетные данные: Скопируйте сгенерированные API Key и Secret и вставьте их в свой файл .env.

Конфигурация выбора инструмента

По умолчанию, для безопасности, сервер включает только инструменты для чтения и таблицы. Вы можете настроить доступные инструменты с помощью переменной окружения ENABLED_TOOLS в вашем файле .env.

Переменная ENABLED_TOOLS принимает список, разделенный запятыми, который может включать:

  • Имена отдельных инструментов: Конкретные инструменты, например listStations.
  • Категории: Группировки на основе безопасности(только чтение, запись, администратор).
  • Типы: Группировки на основе ресурсов(таблица, машина, пользователь, приложение, интерфейс, станция, станция-группа, утилита).

Примеры:

``env

# Включить все операции чтения и записи

ENABLED_TOOLS=read-only,write

# Включить все инструменты, связанные с таблицами и станциями

ENABLED_TOOLS=table,station

# Включить конкретные инструменты

ENABLED_TOOLS=listStations,addRecord

# Рекомендуемый смешанный подход

ENABLED_TOOLS=read-only,interface,station,user

# Включить все (используйте с осторожностью, так как это позволяет удалять/архивировать данные)

ENABLED_TOOLS=только чтение,запись,администратор```

Связанные статьи