Сервер Freshservice MCP

Обзор

Мощная реализация сервера MCP (Model Control Protocol), которая легко интегрируется с Freshservice, позволяя моделям ИИ взаимодействовать с модулями Freshservice и выполнять различные операции по управлению ИТ-услугами. Этот интеграционный мост позволяет вашим помощникам ИИ управлять и разрешать заявки на ИТ-услуги, оптимизируя рабочий процесс поддержки.

Основные характеристики

Интеграция Freshservice корпоративного уровня : прямая, безопасная связь с конечными точками API Freshservice
Совместимость с моделью ИИ : позволяет Claude и другим моделям ИИ выполнять операции службы поддержки через Freshservice
Автоматизированное управление ITSM : эффективное создание заявок, обновление, ответы и управление активами.
Ускорение рабочего процесса : сокращение ручного вмешательства в рутинные задачи ИТ-обслуживания.

Поддерживаемые модули Freshservice

В настоящее время этот сервер MCP поддерживает работу широкого спектра модулей Freshservice :

Билеты
Разговоры
Продукция
Запрашивающие
Агенты
Группы агентов
Группы запрашивающих
Готовые ответы
Готовые папки ответов
Рабочие пространства
Категории решений
Папки решений
Статьи по решению

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

Сервер предоставляет комплексный набор инструментов для работы Freshservice:

Управление билетами

Инструмент	Описание	Ключевые параметры
`create_ticket`	Создать новые сервисные билеты	`subject` , `description` , `source` , `priority` , `status` , `email`
`update_ticket`	Обновить существующие билеты	`ticket_id` , `updates`
`delete_ticket`	Удалить билеты	`ticket_id`
`search_tickets`	Найти билеты, соответствующие критериям	`query`
`get_ticket_fields`	Получить определения полей тикета	Никто
`get_tickets`	Список всех билетов с нумерацией страниц	`page` , `per_page`
`get_ticket`	Получить данные об отдельном билете	`ticket_id`

Начиная

Установка через Smithery

Чтобы установить freshservice_mcp автоматически через Smithery:

npx -y @smithery/cli install @effytech/freshservice_mcp --client claude

Предпосылки

Учетная запись Freshservice (зарегистрируйтесь на freshservice.com )
API-ключ Freshservice
установлен uvx ( pip install uv или brew install uv )

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

Сгенерируйте свой ключ API Freshservice из панели администратора:
- Перейдите в Настройки профиля → Настройки API.
- Скопируйте свой ключ API для настройки
Настройте свой домен и данные аутентификации, как показано ниже.

Использование с Claude Desktop

Установите Claude Desktop с официального сайта
Добавьте следующую конфигурацию в ваш claude_desktop_config.json :

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_API_KEY": "<YOUR_FRESHSERVICE_API_KEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

Важно : замените <YOUR_FRESHSERVICE_API_KEY> на ваш фактический ключ API, а <YOUR_FRESHSERVICE_DOMAIN> на ваш домен (например, yourcompany.freshservice.com ).

Примеры операций

После настройки вы можете попросить Клода выполнить такие операции, как:

«Создайте новый тикет об инциденте с темой «Проблема с сетевым подключением в отделе маркетинга» и описанием «Пользователи не могут подключиться к Wi-Fi в отделе маркетинга», установите высокий приоритет»
«Обновить статус запроса на изменение №45678 на «Одобрено»»
«Список всех критических инцидентов, зарегистрированных за последние 24 часа»
«Показать сведения об активе для ноутбука с тегом актива 'LT-2023-087'»
«Создайте запрос на изменение запланированного обслуживания сервера в следующий вторник в 2 часа ночи»

Тестирование

Для тестирования вы можете запустить сервер вручную:

uvx freshservice-mcp --env FRESHSERVICE_API_KEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

Поиск неисправностей

Проверьте правильность ключа API Freshservice и домена.
Обеспечьте надлежащее сетевое подключение к серверам Freshservice
Проверьте ограничения и квоты скорости API
Убедитесь, что команда uvx доступна в вашем PATH.

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Подробности смотрите в файле LICENSE в репозитории проекта.

Freshservice MCP server