JointJS MCP Server

Versión: 4.3

El JointJS MCP Server le da a tu asistente de codificación con IA acceso directo a la documentación actualizada de JointJS, referencias de API y código de demostración funcional. En lugar de depender de los datos de entrenamiento de la IA — que tienen una fecha de corte y pueden reflejar APIs obsoletas — el servidor consulta un índice de búsqueda híbrido actualizado continuamente (semántico + por palabras clave) construido a partir de la documentación oficial de JointJS y los repositorios de demostración, optimizado para una recuperación precisa y amigable con LLM.

¿Por qué usarlo?

• Siempre actualizado. La documentación se mantiene al día en un índice dedicado, por lo que obtienes los últimos cambios de API, avisos de obsolescencia y guías de migración — no una instantánea congelada de la ventana de entrenamiento del modelo.
• Con versiones. Cada consulta puede limitarse a una versión específica de JointJS, para que el asistente dé respuestas que coincidan con la versión que realmente estás usando.
• Reduce las alucinaciones. El asistente fundamenta sus respuestas en el texto fuente recuperado en lugar de recordar datos de entrenamiento potencialmente incorrectos sobre los internals de JointJS.
• Flujo de trabajo centrado en demos. Proyectos de demostración completos y ejecutables están indexados y son recuperables por framework (TypeScript, JavaScript, React, Angular), para que puedas pegar código funcional directamente en tu proyecto.
• Sin costo de configuración. El servidor está alojado en https://mcp.jointjs.com/mcp — no hay nada que instalar o mantener de tu lado.

Instalación

El endpoint del servidor MCP de JointJS es:

https://mcp.jointjs.com/mcp

• Claude Desktop
• Claude Code (CLI)
• Cursor
• VS Code (Copilot)
• OpenAI Codex / ChatGPT
• Otros clientes

1. Abre Configuración → Conectores.
2. Haz clic en Añadir conector personalizado.
3. Introduce https://mcp.jointjs.com/mcp.
4. Guarda/habilítalo.

---

Herramientas

El servidor expone las herramientas que se enumeran a continuación. El asistente de IA las invoca automáticamente cuando determina que son relevantes, pero también puedes solicitarlas explícitamente (por ejemplo, "busca en la documentación de JointJS...").

search_docs

Busca en la documentación de JointJS, la referencia de API, las guías y las notas de migración usando una consulta en lenguaje natural.

Parámetro	Tipo	Obligatorio	Descripción
query	string	Sí	Consulta de búsqueda en lenguaje natural, p. ej. "how to add a custom shape"
version	string	No	Versión de JointJS para acotar la búsqueda, p. ej. "4.0". Si se omite, se busca la versión más reciente disponible.

Cuándo usarla: preguntas conceptuales, semántica de opciones de API, orientación sobre compatibilidad, notas de migración o cualquier pregunta cuya respuesta se encuentre mejor en documentación en prosa.

get_doc

Recupera el contenido completo en Markdown de una página de documentación específica mediante su ruta.

Parámetro	Tipo	Obligatorio	Descripción
path	string	Sí	Ruta interna de la página de documentación, p. ej. "versioned_docs/version-4.0/intro/index.md". Normalmente obtienes este valor de los resultados de search_docs.

Cuándo usarla: cuando search_docs devuelve un nombre de archivo que quieres leer completo, o cuando conoces la ruta exacta de una página de documentación.

search_demos

Busca proyectos de demostración de JointJS y código de ejemplo usando una consulta en lenguaje natural. Devuelve una lista clasificada de demos con valores de demo_id que puedes pasar a get_demo_code. El asistente de IA selecciona y llama automáticamente a estas herramientas cuando es relevante. Opcionalmente puedes guiarlo con indicaciones como: "Busca demos de JointJS para...".

Parámetro	Tipo	Obligatorio	Descripción
query	string	Sí	Consulta de búsqueda en lenguaje natural, p. ej. "drag and drop between containers"
version	string	No	Versión de JointJS para acotar la búsqueda, p. ej. "4.2". Si se omite, se busca la versión más reciente.
framework	string	No	Filtrar por framework: "ts" (TypeScript - vanilla), "js" (JavaScript - vanilla), "react" o "angular".

Cuándo usarla: cuando quieres un ejemplo completo y ejecutable o necesitas ver cómo se implementa una funcionalidad de principio a fin.

get_demo_code

Recupera todos los archivos fuente de una demo de JointJS. Los archivos de texto (.ts, .tsx, .js, .jsx, .json, .md, .css, .html) se devuelven en línea; los recursos binarios (fuentes, imágenes) se devuelven como enlaces de GitHub.

[!NOTA]

Las demos muy grandes pueden truncarse según los límites de contexto del cliente.

Parámetro	Tipo	Obligatorio	Descripción
demo_id	string	Sí	Identificador de la demo devuelto por search_demos, p. ej. "version-4.2/ai-agent-builder/js"

Cuándo usarla: después de que search_demos identifique una demo relevante, llama a esta herramienta para obtener su código fuente completo y que el asistente pueda adaptarlo a tu proyecto.

list_doc_versions

Enumera todas las versiones de documentación de JointJS disponibles en el servidor.

Parámetro	Tipo	Obligatorio	Descripción
(ninguno)	—	—	Esta herramienta no acepta parámetros.

Cuándo usarla: para descubrir qué cadenas de versión son válidas para el parámetro version de search_docs o search_demos.

Buenas prácticas

• Haz preguntas específicas y centradas en la implementación

  "¿Cómo añado un minimapa plegable en mi diagrama de JointJS?"

• Especifica tu versión de JointJS cuando sea relevante

  "en JointJS 4.2"

• Pide demos al crear funcionalidades

  "Encuentra una demo que muestre..."

• Combina documentación + demos

  "Explica cómo funciona la validación de enlaces y muestra una demo"

---

Resumen

Beneficio	Detalle
Sin fecha de corte de conocimiento	La documentación se sirve en vivo desde la documentación oficial de JointJS, por lo que los cambios de API publicados después de la fecha de entrenamiento del modelo siempre están disponibles.
Respuestas precisas según la versión	Acota cualquier búsqueda a la versión exacta de JointJS que estás usando — no más respuestas que mezclan silenciosamente APIs de distintas versiones.
Código de demo funcional	Proyectos de demostración completos indexados por framework te permiten copiar y pegar código real y probado en lugar de depender de ejemplos sintéticos.
Respuestas fundamentadas	El asistente cita el texto de documentación recuperado, lo que facilita verificar las respuestas y detectar errores.
Cero mantenimiento	El servidor está alojado y actualizado por el equipo de JointJS — te conectas una vez y siempre obtienes contenido fresco.
Amplio soporte de clientes	Funciona con Claude, Cursor, VS Code Copilot, OpenAI Codex y cualquier otro cliente compatible con MCP mediante un único endpoint HTTPS.