Servidor MCP

O DimensionKit disponibiliza um servidor MCP remoto para que um assistente de IA possa construir, editar, publicar e analisar suas scorecards por você.

https://app.dimensionkit.com/mcp

Cole essa URL em qualquer cliente compatível com MCP remoto. Consulte Conectar um cliente para instruções de configuração e Gerenciar conexões para verificar acessos ativos ou revogá-los.

Capacidades disponíveis

• Criar scorecards, adicionar dimensões e perguntas, definir faixas de níveis e publicar
• Modificar ou remover itens de scorecards já publicadas
• Consultar envios, com detalhes de pontuação por dimensão e respostas escolhidas
• Avaliar se uma scorecard está pronta para publicação e quais aspectos precisam de melhoria
• Gerar links de pré-visualização para rascunhos antes da publicação

Etapas de criação de uma scorecard

As ferramentas são ordenadas conforme o fluxo natural de elaboração:

1. scorecard_design_guide — Diretrizes de estilo, a serem consultadas antes de redigir
2. create_scorecard — Criação do rascunho com configurações visuais e de marca
3. add_dimension — Definição das áreas de avaliação
4. add_questions — Inclusão de todas as perguntas de uma dimensão em uma só requisição
5. set_dimension_tiers — Definição dos níveis de resultado e seus diagnósticos
6. check_scorecard — Validação de requisitos e identificação de pontos fracos
7. publish_scorecard — Disponibilização pública da avaliação

Rascunhos não ficam acessíveis ao público. Os retornos das ferramentas informam a URL futura marcada com urlIsLive: false, sinalizando ao assistente que ela ainda não deve ser divulgada.

Boas práticas além de meros esquemas

O comando scorecard_design_guide detalha as diretrizes qualitativas que um esquema técnico não transmite: quais perguntas preliminares fazer a você, como formular perguntas sem respostas óbvias, como escrever diagnósticos relevantes e qual tema visual escolher — veja também Temas e identidade visual. O assistente sempre indagará suas preferências antes de formular o conteúdo.

Clientes com suporte a prompts MCP também contam com três comandos: build_scorecard, review_scorecard e choose_theme.

Visualização prévia antes de publicar

Qualquer retorno de ferramenta sobre um rascunho inclui uma previewUrl: um link assinado, válido por 24 horas, que reproduz a scorecard fielmente como o público a verá. Ele exibe um aviso de rascunho e envios realizados nele não são computados no banco de dados.

Duas regras obrigatórias do sistema

As faixas de pontuação são derivadas, nunca manuais. A pontuação de uma dimensão varia entre a soma dos valores mínimos e a soma dos valores máximos das respostas, e os níveis cobrem essa amplitude continuamente. Ao alterar perguntas, os limites são recalculados automaticamente pelo sistema.

Identificadores de perguntas e chaves de dimensões são definitivos. Respostas e notas são vinculadas a esses identificadores. Para proteger o histórico já cadastrado, update_question e update_dimension alteram todos os atributos exceto essas chaves.

Alterando avaliações ativas

O processo é seguro. Cada envio armazena suas próprias notas, o nível atingido e o texto exato apresentado no momento da resposta, acompanhados de um código identificador da versão. Atualizações posteriores não afetam históricos já concluídos.

O que deliberadamente não é suportado

• Sem perguntas interativas diretas via protocolo MCP. Protocolos de amostragem interativa exigem conexões bidirecionais permanentes que este servidor não mantém. Qualquer detalhamento ocorre diretamente na sua conversa com o assistente.
• Sem streaming. O serviço atende a requisições pontuais e não mantém conexões SSE ativas.
• Sem acesso a faturamento ou dados de pagamento. As permissões limitam-se estritamente às scorecards e seus envios.
• Sem API REST aberta para escrita. A interface REST permanece em modo somente-leitura; gravações são feitas por MCP ou pelo painel web.