AI API и доступ ассистентов

AI API позволяет подключить внешний AI-ассистент к одному рабочему пространству iTasks. Ассистент получает доступ только к данным выбранного пространства: проектам, участникам, задачам, комментариям, учёту времени и HelpDesk-сценариям.

1. Требования перед подключением

• Доступ настраивает только пользователь с ролью Владелец.
• Для работы AI API нужна активная подписка PRO на это пространство.
• Если PRO закончится, discovery, MCP, OpenAPI и REST перестанут работать до восстановления подписки. Данные пространства при этом не удаляются автоматически; поведение тарифов описано в подписке и ограничениях.

2. Как включить AI API

1. Откройте Администрирование → Настройки пространства.
2. В блоке AI-доступ выберите AI API.
3. Создайте токен доступа, если он ещё не создан.
4. Включите AI-доступ для пространства.
5. Скопируйте ссылку для подключения и передайте её AI-ассистенту.

Ссылка уже содержит токен пространства, поэтому AI-клиенту не нужно выбирать пространство или передавать его идентификатор. Все запросы автоматически ограничены одним рабочим пространством.

3. Дополнительная Bearer-защита

URL-токен в ссылке сам по себе даёт доступ к AI API пространства. Поэтому для реального подключения лучше создать Bearer-токен и включить дополнительную защиту: тогда клиент должен отправлять заголовок Authorization: Bearer <token> вместе со ссылкой.

Полный Bearer-токен показывается только один раз после создания или перевыпуска. Если клиент потерял токен, владелец должен перевыпустить его в этом же разделе. Доступ без Bearer-защиты стоит оставлять только для AI-систем, которые технически не умеют отправлять заголовок авторизации.

4. Какие варианты подключения есть

Интерфейс показывает несколько URL для разных типов клиентов:

• Ссылка для подключения — рекомендованный discovery-адрес для большинства ассистентов.
• MCP URL — подключение через Model Context Protocol.
• OpenAPI схема — описание REST API в формате OpenAPI 3.1 для клиентов, которые умеют импортировать схему.
• REST base URL — базовый адрес JSON REST API для ручной настройки.

5. Рабочие сценарии: Codex и Claude Code

Для обычной проверки отправьте ассистенту ссылку для подключения. Для ручной настройки MCP-клиента используйте MCP URL. Если включена дополнительная Bearer-защита, вместе с MCP URL нужен Bearer-токен: он показывается в iTasks только один раз после создания или перевыпуска.

# Если включена дополнительная Bearer-защита, сначала задайте ITASKS_AI_BEARER_TOKEN в shell.
codex mcp add itasks --url "<MCP_URL_FROM_ITASKS>" --bearer-token-env-var ITASKS_AI_BEARER_TOKEN
codex mcp list

codex mcp add itasks --url "<MCP_URL_FROM_ITASKS>"
codex mcp list

Подключись к iTasks по этой ссылке:
<CONNECTION_LINK_FROM_ITASKS>

Сначала ничего не изменяй. Прочитай discovery/MCP-возможности, проверь проекты, участников и статусы задач. Кратко расскажи, что ты можешь делать в этом пространстве и какие действия требуют моего отдельного подтверждения.

Используй MCP-сервер iTasks `itasks`. В проекте "<PROJECT_NAME>" нужно подготовить и запустить лендинг о "<TOPIC>".

Сначала вызови безопасные операции чтения: проекты, участников и статусы задач. Затем создай набор задач с понятными названиями, описанием в Taskbot rich text HTML, приоритетами, дедлайнами и ответственными только из найденных участников. Не удаляй и не закрывай существующие задачи. В конце верни список созданных задач, ответственных, дедлайны и допущения.

claude mcp add --transport http --header "Authorization: Bearer <ITASKS_BEARER_TOKEN>" itasks "<MCP_URL_FROM_ITASKS>"
claude mcp list

claude mcp add --transport http itasks "<MCP_URL_FROM_ITASKS>"
claude mcp list

Подключись к iTasks по этой ссылке:
<CONNECTION_LINK_FROM_ITASKS>

Сначала ничего не изменяй. Прочитай discovery/MCP-возможности, проверь проекты, участников и статусы задач. Кратко расскажи, что ты можешь делать в этом пространстве и какие действия требуют моего отдельного подтверждения.

Используй MCP-сервер iTasks `itasks`. В проекте "<PROJECT_NAME>" нужно подготовить и запустить лендинг о "<TOPIC>".

Сначала вызови безопасные операции чтения: проекты, участников и статусы задач. Затем создай набор задач с понятными названиями, описанием в Taskbot rich text HTML, приоритетами, дедлайнами и ответственными только из найденных участников. Не удаляй и не закрывай существующие задачи. В конце верни список созданных задач, ответственных, дедлайны и допущения.

6. Что ассистент может делать

Текущая реализация открывает AI-инструментам рабочие сценарии пространства: чтение проектов, участников, задач и статусов; поиск задач; создание, изменение и удаление задач; смену статуса, workflow и исполнителя; работу с подзадачами, комментариями и учётом времени; просмотр HelpDesk-каналов, обращений и сообщений; добавление внешних ответов, внутренних заметок и связей обращений с задачами.

7. Технические детали для настройки клиента

• Основной формат обмена для REST — JSON.
• Форматированные текстовые поля задач, комментариев и HelpDesk-сообщений передаются как HTML.
• На AI API действуют лимиты частоты запросов на уровне пространства. При превышении лимита API возвращает ошибку 429, поэтому клиенту не стоит делать плотный polling.
• Ссылка, MCP, OpenAPI и REST относятся к одному пространству. Для другого пространства владелец настраивает отдельный доступ.

Связанные разделы

Общие настройки пространства описаны в настройках рабочего пространства. Роли владельца и администраторов раскрыты в участниках и ролях. Если AI должен работать с HelpDesk, сначала настройте ботов и каналы поддержки.