CometChat MCP Server

Добавьте в ваше приложение чат в реальном времени, голос, видео и модерацию — через вашего AI-агента по кодированию.

Документация • CometChat • Создать аккаунт (бесплатно, 100 MAU)

---

Собственный MCP-сервер от CometChat. Подключайте Claude, Cursor, Windsurf, VS Code Copilot, Codex или любого другого агента, совместимого с Model Context Protocol, и интегрируйте CometChat в ваше приложение по подсказкам на естественном языке.

Спросите агента: «добавить вкладку чата, чтобы пользователи могли общаться в личном чате» — он читает документацию CometChat, подбирает подходящие компоненты для вашего стека и пишет код интеграции.

Только для чтения. Аккаунт, API-ключ и аутентификация не требуются.

---

Demo

ИИ-агент читает документацию CometChat и пишет рабочую интеграцию чата по одной подсказке.

---

Быстрая установка

Агент	Как добавить
Claude.ai / Claude Desktop	Настройки → Коннекторы → Добавить кастомный коннектор → URL: https://mcp.cometchat.com/mcp
Cursor	Cmd+Shift+P → Открыть настройки MCP → Добавить custom MCP → вставьте конфигурацию ниже
Windsurf	Плагины ( значок молотка ) → Управление плагинами → Просмотреть исходную конфигурацию → вставьте конфигурацию ниже
VS Code (Copilot Agent)	Cmd+Shift+P → MCP: Add MCP Server → URL: https://mcp.cometchat.com/mcp, Transport: HTTP
Claude Code (CLI)	claude mcp add --transport http cometchat https://mcp.cometchat.com/mcp
Smithery	npx -y smithery mcp add cometchat/docs-mcp
Codex CLI	codex plugin marketplace add cometchat/docs-mcp

Конфигурационный фрагмент (Cursor / Windsurf / generic MCP клиенты)

{
  "mcpServers": {
    "cometchat": {
      "url": "https://mcp.cometchat.com/mcp"
    }
  }
}

---

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

После подключения задавайте вашему агенту любой из следующих запросов:

• "How do I install the React UI Kit in my Vite project?" → переведено ниже
• "Walk me through multi-tenant chat for a Next.js SaaS where workspaces are isolated."
• "Show me how to add presence indicators and typing dots to my iOS conversation list."
• "Set up content moderation so banned words are blocked before delivery."
• "Build a no-code chat widget for my Webflow site."
• "What's the rate limit for sending messages, and what error code do I get when I hit it?"

Агент читает документацию CometChat, подбирает релевантный пакет реализации и генерирует код интеграции в ваш проект.

---

Инструменты

• search_cometchat_docs — Поиск по руководствам SDK, справочникам UI Kit, документации REST API и спецификациям OpenAPI. Возвращает ранжированные фрагменты с заголовками и прямыми ссылками. Опциональный фильтр version.

• fetch_cometchat_doc_page — Получение полного содержания любой страницы документации в формате markdown по URL или относительному пути.

• get_cometchat_implementation_bundle — Возвращает отобранный пакет реализации для заданного сценария — предпосылки, команды установки, конфигурация, рабочий код.

• list_cometchat_bundles — Перечень всех доступных bundles реализации (идентификатор, заголовок, фреймворк, дата последней проверки) для поиска.

Все четыре элемента содержат readOnlyHint: true, аннотацию title и объявленный outputSchema с структурированными результатами. Названия ≤ 64 символов. Описания описывают лишь контракт — никаких поведенческих инструкций агенту, никакой маршрутизации между инструментами и ничего маркетингового.

Ресурсы

