Сервер Freshdesk MCP

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

Функции

• Интеграция Freshdesk : бесперебойное взаимодействие с конечными точками API Freshdesk

• Поддержка моделей ИИ : позволяет моделям ИИ выполнять операции поддержки через Freshdesk.

• Автоматизированное управление тикетами : управление созданием тикетов, обновлениями и ответами

Related MCP server: mcp-jira-server

Компоненты

Инструменты

Сервер предлагает несколько инструментов для работы 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 :

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

Предпосылки

• Учетная запись 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 :

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

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

• Замените YOUR_FRESHDESK_API_KEY на ваш фактический ключ API Freshdesk

• Замените YOUR_FRESHDESK_DOMAIN на ваш домен Freshdesk (например, yourcompany.freshdesk.com )

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

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

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

• «Обновить статус тикета № 12345 на «Решено»»

• «Список всех высокоприоритетных заявок, назначенных агенту Джону Доу»

• «Список предыдущих тикетов клиента A101 за последние 30 дней»

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

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

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

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

• Проверьте правильность ключа API Freshdesk и домена.

• Обеспечьте надлежащее сетевое подключение к серверам Freshdesk

• Проверьте ограничения и квоты скорости API

• Убедитесь, что команда uvx доступна в вашем PATH.

Лицензия

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