CometChat MCP

---

Servidor MCP de primera parte de CometChat. Conecta Claude, Cursor, Windsurf, VS Code Copilot, Codex o cualquier otro agente compatible con el Model Context Protocol e integra CometChat en tu aplicación a partir de indicaciones en lenguaje natural.

Pídele al agente: "añade una pestaña de chat donde los usuarios puedan enviarse mensajes directos" — lee la documentación de CometChat, elige los componentes adecuados para tu stack y escribe el código de integración.

Solo lectura. No requiere cuenta, clave API ni autenticación.

---

Demo

Un agente de IA leyendo la documentación de CometChat y escribiendo una integración de chat funcional a partir de una sola indicación.

---

Instalación rápida

Agente	Cómo añadirlo
Claude.ai / Claude Desktop	Configuración → Conectores → Añadir conector personalizado → URL: https://mcp.cometchat.com/mcp
Cursor	Cmd+Shift+P → Abrir configuración de MCP → Añadir MCP personalizado → pegar la configuración de abajo
Windsurf	Plugins (icono de martillo) → Gestionar plugins → Ver configuración sin procesar → pegar la configuración de abajo
VS Code (Copilot Agent)	Cmd+Shift+P → MCP: Añadir servidor MCP → URL: https://mcp.cometchat.com/mcp, Transporte: 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

Fragmento de configuración (Cursor / Windsurf / clientes MCP genéricos)

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

---

Uso

Después de conectarte, indícale a tu agente cualquiera de estas opciones:

• "¿Cómo instalo el React UI Kit en mi proyecto Vite?"
• "Guíame por el chat multiinquilino para un SaaS de Next.js donde los espacios de trabajo estén aislados."
• "Muéstrame cómo añadir indicadores de presencia y puntos de escritura a mi lista de conversaciones de iOS."
• "Configura la moderación de contenido para que las palabras prohibidas se bloqueen antes de la entrega."
• "Crea un widget de chat sin código para mi sitio de Webflow."
• "¿Cuál es el límite de velocidad para enviar mensajes y qué código de error recibo cuando lo alcanzo?"

El agente lee la documentación de CometChat, extrae el paquete de implementación relevante y escribe el código de integración en tu proyecto.

---

Herramientas

• search_cometchat_docs — Busca en guías de SDK, referencias de UI Kit, documentación de la API REST y especificaciones OpenAPI. Devuelve fragmentos clasificados con títulos y enlaces directos. Filtro opcional version.
• fetch_cometchat_doc_page — Obtiene el contenido completo de cualquier página de documentación como markdown por URL o ruta relativa.
• get_cometchat_implementation_bundle — Devuelve un paquete de implementación seleccionado para un escenario con nombre: requisitos previos, comandos de instalación, configuración, código funcional.
• list_cometchat_bundles — Lista todos los paquetes de implementación disponibles (identificador, título, framework, fecha de última verificación) para su descubrimiento.

Las cuatro llevan readOnlyHint: true, una anotación title y un outputSchema declarado con resultados estructurados. Los nombres tienen ≤ 64 caracteres. Las descripciones describen solo contratos: sin instrucciones de comportamiento para el agente, sin enrutamiento entre herramientas, sin lenguaje de marketing.

Recursos

URI	Propósito
cometchat://skills/overview	Habilidad de orientación del agente: resumen del producto, guía de decisiones, flujo de trabajo, errores comunes, lista de verificación
cometchat://bundles/react-uikit-quickstart	React UI Kit: instalación + inicio + inicio de sesión + superficie de chat
cometchat://bundles/react-native-uikit-quickstart	React Native UI Kit con navegación y pantalla de chat
cometchat://bundles/flutter-uikit-quickstart	Flutter UI Kit: instalación + inicio + chat básico
cometchat://bundles/ios-uikit-quickstart	iOS UI Kit (SwiftUI): instalación + vista de chat
cometchat://bundles/android-uikit-quickstart	Android UI Kit (Jetpack Compose): instalación + pantalla de chat
cometchat://bundles/js-sdk-messaging-basics	SDK de JavaScript puro: enviar/recibir mensajes de texto y multimedia
cometchat://bundles/widget-embed	Widget sin código para HTML, Squarespace, Webflow, Wix, WordPress, Shopify
cometchat://bundles/moderation-setup	Reglas de moderación con IA, moderación de imágenes, webhooks
cometchat://bundles/multi-tenant-chat	Chat SaaS multiinquilino: aislamiento de inquilinos, tokens de autenticación emitidos por el servidor
cometchat://bundles/presence-and-typing	Presencia en línea, indicadores de escritura, confirmaciones de lectura