URI	Назначение
cometchat://skills/overview	Навык ориентации агентa — краткое описание продукта, руководство по принятию решений, рабочий процесс, распространённые подводные камни, чеклист проверки
cometchat://bundles/react-uikit-quickstart	React UI Kit установка + инициализация + вход в систему + чат-поверхность
cometchat://bundles/react-native-uikit-quickstart	React Native UI Kit с навигацией и экраном чата
cometchat://bundles/flutter-uikit-quickstart	Flutter UI Kit установка + инициализация + базовый чат
cometchat://bundles/ios-uikit-quickstart	iOS UI Kit (SwiftUI) установка + чат-вью
cometchat://bundles/android-uikit-quickstart	Android UI Kit (Jetpack Compose) установка + экран чата
cometchat://bundles/js-sdk-messaging-basics	Vanilla JS SDK — отправка/приём текстовых и медиа-сообщений
cometchat://bundles/widget-embed	No-code виджет для HTML, Squarespace, Webflow, Wix, WordPress, Shopify
cometchat://bundles/moderation-setup	Правила модерации AI, модерация изображений, вебхуки
cometchat://bundles/multi-tenant-chat	Multi-tenant SaaS чат — изоляция арендаторов, Auth Tokens, выдаваемые сервером
cometchat://bundles/presence-and-typing	Онлайн-присутствие, индикаторы набора текста, прочитанные сообщения

---

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

• Вы формулируете запрос вашему агенту на естественном языке.

