Freshdesk MCP server

Сервер Freshdesk MCP

Реализация сервера MCP, интегрирующаяся с Freshdesk, позволяющая моделям ИИ взаимодействовать с модулями Freshdesk и выполнять различные вспомогательные операции.

Функции

• Интеграция Freshdesk : бесперебойное взаимодействие с конечными точками API Freshdesk
• Поддержка моделей ИИ : позволяет моделям ИИ выполнять операции поддержки через Freshdesk.
• Автоматизированное управление тикетами : управление созданием тикетов, обновлениями и ответами

Компоненты

Инструменты

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

• create_ticket : Создание новых тикетов поддержки
  • Входные данные :
    • subject (строка, обязательно): Тема тикета
    • description (строка, обязательно): Описание тикета
    • source (номер, обязательно): Исходный код билета
    • priority (число, обязательно): уровень приоритета тикета
    • status (номер, обязательно): Код статуса тикета
    • email (строка, необязательно): Электронная почта запрашивающего
    • requester_id (число, необязательно): идентификатор запрашивающей стороны
    • custom_fields (объект, необязательно): Пользовательские поля для установки в тикете
• 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

Чтобы автоматически установить freshdesk_mcp для Claude Desktop через Smithery :

Предпосылки

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

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

1. Сгенерируйте свой ключ API Freshdesk из панели администратора Freshdesk
2. Настройте свой домен и данные аутентификации

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

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

Важные примечания :

• Замените YOUR_FRESHDESK_API_KEY на ваш фактический ключ API Freshdesk
• Замените YOUR_FRESHDESK_DOMAIN на ваш домен Freshdesk (например, yourcompany.freshdesk.com )

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

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

• «Создайте новый тикет с темой «Проблема с оплатой у клиента A101» и описанием «Обращение по поводу проблемы с оплатой за последний месяц у клиента A101», где адрес электронной почты клиента — a101@acme.com , и установите высокий приоритет»
• «Обновить статус тикета № 12345 на «Решено»»
• «Список всех высокоприоритетных заявок, назначенных агенту Джону Доу»
• «Список предыдущих тикетов клиента A101 за последние 30 дней»

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

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

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

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

Лицензия

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