Регистрация

Доступ по API

Токены для программ и ИИ-агентов

API-токен даёт внешней программе доступ к вашему пространству вместо пароля. Так подключают ИИ-агента, который сам создаёт заметки и задачи, скрипт переноса данных или сервис автоматизации.

  1. Откройте «Профиль» → вкладка «API-токены».
  2. Нажмите «Создать токен», укажите название, что разрешено и срок действия.
  3. Скопируйте токен сразу: второй раз он показан не будет. Если потеряли — выпустите новый, а старый отзовите.
  4. Передайте токен программе. Большинство клиентов принимает его как заголовок Authorization.

Токен передаётся заголовком Authorization со словом Bearer. Адрес пространства указывать не нужно: он берётся из самого токена, поэтому агенту достаточно знать только его.

curl -H "Authorization: Bearer dbt_ваш_токен" \
  https://api.get4.ru/api/nodes
curl -X POST https://api.get4.ru/api/nodes \
  -H "Authorization: Bearer dbt_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"type": "note", "title": "Заметка от агента"}'
  • «Только чтение» — программа видит данные, но ничего не меняет и не удаляет. Подходит агенту, который отвечает на вопросы по вашей базе.
  • «Полный доступ» — программа создаёт, меняет и удаляет всё, что можете вы. Нужен агенту, который ведёт задачи и записывает заметки.
  • Срок действия: 30, 90, 365 дней или бессрочно. По умолчанию 90 — токен, о котором забыли, перестаёт работать сам.

Токен действует от вашего имени и в пределах ваших прав. Если вы администратор пространства, токен получает администраторский доступ — обращайтесь с ним как с паролем.

Отзыв — кнопка «Отозвать» в списке. Токен перестаёт работать сразу, программа получает отказ на следующем же запросе. Отозванные токены остаются в списке с отметкой, чтобы было видно, какой доступ и когда вы закрыли.

Полный перечень методов, полей и ответов — на странице документации API по адресу api.get4.ru/api-docs. Она же отдаёт машинное описание в формате OpenAPI, которое понимают большинство клиентов и генераторов кода.

Подключение ИИ-агента (MCP)

Claude, ChatGPT, Cursor и другие ИИ-клиенты подключаются к пространству по протоколу MCP. Агент ищет, создаёт и меняет записи по вашей просьбе — сущности, доски, комментарии, время, базу знаний — всё, что можете вы сами. Адрес сервера: api.get4.ru/mcp. Готовые настройки для каждого клиента — в «Профиль» → «API-токены», блок «Подключить ИИ-агента».

  1. claude.ai и ChatGPT: добавьте коннектор (custom connector) по адресу https://api.get4.ru/mcp. Откроется страница get4 — проверьте, какое приложение просит доступ и к какому пространству, и нажмите «Разрешить». Токен создавать не нужно.
  2. Claude Code: создайте токен и выполните команду из блока «Подключить ИИ-агента» — она добавит сервер с заголовком Authorization.
  3. Claude Desktop и Cursor: создайте токен и добавьте фрагмент из того же блока в настройки MCP-серверов клиента.
claude mcp add --transport http get4 https://api.get4.ru/mcp \
  --header "Authorization: Bearer dbt_ваш_токен"
  • Агенту недоступны токены, пароль и сессии, оплата, удаление аккаунта и пространства — даже если вы сами это можете.
  • Токен «Только чтение» даёт агенту только чтение; при подключении через OAuth режим видно на странице согласия.
  • Подключения через OAuth видны в списке токенов с пометкой «через OAuth» и отключаются кнопкой «Отключить».