JointJS MCP Server

Version: 4.3

O JointJS MCP Server dá ao seu assistente de codificação com IA acesso direto à documentação atualizada do JointJS, referências de API e código de demonstração funcional. Em vez de depender dos dados de treinamento da IA — que têm um corte de conhecimento e podem refletir APIs desatualizadas — o servidor consulta um índice de busca híbrido continuamente atualizado (semântico + por palavras-chave) construído a partir da documentação oficial do JointJS e dos repositórios de demonstração, otimizado para recuperação precisa e amigável a LLMs.

Por que usar?

• Sempre atualizado. A documentação é mantida atualizada em um índice dedicado, para que você obtenha as últimas mudanças de API, avisos de depreciação e guias de migração — não um instantâneo congelado da janela de treinamento do modelo.
• Com versão. Cada consulta pode ser limitada a uma versão específica do JointJS, para que o assistente forneça respostas que correspondam à versão que você está realmente usando.
• Reduz alucinações. O assistente fundamenta suas respostas no texto-fonte recuperado, em vez de recordar dados de treinamento potencialmente incorretos sobre os internos do JointJS.
• Fluxo de trabalho com foco em demonstrações. Projetos de demonstração completos e executáveis são indexados e recuperáveis por framework (TypeScript, JavaScript, React, Angular), para que você possa colar código funcional diretamente no seu projeto.
• Sem custo de configuração. O servidor está hospedado em https://mcp.jointjs.com/mcp — não há nada para instalar ou manter do seu lado.

Instalação

O endpoint do servidor MCP do JointJS é:

https://mcp.jointjs.com/mcp

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

1. Abra Configurações → Conectores.
2. Clique em Adicionar conector personalizado.
3. Insira https://mcp.jointjs.com/mcp.
4. Salve/ative.

---

Ferramentas

O servidor expõe as ferramentas listadas abaixo. O assistente de IA as invoca automaticamente quando determina que são relevantes, mas você também pode solicitá-las explicitamente (por exemplo, "pesquise na documentação do JointJS por...").

search_docs

Pesquise a documentação do JointJS, referência de API, guias e notas de migração usando uma consulta em linguagem natural.

Parâmetro	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de pesquisa em linguagem natural, ex.: "how to add a custom shape"
version	string	Não	Versão do JointJS para limitar a pesquisa, ex.: "4.0". Omita para pesquisar a versão mais recente disponível.

Quando usar: perguntas conceituais, semântica de opções de API, orientação de compatibilidade, notas de migração ou qualquer pergunta cuja resposta seja melhor encontrada em documentação em prosa.

get_doc

Recupere o conteúdo Markdown completo de uma página específica da documentação pelo seu caminho.

Parâmetro	Tipo	Obrigatório	Descrição
path	string	Sim	Caminho interno da página de documentação, ex.: "versioned_docs/version-4.0/intro/index.md". Normalmente você obtém esse valor dos resultados de search_docs.

Quando usar: quando search_docs retorna um nome de arquivo que você deseja ler por completo, ou quando você sabe o caminho exato de uma página de documentação.

search_demos

Pesquise projetos de demonstração do JointJS e código de exemplo usando uma consulta em linguagem natural. Retorna uma lista classificada de demonstrações com valores de demo_id que você pode passar para get_demo_code. O assistente de IA seleciona e chama automaticamente essas ferramentas quando relevante. Você pode opcionalmente orientá-lo com prompts como: "Pesquise demonstrações do JointJS por...".

Parâmetro	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de pesquisa em linguagem natural, ex.: "drag and drop between containers"
version	string	Não	Versão do JointJS para limitar a pesquisa, ex.: "4.2". Omita para pesquisar a versão mais recente.
framework	string	Não	Filtrar por framework: "ts" (TypeScript - vanilla), "js" (JavaScript - vanilla), "react" ou "angular".

Quando usar: quando você quer um exemplo completo e executável ou precisa ver como um recurso é implementado de ponta a ponta.

get_demo_code

Recupere todos os arquivos-fonte de uma demonstração do JointJS. Arquivos de texto (.ts, .tsx, .js, .jsx, .json, .md, .css, .html) são retornados inline; ativos binários (fontes, imagens) são retornados como links do GitHub.

[!-secondary] -secondary nota

Demonstrações muito grandes podem ser truncadas dependendo dos limites de contexto do cliente.

Parâmetro	Tipo	Obrigatório	Descrição
demo_id	string	Sim	Identificador da demonstração retornado por search_demos, ex.: "version-4.2/ai-agent-builder/js"

Quando usar: depois que search_demos identifica uma demonstração relevante, chame esta ferramenta para buscar seu código-fonte completo, para que o assistente possa adaptá-lo ao seu projeto.

list_doc_versions

Liste todas as versões da documentação do JointJS disponíveis no servidor.

Parâmetro	Tipo	Obrigatório	Descrição
(nenhum)	—	—	Esta ferramenta não recebe parâmetros.

Quando usar: para descobrir quais strings de versão são válidas para o parâmetro version de search_docs ou search_demos.

Boas práticas

• Faça perguntas específicas e focadas na implementação

  "Como adiciono um minimapa recolhível no meu diagrama JointJS?"

• Especifique sua versão do JointJS quando relevante

  "no JointJS 4.2"

• Peça demonstrações ao criar recursos

  "Encontre uma demonstração mostrando..."

• Combine documentação + demonstrações

  "Explique como funciona a validação de links e mostre uma demonstração"

---

Resumo

Benefício	Detalhe
Sem corte de conhecimento	A documentação é servida ao vivo a partir da documentação oficial do JointJS, então mudanças de API lançadas após a data de treinamento do modelo estão sempre disponíveis.
Respostas precisas por versão	Limite qualquer pesquisa à versão exata do JointJS que você está usando — chega de respostas que misturam silenciosamente APIs de diferentes versões.
Código de demonstração funcional	Projetos de demonstração completos indexados por framework permitem copiar e colar código real e testado, em vez de depender de exemplos sintéticos.
Respostas fundamentadas	O assistente cita o texto da documentação recuperado, facilitando a verificação das respostas e a identificação de erros.
Zero manutenção	O servidor é hospedado e atualizado pela equipe do JointJS — você conecta uma vez e sempre recebe conteúdo atualizado.
Amplo suporte a clientes	Funciona com Claude, Cursor, VS Code Copilot, OpenAI Codex e qualquer outro cliente compatível com MCP por meio de um único endpoint HTTPS.