---

Cómo funciona

1. Le indicas a tu agente en lenguaje natural.
2. El agente lee la habilidad de orientación (cometchat://skills/overview) para entender qué herramienta/paquete se ajusta a tu solicitud.
3. Para los escenarios principales, el agente extrae un paquete de implementación seleccionado: código listo para ejecutar con requisitos previos, comandos de instalación, configuración y ejemplos funcionales.
4. Para preguntas de nicho, el agente busca en la documentación de CometChat y lee páginas de referencia específicas.
5. El agente escribe el código en tu proyecto, usando el paquete como fuente de verdad y la estructura de tu proyecto como restricción.

---

CometChat en 30 segundos

CometChat es una plataforma de comunicaciones en tiempo real para añadir chat, voz y videollamadas a aplicaciones web y móviles. Se usa en producción en SaaS, marketplaces, juegos, salud, educación y plataformas de creadores.

• Nivel gratuito: los primeros 100 usuarios activos mensuales, sin tarjeta de crédito.
• SDKs: JavaScript, React Native, iOS, Android, Flutter.
• UI Kits: React, React Native, iOS, Android, Flutter, Angular, Vue.
• Sin código: widget de chat para cualquier sitio HTML.
• Regístrate: app.cometchat.com — necesitarás un ID de aplicación, clave de autenticación y región para compilar con el código que escribe el agente.

---

Identidad del servidor

Campo	Valor
Nombre para mostrar	Documentación de CometChat
Versión	0.1.6
Protocolo	MCP 2025-06-18
Transporte	HTTP transmisible (con SSE)
Autenticación	Ninguna (solo documentación pública)
Capacidades	tools, resources
Endpoint de salud	GET https://mcp.cometchat.com/health

---

Arquitectura

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

• Servidor sin estado, un único endpoint universal, sin estado específico de usuario.
• El índice de búsqueda se reconstruye desde github.com/cometchat/docs en cada push a la rama main de ese repositorio.
• Los paquetes de implementación llevan una fecha last_verified y se revisan trimestralmente contra las versiones de SDK en vivo.

---

Desarrollo local

# 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

El servidor escucha en http://0.0.0.0:3000 por defecto. Sonda de salud en GET /health, endpoint MCP en POST /mcp.

Inspeccionar con el MCP Inspector

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

Deberías ver las 4 herramientas con readOnlyHint: true y los 11 recursos.

Estructura del repositorio

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

---

Configuración

Variable de entorno	Valor predeterminado	Notas
PORT	3000	Puerto HTTP
HOST	0.0.0.0	Host de enlace
DOCS_BASE_URL	https://www.cometchat.com/docs	Se usa para URLs en respuestas + el respaldo de recuperación .md
INDEX_PATH	./data/index.sqlite	Ubicación del índice SQLite FTS5. El servidor aún arranca si falta; la búsqueda devuelve backend_unavailable y /health es 503.
BUNDLES_DIR	./bundles	Directorio de paquetes de markdown
SKILLS_DIR	./skills	Directorio de la habilidad de orientación (overview.md)
FETCH_TIMEOUT_MS	5000	Tiempo de espera HTTP por recuperación
LOG_LEVEL	info	debug / info / warn / error
NODE_ENV	development	production hace que la carga de paquetes sea estricta: un paquete mal formado aborta el arranque en lugar de omitirse
ALLOWED_HOSTS	<HOST>:<PORT>,localhost:<PORT>,127.0.0.1:<PORT>	Lista de permitidos de encabezados Host separados por comas para protección contra reenlace de DNS
ALLOWED_ORIGINS	sin definir	Lista de permitidos de Origin del navegador separados por comas para /mcp. Sin definir no permite ninguno: una solicitud con un Origin recibe 403. Los clientes que no envían Origin (IDEs, CLIs, conectores alojados) no se ven afectados
DNS_REBINDING_PROTECTION	true	Establece false solo si un upstream ya valida Host
RATE_LIMIT_ENABLED	true	Establece false para deshabilitar la limitación de velocidad por IP en /mcp. Exactamente true o false; otros valores fallan al arrancar
RATE_LIMIT_MAX	120	Máximo de solicitudes por ventana por IP. Entero positivo; 0 falla al arrancar (deshabilitar con RATE_LIMIT_ENABLED=false)
RATE_LIMIT_WINDOW_MS	60000	Ventana de limitación de velocidad en ms. Entero positivo
INDEX_AUTO_REFRESH	false	Establece true para reconstruir el índice de búsqueda en el contenedor cuando cometchat/docs cambia. Requiere git en la imagen y un INDEX_WORK_DIR escribible.
INDEX_POLL_INTERVAL_MS	600000	Con qué frecuencia verificar el repositorio de documentación para un nuevo commit (un git ls-remote, ~1s)
INDEX_WORK_DIR	./data/generations	Dónde se escriben las generaciones de índice reconstruidas (tmpfs en producción)
INDEX_KEEP_GENERATIONS	2	Generaciones de índice anteriores retenidas en disco para respaldo instantáneo
INDEX_MIN_PAGES	2000	Mínimo absoluto: un índice candidato con menos páginas se rechaza
INDEX_MAX_DROP_RATIO	0.2	Mínimo relativo: rechazar un candidato que pierda más de esta fracción del recuento de páginas servidas, o de las páginas servidas cuyas versiones provienen de la navegación de docs.json
DOCS_REPO_URL	https://github.com/cometchat/docs.git	Repositorio de documentación pública; clonado anónimamente, sin credenciales
DOCS_REF	main	Rama a seguir
DOCS_COMMIT_PIN	sin definir	Congelar en un commit y dejar de seguir HEAD (válvula de escape para incidentes)
POSTHOG_KEY	sin definir	Clave API del proyecto PostHog. Sin definir = análisis de uso completamente deshabilitado (sin operación)
POSTHOG_HOST	https://us.i.posthog.com	Host de la instancia de PostHog
ANALYTICS_SALT	sin definir	Requerido cuando POSTHOG_KEY está definido (la analítica permanece desactivada sin él). Saltea las huellas digitales/hashes de IP del cliente; rotarlo restablece todas las huellas digitales

---

Implementación

Consulta DEPLOY.md para la compilación del contenedor, el entorno y las notas de la plataforma.

---

Marketplaces

La misma URL del servidor aparece en varios marketplaces de agentes:

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

---

Soporte

• Problemas / comentarios: abre un issue en este repositorio.
• Soporte de CometChat: support@cometchat.com.
• Estado de MCP en vivo: curl https://mcp.cometchat.com/health devuelve {"status":"ok"} cuando está saludable.

---

Contribuciones

Se aceptan PRs, especialmente:

• Nuevos paquetes de implementación para escenarios poco cubiertos (coloca un archivo markdown en bundles/ con el frontmatter requerido).
• Actualizaciones de paquetes cuando cambian las versiones de SDK (la fecha last_verified en el frontmatter del paquete activa una advertencia de CI si tiene más de 6 meses).
• Mejoras de herramientas detrás del contrato de solo lectura existente.

Fuera de alcance hoy:

• Herramientas que escriben en la aplicación CometChat de un cliente (conector autenticado separado, en la hoja de ruta).
• Herramientas mixtas de lectura/escritura (regla de rechazo automático de Anthropic).

---

Privacidad

El servidor MCP de CometChat es de solo lectura y no requiere cuenta, clave API ni autenticación. Solo sirve la documentación pública de CometChat y no solicita, almacena ni transmite tu código, indicaciones o datos personales. Los metadatos estándar de solicitud (como la dirección IP) pueden procesarse de forma transitoria para la limitación de velocidad y la prevención de abusos.

Para más detalles, consulta la política de privacidad de CometChat: cometchat.com/legal-privacy-policy.

---

Licencia

Apache-2.0. Consulta LICENSE.