• Агент читает orientation skill (cometchat://skills/overview) чтобы понять, какой инструмент/bundle лучше подходит под ваш запрос.

• Для топовых сценариев агент подбирает отобранный bundle реализации — готовый коды с prerequisites, командами установки, конфигурацией и рабочими примерами.

• Для редких вопросов агент ищет в документации CometChat и читает конкретные справочные страницы.

• Агент записывает код в ваш проект, используя bundle как источник истины и учитывая структуру вашего проекта.

---

CometChat в 30 секунд

CometChat — платформа для коммуникаций в реальном времени, которая позволяет добавлять чат, голосовую и видеозвонки в веб и мобильные приложения. Используется на продакшене в SaaS, маркетплейсах, гейминге, здравоохранении, образовании и платформах для создателей контента.

• Бесплатный тариф: первые 100 MAU в месяц, карта не требуется.

• SDKs: JavaScript, React Native, iOS, Android, Flutter.

• UI Kits: React, React Native, iOS, Android, Flutter, Angular, Vue.

• No-code: чат-виджет для любого HTML-сайта.

• Регистрация: app.cometchat.com — вам понадобятся App ID, Auth Key и Region, чтобы работать с кодом, который напишет агент.

---

Identity сервера

Поле	Значение
Display name	CometChat Docs
Version	0.1.6
Protocol	MCP 2025-06-18
Transport	Streamable HTTP (with SSE)
Authentication	None (public docs only)
Capabilities	инструменты, ресурсы
Health endpoint	GET https://mcp.cometchat.com/health

---

Архитектура

Your agent (Claude / Cursor / Windsurf / …)
        ↓ MCP over Streamable HTTP
        ↓
  mcp.cometchat.com/mcp  (this server)
        ↓
  ├── search_cometchat_docs     → SQLite FTS5 index of cometchat/docs
  ├── fetch_cometchat_doc_page  → cometchat.com/docs/*.md (first-party)
  └── get_cometchat_implementation_bundle → bundled markdown recipes

• Stateless server, single universal endpoint, no user-specific state.

• Search index rebuilds from github.com/cometchat/docs on every push to that repo's main branch.

• Implementation bundles carry a last_verified date and are re-checked against live SDK versions quarterly.

---

Локальная разработка

# Clone the docs repo (used to build the search index)
git clone --depth 1 https://github.com/cometchat/docs.git ../cometchat-docs-repo

# Install + build the FTS index + run the server
npm install
DOCS_REPO=../cometchat-docs-repo npm run build:index
npm run dev

# Run the test suite (36 tests across validation, truncation, bundles, tools, resources, fetch)
npm test

Сервер по умолчанию слушает на http://0.0.0.0:3000. Точка проверки работоспособности: GET /health, MCP-эндпойнт: POST /mcp.

Inspect with the MCP Inspector

npx @modelcontextprotocol/inspector
# add server: http://localhost:3000/mcp

Вы должны увидеть все 4 инструмента с readOnlyHint: true и все 11 ресурсов.

Структура репозитория

docs-mcp/
├── src/
│   ├── server.ts                  # MCP server entry, transport, tool dispatch
│   ├── tools/{search,fetch,bundle}.ts
│   ├── search/sqlite.ts           # SQLite FTS5 client
│   ├── bundles/loader.ts          # markdown bundle store
│   ├── resources/registry.ts      # skill + bundle resources
│   └── lib/{errors,truncate,validation,logger}.ts
├── scripts/build-index.ts         # builds SQLite FTS5 index from cometchat/docs
├── bundles/                       # 10 curated implementation bundles
├── skills/overview.md             # agent orientation skill
├── tests/                         # vitest suite
├── .claude-plugin/
│   ├── plugin.json                # Claude Code plugin manifest
│   └── marketplace.json           # Claude Code marketplace manifest
├── .codex-plugin/plugin.json      # Codex plugin manifest
├── .cursor-plugin/plugin.json     # Cursor Marketplace manifest
├── .mcp.json                      # MCP config (Claude Code auto-discovery)
├── mcp.json                       # Open Plugins standard manifest
└── assets/logo.svg                # CometChat logo

---

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

Переменная окружения	Значение по умолчанию	Примечания
PORT	3000	HTTP-порт
HOST	0.0.0.0	Привязанный хост
DOCS_BASE_URL	https://www.cometchat.com/docs	Используется в ответах и для fallback загрузки .md
INDEX_PATH	./data/index.sqlite	Путь к SQLite FTS5 индексу. Сервер продолжит работу, если индекс отсутствует; поиск вернет backend_unavailable, а /health будет 503.
BUNDLES_DIR	./bundles	Каталог Markdown-бандлов
SKILLS_DIR	./skills	Каталог ориентационного навыка (overview.md)
FETCH_TIMEOUT_MS	5000	Тайм-аут HTTP на запрос
LOG_LEVEL	info	debug / info / warn / error
NODE_ENV	development	production сделает загрузку bundle строже — повреждённый bundle прерывает запуск, вместо пропуска
ALLOWED_HOSTS	:,localhost:,127.0.0.1:	Разрешённый список Host для защиты от DNS-rebinding
ALLOWED_ORIGINS	unset	Разрешённый список Origin для CORS (CSV)
DNS_REBINDING_PROTECTION	true	Установите в false только если upstream уже валидирует Host
RATE_LIMIT_ENABLED	true	Отключить ограничение по IP на /mcp можно, установив false
RATE_LIMIT_MAX	120	Максимум запросов за окно на IP
RATE_LIMIT_WINDOW_MS	60000	Окно ограничения, мс

---

Развертывание

См. DEPLOY.md в репозитории для сборки контейнера, окружения и заметок по платформе.

---

Маркетплейсы

Один и тот же URL сервера приводится в нескольких маркетплейсах агентов:

Marketplace	Listing
Smithery	smithery.ai/servers/cometchat/docs-mcp
Glama	glama.ai/mcp/servers/cometchat/docs-mcp
Cursor Marketplace	cursor.com/marketplace
Cursor Directory	cursor.directory
Anthropic Connector Directory	claude.com/connectors
Codex Marketplace	codex-marketplace.com

---

Поддержка

• Проблемы / отзывы: создайте issue в этом репозитории.

• Поддержка CometChat: support@cometchat.com.

• Статус MCP: curl https://mcp.cometchat.com/health возвращает {"status":"ok"} когда всё в порядке.

---

Вклад

PR-ы приветствуются — особенно:

• Новые bundles реализации для малообслуживаемых сценариев (поместите markdown-файл в bundles/ с требуемыми frontmatter).

• Обновления bundle при смене версий SDK (дата last_verified во frontmatter bundle вызывает CI-оповещение, если старше 6 месяцев).

• Улучшения инструментов за пределами существующего read-only контракта.

Сегодня вне рамок:

• Инструменты, которые записывают в приложение клиента CometChat (отдельное аутентифицированное соединение — на дорожной карте).

• Инструменты с смешанным доступом на запись/чтение (правило автодекларации Anthropic).

---

Конфиденциальность

Сервер CometChat MCP — только для чтения и не требует аккаунта, API-ключа или аутентификации. Он обслуживает только общедоступную документацию CometChat и не запрашивает, не хранит и не передает ваш код, подсказки или персональные данные. Стандартные метаданные запросов (например, IP-адрес) могут временно обрабатываться для ограничения скорости и предотвращения злоупотреблений.

Подробности см. в политике конфиденциальности CometChat: cometchat.com/legal-privacy-policy.

---

Лицензия

Apache-2.0. См. LICENSE.