Документация TMS DoQA

Тема

Подключение DoQA: инструкция для ассистента ​

Эту инструкцию читаешь ты, ИИ-ассистент. Пользователь попросил подключить DoQA. Сделай всё сам: подключи MCP-сервер doqa и установи skill doqa. Пользователь может не знать, что такое MCP, поэтому не объясняй устройство и не проси его править настройки, если можешь сделать это сам. От него нужны только адрес DoQA и токен.

Правила ​

  • Не трогай другие MCP-серверы и skills. Если подключение doqa уже есть, покажи его и спроси, заменить ли.
  • Токен, присланный в чат, не повторяй в ответах и не показывай в выводе команд.
  • Не говори, что всё готово, пока не проверил подключение (шаг 6).

1. Адрес ​

Если пользователь не назвал адрес, спроси, по какому адресу он открывает DoQA в браузере. Отрежь путь после домена и порта: получится адрес DoQA. Адрес сервера MCP: адрес DoQA плюс /api/mcp. Например, https://company.doqa.app/projects/12 даёт адрес DoQA https://company.doqa.app и адрес сервера https://company.doqa.app/api/mcp. Это подходит и для облачной DoQA, и для DoQA на серверах компании.

Если у тебя есть терминал, проверь адрес сервера:

bash
curl -sS -o /dev/null -w '%{http_code}\n' -X POST '<адрес DoQA>/api/mcp' \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'
  • 401: адрес верный, сервер ждёт токен.
  • 404 или HTML-страница: адрес неверный, уточни у пользователя.
  • Ошибка сертификата: DoQA работает на сертификате компании, которому этот компьютер не доверяет. Скажи пользователю обратиться к администратору DoQA или в ИТ-отдел.
  • Нет ответа: DoQA может быть доступна только из внутренней сети или через VPN. Спроси, подключён ли пользователь к ней.

2. Skill ​

Скачай skill: https://docs.doqa.app/downloads/mcp/doqa/SKILL.md

Положи файл в папку skills своего ассистента на уровне пользователя, в подпапку doqa:

  • Claude Code: ~/.claude/skills/doqa/SKILL.md;
  • Codex, Cursor и другие ассистенты с поддержкой общего формата skills: ~/.agents/skills/doqa/SKILL.md.

Если в терминале нет интернета, скачай файл своим инструментом для веба и сохрани содержимое без изменений.

3. MCP-сервер ​

Подключи сервер в настройках того ассистента, в котором работаешь, на уровне пользователя, а не одного проекта:

  • имя: doqa;
  • транспорт: Streamable HTTP;
  • адрес: <адрес DoQA>/api/mcp;
  • заголовок: Authorization: Bearer <токен>.

Пока токена нет, ставь заглушку <токен>. Примеры:

  • Codex: добавь в ~/.codex/config.toml
    toml
    [mcp_servers.doqa]
url = "<адрес DoQA>/api/mcp"
http_headers = { Authorization = "Bearer <токен>" }
  • Cursor: добавь doqa в mcpServers файла ~/.cursor/mcp.json, сохранив другие серверы:
    json
    { "mcpServers": { "doqa": { "url": "<адрес DoQA>/api/mcp", "headers": { "Authorization": "Bearer <токен>" } } } }
  • Claude Code: файл ~/.claude.json правит сам Claude Code, вручную в него не пиши. Сервер добавляется командой claude mcp add на шаге 5, когда будет токен.

Для другого ассистента найди в его документации, где задаются MCP-серверы по HTTP с заголовками, и сделай так же. Если ассистент подключается к MCP только из облака (коннекторы в веб-версиях), сам ты его не настроишь. Дай пользователю ссылку: https://docs.doqa.app/user-guide/mcp/connection.html

4. Попроси токен ​

Напиши пользователю коротко, без терминов:

  1. Откройте <адрес DoQA>/home/profile/apiTokens (в DoQA: меню пользователя → Профиль → API-токены), нажмите Создать API-токен, назовите его, например, «Ассистент», и скопируйте. DoQA покажет токен один раз.
  2. Дальше выберите, как удобнее:
    • пришлите токен сюда, и я впишу его сам. Он останется в истории этого чата, поэтому, если в компании так нельзя, выберите второй вариант;
    • впишите токен сами: откройте файл (полный путь) и замените <токен> на скопированное значение. Bearer и пробел перед ним оставьте. Для Claude Code вместо файла дай команду, которая спросит токен скрытым вводом:
      bash
      read -r -s -p 'Токен DoQA: ' T; echo; claude mcp add --transport http --scope user doqa '<адрес DoQA>/api/mcp' --header "Authorization: Bearer $T"; unset T
      В PowerShell:
      powershell
      $s = Read-Host 'Токен DoQA' -AsSecureString; $t = [Net.NetworkCredential]::new('', $s).Password; claude mcp add --transport http --scope user doqa '<адрес DoQA>/api/mcp' --header "Authorization: Bearer $t"; Remove-Variable s, t

5. Впиши токен ​

Если пользователь прислал токен, впиши его вместо заглушки сам. В Claude Code выполни claude mcp add --transport http --scope user doqa '<адрес DoQA>/api/mcp' --header "Authorization: Bearer <токен>".

Затем проверь токен, если есть терминал. Возьми токен из настроек или из сообщения, а не печатай его:

bash
curl -sS -o /dev/null -w '%{http_code}\n' -X POST '<адрес DoQA>/api/mcp' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

200 значит, что токен работает. 401 значит, что токен неверный или удалён. Попроси скопировать его заново или создать новый.

6. Проверка ​

Скажи пользователю, что сделано, и попроси начать новую сессию ассистента: настройки подхватываются только при запуске. В новой сессии пусть напишет «Покажи мои проекты в DoQA».

Если в сессии ты видишь инструменты doqa.*, вызови doqa.projects.list и покажи результат: подключение готово. Если проблема осталась, дай ссылку: https://docs.doqa.app/user-guide/mcp/troubleshooting.html

Последнее обновление: