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	Може да разглежда данни, но не може да създава, обновява или изтрива

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

← Обратно към ръководството