concierge-mcp

Локальный MCP-сервер для Concierge — платформы поддержки клиентов, созданной специально для Discord.

Подключите своего ИИ-агента (Claude Desktop, Cursor, Cline или любой другой MCP-совместимый клиент) к вашему серверу поддержки Concierge и управляйте всем стеком поддержки с помощью естественного языка. Более 200 инструментов охватывают жизненный цикл тикетов, настройку ИИ, базу знаний, панели, автоматизацию, аналитику, биллинг, общение в Discord и многое другое.

Что вы можете делать

"Настрой Concierge для моего SaaS — разверни панель в #support, дай доступ агента @Mod и @Admin, и установи SLA 30 минут для тикетов с высоким приоритетом."

"Покажи мне отчет CSAT за последние 30 дней, а затем предложи ответ для тикета #142."

"Массово закрой все тикеты старше 7 дней, на которые нет ответа агента, и отправь клиенту транскрипт в личные сообщения."

"Отложи тикет #88 до завтра 9 утра по восточному времени и пометь клиента как VIP."

Установка

Claude Desktop

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

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Перезапустите Claude Desktop. Вы должны увидеть "concierge" в списке MCP-серверов со всеми 200+ доступными инструментами.

Cursor

Добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / другие MCP-клиенты

Используйте ту же структуру command/args/env — каждый MCP-клиент поддерживает stdio-серверы.

Получение учетных данных

1. Откройте панель управления Concierge по адресу conciergetickets.net/dashboard

2. Откройте любую панель → Advanced → MCP Settings

3. Включите MCP Enabled — это создаст API-ключ

4. Скопируйте API-ключ (установите его как CONCIERGE_MCP_KEY)

5. Ваш Guild ID — это ID сервера Discord, который можно найти в URL или через правый клик → Copy Server ID (требуется режим разработчика)

Как это работает

Этот пакет является легким stdio-прокси. Когда ваш MCP-клиент запускает его, он:

1. Подключается к MCP-серверу Concierge по адресу https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp

2. Проходит аутентификацию с помощью вашего API-ключа

3. Загружает актуальный каталог инструментов (поэтому новые инструменты, выпущенные Concierge, появляются автоматически без переустановки)

4. Перенаправляет каждый вызов инструмента на удаленный сервер

Локальный бинарный файл компактен и не хранит состояние. Данные вашей гильдии остаются на инфраструктуре Concierge.

Категории инструментов

• Тикеты — полный жизненный цикл (принять, отложить, переоткрыть, завершить, перевести, заблокировать, объединить, разделить и т.д.), а также массовые операции

• ИИ — суммаризация тикетов, анализ тональности, предложение ответов, перегенерация ответов, перевод

• База знаний — полный CRUD + поиск + импорт из GitBook

• Клиенты — профили, заметки, переключатель VIP, черный список с опциональным сроком действия

• Панели — создание/развертывание/переразвертывание с полной настройкой эмбедов

• Конфигурация — все настройки TicketPanel и Guild через update_panel_config / update_guild_config

• Discord — отправка сообщений, личных сообщений, реакций, публикация объявлений, поиск каналов/ролей/участников

• Вебхуки — полный CRUD + тестирование, повторная доставка, статистика

• Аналитика — обзор, часы пик, таблица лидеров агентов, экспорт в CSV

• CRM — тестирование, синхронизация, получение данных из Salesforce/HubSpot/Zendesk/Freshdesk

• Cron-триггеры — запуск сканирования SLA, автозакрытие, проверка эскалации по требованию

• Команда — приглашение, удаление, установка рабочей нагрузки/расписания/статуса/навыков

Запустите npx -y concierge-mcp и вызовите tools/list, чтобы увидеть полный актуальный каталог.

Эндпоинты для обнаружения (для интеграций без MCP)

• GET https://api.conciergetickets.net/api/v1/public/openapi.json — полная спецификация OpenAPI 3.1 для REST API

• GET https://api.conciergetickets.net/api/v1/public/schema.json — распарсенная схема Prisma (все модели, поля, перечисления)

Ссылки

• Concierge: https://conciergetickets.net

• Документация: https://conciergetickets.net/docs

• Model Context Protocol: https://modelcontextprotocol.io

Лицензия

MIT