Подключение MCP для AI-клиентов (Claude, Cursor, VS Code)

Для кого

Для тех, кто хочет управлять поддержкой через ИИ-ассистента на естественном языке: создавать заявки, отвечать клиентам, смотреть аналитику и настраивать автоматизацию словами, без программирования. Подходит для Claude Desktop, Claude Code, Cursor, VS Code (Copilot/Continue) и любого клиента с поддержкой MCP.

Что такое MCP

MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-ассистенты подключаются к внешним системам. У TehProf Support есть готовый MCP-сервер: подключив его к своему ИИ-клиенту, вы даёте ассистенту набор инструментов вашей поддержки. Сервер уже работает и доступен публично — ничего разворачивать не нужно.

• Адрес сервера: https://support.tehprof.kz/mcp
• Карточка сервера: https://support.tehprof.kz/.well-known/mcp.json
• Транспорт: Streamable HTTP (спецификация MCP 2025-03-26)
• Аутентификация: API-ключ (Bearer). Без ключа доступен бесплатный набор инструментов.

Подключение за 3 шага

• Получите API-ключ — в админ-панели: Настройки → Интеграции → карточка «MCP для AI-агентов» → «Создать API-ключ» (или Настройки → API). Ключ показывается один раз — сохраните его. Можно начать и без ключа на бесплатном тарифе.

• Вставьте конфиг в настройки вашего ИИ-клиента (примеры ниже).

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

Конфигурация по клиентам

Claude Code / Cursor / VS Code / Continue.dev

Эти клиенты поддерживают прямой HTTP-транспорт MCP:

{
  "mcpServers": {
    "tehprof-support": {
      "url": "https://support.tehprof.kz/mcp",
      "headers": { "Authorization": "Bearer sk_ВАШ_КЛЮЧ" }
    }
  }
}

Claude Desktop

Классический Claude Desktop работает через stdio — используйте мост mcp-remote (требуется Node.js). Файл claude_desktop_config.json:

{
  "mcpServers": {
    "tehprof-support": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://support.tehprof.kz/mcp", "--header", "Authorization: Bearer sk_ВАШ_КЛЮЧ"]
    }
  }
}

Чтобы попробовать бесплатный тариф — уберите строку с headers (или --header). Без ключа ассистент работает анонимно и видит только бесплатные инструменты.

Тарифы инструментов

Тариф определяется по вашему API-ключу. Бесплатные инструменты доступны всегда.

Что умеет ассистент

• «Создай заявку: у клиента не открывается 1С после обновления, категория — прочее» — заведёт заявку.
• «Ответь клиенту в заявке №10094, что перезагрузка решит проблему» — отправит ответ.
• «Покажи аналитику за неделю: сколько заявок закрыто и среднее время реакции» — вернёт сводку.
• «Найди в базе знаний статьи про подключение WhatsApp» — выполнит поиск.

Безопасность

• API-ключ — это пропуск к вашим данным. Храните его как пароль, не публикуйте в открытых репозиториях.
• Тенант определяется по ключу: ассистент видит только данные вашей компании.
• Права ключа ограничены областями (scopes) — выдавайте минимально необходимые.
• Если ключ скомпрометирован — отзовите его в Настройки → API и создайте новый.

Если что-то не работает

• Инструменты не появились — проверьте, что клиент перезапущен и конфиг валиден (двойные кавычки, запятые).
• Только бесплатные инструменты — не добавлен заголовок Authorization или ключ без нужных прав/истёк.
• Claude Desktop не видит сервер — убедитесь, что установлен Node.js (для npx mcp-remote).
• Проверить сервер — откройте https://support.tehprof.kz/.well-known/mcp.json в браузере: должна вернуться карточка сервера.

Смежные инструкции

• Программное управление по REST/ctoken/JWT (для разработчиков): см. «Интеграция с Support по API» (guides/api-integration.md).