18дел Документация

Интеграции

Подключить MCP для агентов

Удалённый Streamable HTTP сервер с личным Bearer-токеном.

Подготовка

  1. Создайте токен по инструкции.
  2. В настройках MCP вашего клиента добавьте удалённый сервер.
  3. Укажите URL https://tracker.18d.ru/mcp/ и транспорт Streamable HTTP.
  4. Передайте HTTP-заголовок Authorization: Bearer YOUR_TOKEN.
  5. Переподключите сервер/обновите список инструментов в клиенте.

Пример конфигурации

{
  "mcpServers": {
    "tracker18": {
      "url": "https://tracker.18d.ru/mcp/",
      "headers": {"Authorization": "Bearer YOUR_TOKEN"}
    }
  }
}

Это распространённая форма JSON-конфигурации; конкретный MCP-клиент может использовать другую форму, секретное хранилище или переменные окружения. Не вставляйте этот пример с YOUR_TOKEN без замены в настройках клиента. Точный путь файла зависит от клиента.

Первая проверка

Попросите агента сначала получить список очередей и статусов, затем найти тестовую задачу. Для проверки записи используйте отдельную тестовую очередь. Не просите изменять реальные задачи только ради подключения.

Пример запроса агенту: «Покажи доступные мне очереди и задачи в работе. Ничего не меняй». Для записи: «В очереди DEMO создай тестовую задачу с указанным названием» — только после выдачи write.

Права и неполадки

401 — токен не принят, 403/ошибка инструмента — не хватает прав, пустой список очередей — права ещё не выданы. Если после обновления сервиса не появились новые инструменты, обновите их список в клиенте. Используйте справочник инструментов. Клиент должен выполнить стандартное MCP initialize перед вызовами; endpoint не является обычным REST-методом.