ИИ-асссистенты для бизнеса

Как подключить ChatGPT к Tilda MCP: пошаговая инструкция

У Tilda есть официальный MCP-сервер: через него ИИ-агент читает и меняет страницы, блоки, потоки и каталог товаров. Claude Code подключается к нему одной командой. С ChatGPT так не получится: прямое подключение не проходит авторизацию. Ниже рассказываем, почему так происходит и как подключить ChatGPT к Tilda через свой MCP-шлюз. Схема проверена на рабочем проекте.

Почему ChatGPT не подключается к Tilda MCP напрямую

  • MCP-сервер Tilda (https://tilda.ru/api/mcp/) принимает только ключ в заголовке Authorization: Bearer <ключ>. OAuth он не поддерживает: адреса /.well-known/oauth-* отвечают 404.
  • Пользовательский MCP-сервер (плагин) в ChatGPT авторизуется через OAuth 2.1 с PKCE и динамической регистрацией клиента (DCR). Ключ Bearer в его настройки вписать нельзя.
  • Tilda прямо пишет, что MCP подключается только к агентам, которые установлены на компьютере как приложения, а не к облачным агентам в браузере.
Поэтому между ChatGPT и Tilda нужен посредник: свой небольшой MCP-сервер. Для ChatGPT он выглядит как обычный OAuth-сервер, а сам ходит в Tilda с вашим ключом.

Как устроена схема

ChatGPT (плагин)
   │  HTTPS + OAuth Bearer (локальный токен шлюза)
   ▼
Ваш MCP-шлюз на PHP  (https://ваш-домен/api/tilda-mcp/index.php)
   ├─ проверяет токен ChatGPT
   ├─ пропускает только разрешённые инструменты
   └─ берёт ключ Tilda из приватного конфига
   │  HTTPS + Bearer <ключ Tilda>
   ▼
https://tilda.ru/api/mcp/  →  get_projects, get_pages, get_page_settings …
Ключ Tilda никогда не попадает в ChatGPT. ChatGPT получает отдельный токен вашего шлюза и не знает ключа Tilda.

Что понадобится

  • Хостинг с PHP 8.1+ (лучше 8.2+), cURL и HTTPS на своём домене. Подойдёт обычный виртуальный хостинг.
  • Папка вне корня сайта (document root) для секретов и хранилища токенов.
  • Аккаунт Tilda с доступом к MCP-серверу (бета).
  • ChatGPT с возможностью добавлять пользовательские MCP-серверы (плагины).

Шаг 1. Создайте ключ Tilda MCP

  1. В Tilda откройте Профиль → MCP-сервер → Новый ключ.
  2. Выберите ограниченный доступ: только нужный проект и только те модули и действия, которые нужны (для начала только чтение).
  3. Задайте срок действия. Изменить его потом нельзя, только удалить ключ и создать новый.
  4. Скопируйте ключ: Tilda показывает его один раз. Не отправляйте его в чат, почту или мессенджер.

Шаг 2. Разместите файлы шлюза

ФайлЧто делает
api/tilda-mcp/index.phpMCP-сервер: отвечает 401 без токена, проверяет Bearer, обрабатывает initialize, tools/list, tools/call
api/tilda-mcp/oauth.phpOAuth-сервер: /authorize, /token, /register и форма подтверждения
auth_lib.phpDCR, PKCE S256, выдача и обновление токенов, файловое хранилище
bootstrap.phpПроверка HTTPS, версии PHP, конфига и доступа к хранилищу
tilda_bridge.phpКлиент MCP Tilda: список инструментов, фильтр «только чтение», вызовы tools/call
.well-known/oauth-protected-resource/…
.well-known/oauth-authorization-server/…
Метаданные OAuth, по которым ChatGPT находит авторизацию
.htaccessЗакрывает служебные PHP-файлы от прямого доступа
Папки .well-known лежат в корне сайта, а не внутри /api/, и должны открываться без токена. Если их нет, ChatGPT не найдёт OAuth и подключение остановится с ошибкой 404.

Шаг 3. Заполните приватный конфиг

Конфиг лежит в папке вне корня сайта, например _private/tilda-mcp/tilda-config.php. Он не должен попасть в public_html или в архив, который вы кому-то отправляете.
'tilda_token'      => '<КЛЮЧ_TILDA_MCP>',
'connect_password' => '<ОТДЕЛЬНЫЙ_СЛУЧАЙНЫЙ_ПАРОЛЬ>',
'project_ids'      => ['<ID_ВАШЕГО_ПРОЕКТА>'],
Не путайте три секрета:
  • connect_password: пароль, который вы вводите в форме вашего шлюза при подключении ChatGPT. В чат ChatGPT его не пишут.
  • Токен шлюза: его выдаёт ваш OAuth ChatGPT. В хранилище лежат только SHA-256-хеши.
  • Ключ Tilda: им пользуется только шлюз при запросах к tilda.ru.

Шаг 4. Укажите правильную версию протокола

  • Адрес Tilda пишется со слешем на конце: https://tilda.ru/api/mcp/. Без слеша сервер отвечает 301, а POST-запрос падает с 405.
  • Версия протокола: 2025-06-18 (также принимаются 2025-11-25 и 2026-07-28). На старую 2025-03-26 Tilda отвечает HTTP 400 с ошибкой -32022 Unsupported protocol version.
  • Передавайте заголовок MCP-Protocol-Version в каждом запросе, а также Accept: application/json, text/event-stream. Ответ может прийти как JSON или как SSE, и шлюз должен уметь читать оба.
  • Порядок вызовов: initialize → notifications/initialized → tools/list → tools/call.
  • В cURL отключите редиректы, включите проверку TLS-сертификата, задайте тайм-ауты и ограничение размера ответа.

Шаг 5. Проверьте шлюз до подключения ChatGPT

curl -i -X POST "https://ваш-домен/api/tilda-mcp/index.php" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data "{}"
  • Ожидаемый ответ: HTTP 401 с заголовком WWW-Authenticate: Bearer … resource_metadata=…. Это не ошибка: с этого ответа ChatGPT начинает авторизацию.
  • Адреса /.well-known/… должны открываться в браузере и отдавать JSON (HTTP 200).
  • Отдельно проверьте связь шлюза с Tilda из PHP CLI на хостинге, без ChatGPT.

Шаг 6. Создайте плагин в ChatGPT

  1. В ChatGPT откройте Плагины → «+» → Добавить пользовательский сервер MCP.
  2. Введите название, например «Tilda», описание и полный URL https://ваш-домен/api/tilda-mcp/index.php. Тип подключения: URL-адрес сервера (не «Туннель»).
  3. Аутентификация: OAuth. В расширенных настройках проверьте найденный issuer, регистрацию DCR и метод S256.
  4. Примите предупреждение о доверии к пользовательскому серверу и нажмите «Создать в виде плагина».
  5. Откроется форма вашего шлюза. Введите connect_password, а не ключ Tilda.
  6. После авторизации у плагина появятся инструменты.
Публиковать плагин в каталоге для собственного использования не нужно.

Шаг 7. Проверьте работу

В шлюзе достаточно трёх инструментов:
  • tilda_connection_check: проверяет связь с Tilda и показывает, сколько у неё инструментов;
  • tilda_discover_reads: выдаёт имена и схемы разрешённых методов чтения;
  • tilda_read_tool: вызывает выбранный метод с аргументами и отдаёт длинный ответ частями (offset/maxChars).
Попросите ChatGPT вызвать get_projects, потом get_pages и get_page_settings для своего проекта. В нашей проверке Tilda отдала 157 инструментов, а фильтр шлюза пропустил 106 методов чтения.

Важно: «только чтение» не гарантирует имя метода

Если фильтр шлюза пропускает имена на get/list/read и отклоняет create/update/delete/publish, этого мало. Например, store_get_filters_list, по описанию Tilda, может создать группу фильтров, если её нет. Поэтому:
  • просмотрите список разрешённых методов вручную и уберите те, что что-то меняют;
  • ограничьте права в самом ключе Tilda;
  • не доверяйте аннотациям readOnlyHint: это подсказка клиенту, а не защита.

Типичные ошибки

Что видноПричина и решение
ChatGPT не находит OAuth, 404Нет файла в скрытой папке .well-known или путь не совпадает. Положите метаданные по точному пути ресурса
HTTP 503 config_missingPHP не видит приватный конфиг. Проверьте путь относительно DOCUMENT_ROOT и права на файл
HTTP 401 на запрос без токенаТак и должно быть: это начало авторизации
HTTP 401 уже после входа в ChatGPTApache не передаёт заголовок Authorization в PHP. Читайте токен из HTTP_AUTHORIZATION, REDIRECT_HTTP_AUTHORIZATION и getallheaders()
Tilda: HTTP 400, -32022Старая версия протокола. Укажите 2025-06-18
Форма входа не закрывается после отправкиЗаголовок CSP form-action не разрешает редирект на chatgpt.com. Добавьте его в разрешённые
ChatGPT показывает старый список инструментовОбновите подключение плагина в настройках ChatGPT

Безопасность и обслуживание

  • Права на приватную папку 700, на конфиги 600.
  • Callback-адреса в OAuth только от chatgpt.com, без произвольных URI. Клиенты DCR только публичные, с PKCE.
  • Сроки жизни: код авторизации 5 минут, токен доступа 1 час, refresh-токен до 90 дней с ротацией.
  • После отладки удалите отладочные PHP-скрипты и проверьте, что в логах нет токенов.
  • Перед правкой файла сохраните копию и SHA-256, проверьте синтаксис командой php -l, после загрузки сразу проверьте инструменты из ChatGPT.
  • При утечке отзовите ключ в Tilda, замените его в конфиге и сбросите хранилище токенов шлюза. ChatGPT попросит авторизоваться заново.

Проще вариант: Claude Code

Если вам не обязательно работать именно в ChatGPT, Claude Code подключается к Tilda MCP напрямую, без шлюза и OAuth. Скопируйте готовую команду на странице ключа в Tilda и запустите её в терминале:
claude mcp add --transport http tilda https://tilda.ru/api/mcp/ --header "Authorization: Bearer <КЛЮЧ>"

Нужна помощь с подключением?

Настроим MCP-шлюз для Tilda, Яндекс Метрики, Вебмастера или вашей CRM и подключим его к ChatGPT или Claude Code. Напишите нам на api-master.ru.