MCP-ключи

MCP-ключ — это Bearer-токен, которым авторизуется внешний агент. Каждый ключ имеет имя, набор scopes (прав) и, при желании, срок действия.

Создание ключа

1. Откройте личный кабинет → вкладка MCP.
2. Нажмите Создать, задайте имя (например, Claude Desktop laptop) и выберите нужные scopes.
3. Скопируйте токен.

Токен показывается один раз

Полный токен виден только в момент создания. Он хранится в виде SHA-256-хеша и не может быть восстановлен — при утере ключ придётся перевыпустить. Сохраните его в менеджере паролей сразу.

Формат токена: gtmcp_ + случайная строка. Пример:

gtmcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Scopes (права доступа)

Выдавайте ключу минимально необходимый набор прав.

Доступные scopes

Параметр	Тип	Описание
workflow:read	scope	Только чтение: список воркфлоу, их содержимое, статус выполнений
workflow:write	scope	Создание, изменение, удаление воркфлоу, форк и публикация шаблонов, загрузка медиа
workflow:execute	scope	Запуск, отмена, retry и reset выполнений
workflow:*	scope	Все права на воркфлоу (read + write + execute). Значение по умолчанию

Каталог доступен всегда

Инструменты каталога и диагностики (list_node_types, get_node_type, list_templates, list_orgs, whoami) не требуют scope и доступны любому валидному ключу.

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

Каждый запрос к /mcp должен содержать заголовок:

Authorization: Bearer gtmcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Невалидный, отозванный или просроченный токен → 401 Unauthorized с заголовком WWW-Authenticate: Bearer. Отсутствие привилегии MCP_USER → 403 Forbidden.

Отзыв ключа

Профиль → вкладка MCP → значок корзины рядом с ключом. Отзыв мгновенный: все запросы с этим токеном сразу начинают получать 401.