Digital Specialist: Настройка MCP для ИИ-агента

Подключите вашего ИИ-агента (Claude, GPT, Cursor, Kiro или любой MCP-совместимый клиент) к Digital Specialist для программного управления задачами, проектами, геозонами, участниками команды и чатами.

Шаг 1: Создайте ИИ-агента

В мобильном приложении DS: Настройки → Команда → Добавить участника → Создать агента. Введите имя и выберите роль. После создания вы увидите:

Client ID — например ds-agent-my-bot-a1b2c3d4
Client Secret — показывается один раз, сохраните сразу
Token Endpoint — https://ds-app.biz/auth/realms/ds/protocol/openid-connect/token

⚠️ Важно: Client Secret показывается только один раз при создании. Скопируйте и сохраните его в надёжном месте — позже получить его будет невозможно. В случае утери вы можете сгенерировать новый секрет в настройках агента.

Шаг 2: Настройте MCP-клиент

Добавьте следующее в конфигурацию вашего MCP-клиента (например, mcp.json в Kiro/Cursor или конфиг Claude Desktop):

{
  "mcpServers": {
    "digital-specialist": {
      "type": "streamableHttp",
      "url": "https://ds-app.biz/mcp",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

Шаг 3: Получите токен доступа

Обменяйте учётные данные клиента на токен доступа:

curl -X POST https://ds-app.biz/auth/realms/ds/protocol/openid-connect/token \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Скопируйте access_token из ответа и вставьте его в заголовок Authorization выше.

ℹ️ Примечание: Токены истекают через 5 минут по умолчанию. Для длительных сессий запрашивайте токен повторно или используйте скрипт с автоматическим обновлением.

Шаг 4: Проверьте подключение

Проверьте подключение, попросив ИИ-агента показать ваши задачи или проекты. Если всё настроено правильно, он будет использовать MCP-инструменты для запросов к Digital Specialist.

Доступные группы инструментов

MCP-сервер предоставляет следующие группы инструментов:

Группа инструментов	Описание
Work Items	Список, просмотр, создание, обновление, архивация и восстановление задач
Task Comments	Добавление, редактирование, список и поиск комментариев к задачам — с ветками, @упоминаниями, вложениями и эмодзи-реакциями
Projects	Список, просмотр, создание, обновление, архивация и восстановление проектов; количество задач по проектам
Geo Zones	Список, просмотр, создание, обновление, архивация и восстановление геозон
Team Members	Список и поиск участников компании по имени или типу пользователя
Chat	Личные переписки 1-на-1: отправка, редактирование, удаление сообщений, история, ветки ответов, поиск, эмодзи-реакции, отметка прочитанным, счётчик непрочитанных
Task Conversations	Групповые чаты по задачам — создание или открытие переписки, привязанной к задаче, с общими сообщениями, ветками и реакциями для участников задачи
Files	Загрузка, скачивание и удаление вложений задач; список и скачивание файлов компании
User Profile	Просмотр и обновление профиля, установка аватара и адреса

Разрешения

Разрешения агента задаются при создании и определяют доступные действия:

Уровень доступа	Возможности
Read & Write	Полный доступ ко всем инструментам — просмотр, создание, обновление и удаление
Read Only	Может просматривать данные, но не может создавать, обновлять или удалять

Роль агента (Администратор, Менеджер, Специалист, Наблюдатель) также определяет доступ к данным — так же, как и для обычных пользователей. Например, агент с ролью Специалист видит только публичные проекты и приватные проекты, в которых он является участником.

← Вернуться к руководству