freshservice-mcp

MCP-сервер (Model Context Protocol), который подключает ИИ-ассистентов к вашему экземпляру Freshservice ITSM. Управляйте заявками, активами, изменениями, проблемами, каталогом услуг, базой знаний и многим другим с помощью естественного языка.

Возможности

53 инструмента в 9 категориях:

Категория	Инструменты	Описание
Заявки	9	Список, получение, создание, обновление, удаление, ответ, добавление заметок, обсуждения, поиск
Активы	5	Список, получение, создание, обновление, удаление
Люди	8	Заявители, агенты, группы, отделы (список + получение)
Задачи по заявкам	5	Список, получение, создание, обновление, удаление подзадач в заявках
Учет времени	4	Список, создание, обновление, удаление записей о времени
Изменения	5	Список, получение, создание, обновление, удаление запросов на изменения
Проблемы	5	Список, получение, создание, обновление, удаление записей о проблемах
Каталог услуг	3	Просмотр элементов каталога, получение деталей, оформление запросов на услуги
База знаний	9	Категории, папки, статьи (полный CRUD)

Быстрый старт

Предварительные требования

Node.js 18+
Учетная запись Freshservice с доступом к API
Ваш API-ключ Freshservice (Значок профиля > Настройки профиля > API-ключ на правой панели)

Установка через npx (рекомендуется)

Установка не требуется. Настройте ваш MCP-клиент для запуска:

{
  "mcpServers": {
    "freshservice": {
      "command": "npx",
      "args": ["-y", "freshservice-mcp"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Глобальная установка

npm install -g freshservice-mcp

Затем настройте ваш MCP-клиент:

{
  "mcpServers": {
    "freshservice": {
      "command": "freshservice-mcp",
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Установка из исходного кода

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install

{
  "mcpServers": {
    "freshservice": {
      "command": "node",
      "args": ["/path/to/freshservice-mcp/src/index.js"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Конфигурация

Переменная	Обязательно	Описание
`FRESHSERVICE_DOMAIN`	Да	Ваш поддомен Freshservice (например, `yourcompany` для `yourcompany.freshservice.com`)
`FRESHSERVICE_API_KEY`	Да	Ваш API-ключ Freshservice

Настройка MCP-клиента

Claude Desktop — добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code — выполните claude mcp add freshservice -- npx -y freshservice-mcp, затем установите переменные окружения

Cursor / VS Code — добавьте в настройки MCP в соответствии с документацией вашего редактора

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

Заявки

Инструмент	Описание
`list_tickets`	Список заявок с фильтрами (статус, приоритет, заявитель, дата)
`get_ticket`	Получение полных сведений о заявке
`create_ticket`	Создание новой заявки
`update_ticket`	Обновление полей заявки (статус, приоритет, назначение и т.д.)
`delete_ticket`	Удаление заявки (перемещение в корзину)
`reply_to_ticket`	Отправка ответа на заявку
`add_note_to_ticket`	Добавление публичной или приватной заметки
`get_ticket_conversations`	Просмотр всех ответов и заметок
`search_tickets`	Фильтрация заявок с использованием синтаксиса запросов

Активы

Инструмент	Описание
`list_assets`	Список всех активов/CI
`get_asset`	Получение сведений об активе с пользовательскими полями
`create_asset`	Регистрация нового актива
`update_asset`	Обновление полей актива
`delete_asset`	Удаление актива

Люди и организация

Инструмент	Описание
`list_requesters` / `get_requester`	Конечные пользователи
`list_agents` / `get_agent`	Сотрудники поддержки
`list_groups` / `get_group`	Группы агентов с участниками
`list_departments` / `get_department`	Отделы

Задачи по заявкам

Инструмент	Описание
`list_ticket_tasks`	Список подзадач в заявке
`get_ticket_task`	Получение сведений о задаче
`create_ticket_task`	Добавление задачи к заявке
`update_ticket_task`	Обновление статуса/назначения задачи
`delete_ticket_task`	Удаление задачи

Учет времени

Инструмент	Описание
`list_time_entries`	Просмотр времени, затраченного на заявку
`create_time_entry`	Регистрация затраченного времени
`update_time_entry`	Изменение записи о времени
`delete_time_entry`	Удаление записи о времени

Изменения

Инструмент	Описание
`list_changes`	Список запросов на изменения
`get_change`	Получение сведений об изменении (тип, риск, расписание)
`create_change`	Создание запроса на изменение
`update_change`	Обновление полей изменения
`delete_change`	Удаление изменения

Проблемы

Инструмент	Описание
`list_problems`	Список записей о проблемах
`get_problem`	Получение сведений о проблеме
`create_problem`	Создание записи о проблеме
`update_problem`	Обновление полей проблемы
`delete_problem`	Удаление проблемы

Каталог услуг

Инструмент	Описание
`list_service_catalog_items`	Просмотр доступных услуг
`get_service_catalog_item`	Получение сведений об услуге и обязательных полей
`place_service_request`	Отправка запроса на услугу

База знаний

Инструмент	Описание
`list_solution_categories` / `get_solution_category`	Просмотр категорий БЗ
`list_solution_folders` / `get_solution_folder`	Просмотр папок БЗ
`list_solution_articles` / `get_solution_article`	Чтение статей
`create_solution_article`	Написание новой статьи
`update_solution_article`	Редактирование статьи
`delete_solution_article`	Удаление статьи

Примеры запросов

После настройки вы можете спрашивать своего ИИ-ассистента о следующем:

"Покажи мне все открытые заявки P1"
"Создай заявку о том, что принтер на 3-м этаже не работает"
"Какие активы назначены на Джона Смита?"
"Добавь приватную заметку к заявке #5678 о том, что мы ждем ответа от поставщика"
"Создай запрос на изменение для обновления брандмауэра, запланированного на следующий вторник"
"Поищи в базе знаний инструкции по настройке VPN"
"Запиши 2 часа работы в заявку #1234 для отладки сетевой проблемы"
"Покажи мне все открытые проблемы и их уровни влияния"
"Оформи запрос на новый ноутбук из каталога услуг"

Синтаксис поисковых запросов

Инструмент search_tickets использует синтаксис фильтров Freshservice:

"priority:4 AND status:2"          - Urgent + Open tickets
"group_id:12345"                   - Tickets assigned to a specific group
"agent_id:67890"                   - Tickets assigned to a specific agent
"created_at:>'2024-01-01'"         - Tickets created after a date

Разработка

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm test

Лицензия

MIT

Freshservice MCP Server