YZIDRO KNOWLEDGE / API & MCP

O conhecimento
da Domtec, conectado.

Conheça a plataforma que transforma evidências em conhecimento institucional e ajuda seu assistente de IA a investigar bugs, planejar PJs e avaliar o impacto de cada mudança.

CONHECIMENTO OFICIAL / APOIO À DECISÃO / ACESSO CONTROLADO

Mascote robô da Domtec acenando

01 / SOBRE

Mais contexto para
boas respostas.

O Yzidro Knowledge organiza conhecimento institucional e o disponibiliza para consultas por API e por MCP.

MCP significa Model Context Protocol: um protocolo que permite a um assistente compatível consultar ferramentas externas. Aqui, ele conecta o assistente ao conhecimento oficial publicado, suas relações e, quando permitido, às evidências de origem, ao código, ao histórico e aos projetos em andamento.

Entenda o fluxo

APOIO À DECISÃO

As perguntas de quem desenvolve.

Três ferramentas reúnem as fontes em uma resposta com fatos, riscos e lacunas, para você decidir com as evidências à vista.

analyze_change_impact

“Se eu mexer aqui, o que quebra?”

O QUE COMBINA

Chamadores, telas, parâmetros, regras, invariantes e PJs anteriores.

diagnose_issue

“Onde está a provável causa?”

O QUE COMBINA

Sintoma, tela candidata, mudanças recentes, hotfixes e bugs parecidos.

plan_project

“O que falta decidir antes de implementar?”

O QUE COMBINA

Requisitos × regras e código, precedentes, riscos e perguntas abertas.

O resultado orienta a análise, não substitui a leitura das fontes. Veja como pedir

02 / O PROCESSO KNOWLEDGE

Das fontes à base oficial.

Explore cada etapa e descubra como as fontes se transformam em conhecimento consultável.

01

Projeto e coleta

ERP Projeto e requisitosWiki Documentação e versõesGit / Bitbucket Histórico e códigoColeta Evidências do PJ

A partir do código do PJ, a coleta reúne informações disponíveis no ERP, Wiki e histórico de Git/Bitbucket, conforme os conectores configurados. O título e os detalhes do projeto podem ser preenchidos pelos dados encontrados no ERP.

O resultado preserva as fontes e os avisos de cobertura. Uma coleta parcial continua identificada como parcial; coletar, por si só, não cria conhecimento oficial.

02

Normalização e índices

As evidências capturadas são preparadas para leitura: o conteúdo é normalizado e recebe índices que apontam para a origem, a coleta e os registros originais. Os arquivos e hashes preservam a rastreabilidade.

Um índice de arquivos ajuda a localizar código para consulta posterior. A referência a um arquivo não comprova, sozinha, seu comportamento.

03

Pré-análise com IA

O sistema seleciona trechos das evidências e prepara uma memória inicial do projeto, com resumo, observações fundamentadas, fontes e limitações. Quando documentadas, versões de saída e eventos da evolução também são registrados.

A seleção tem limites e pode omitir fontes. A memória não transforma cada observação em regra institucional; evidências insuficientes produzem um rascunho para revisão.

04

Domínios, subdomínios e tags

A pré-análise pode sugerir classificações com base nas evidências, citando fonte e trecho. O catálogo ajuda a reutilizar nomes; projetos e entidades podem ter várias classificações.

As sugestões passam por decisão autorizada. Apenas tags aprovadas são usadas nos filtros; tags em comum não criam relações entre entidades. O acervo publicado também pode ser classificado por uma execução específica e revisada.

05

Revisão e publicação

Memórias com confiança média ou alta podem ser revisadas, aprovadas e publicadas automaticamente após validações, desde que o solicitante mantenha as permissões e escopos necessários. Bloqueios impedem a publicação automática.

Confiança baixa ou desconhecida exige revisão manual. Nesse fluxo, a aprovação e a publicação são etapas separadas, com histórico e verificação da prévia.

06

Consulta e aprofundamento

Após a publicação, a base oficial pode ser consultada pela API e por clientes MCP autorizados. A busca encontra entidades; a leitura de conteúdo, origens e relações ajuda a entender o contexto e a evolução documentada.

Com acesso completo, é possível navegar até fontes da coleta, inclusive as omitidas da pré-análise, consultar a Wiki atual identificada e ler código e histórico do repositório. Também é possível ver requisitos e análise de um PJ ainda não publicado, como dados provisórios. Captura, dado provisório, fonte atual e conhecimento aprovado têm significados diferentes.

Rastreabilidade em cada etapa

A busca e a análise são limitadas: ausência de um resultado não prova que a informação não existe. As consultas MCP não iniciam coleta, análise ou publicação oficial. A única gravação é a v0 candidata, feita a pedido e com permissão específica, que não se torna conhecimento oficial.

VERSÕES E EVOLUÇÃO

O histórico também
faz parte da resposta.

O Knowledge preserva a evolução documentada de um recurso para ajudar a entender o que mudou e em qual contexto.

EXEMPLO DE EVOLUÇÃO DOCUMENTADA
10Criação
20Alteração
56Reescrita

Para o mesmo recurso comprovado, a versão 56 é apresentada primeiro, junto à evolução anterior e aos complementos relevantes.

Versão do ERP e revisão interna

A versão de saída documentada identifica o contexto do ERP. Já version é a revisão interna da entidade no Knowledge; são informações diferentes.

O que vem primeiro

Na busca MCP, itens que cobrem mais termos da pergunta vêm primeiro. Em caso de empate, a versão de saída numérica documentada desempata, da maior para a menor. Versões ausentes, divergentes ou não comparáveis aparecem depois.

Como interpretar mudanças

Ao comparar o mesmo recurso, consulte conteúdo, origens e relações. Cite a versão e o PJ de cada evento quando disponíveis. Uma versão posterior não invalida automaticamente todos os detalhes anteriores, e semelhança de texto não comprova que dois registros sejam o mesmo recurso. O histórico de cada entidade mostra o que mudou entre as revisões.

Limites e evidências

Versões ausentes, conflitantes ou não comparáveis e cobertura parcial devem ser informadas. Uma correção precisa estar documentada: não se presume que ela alcança versões intermediárias ou anteriores. A busca é limitada e não garante encontrar todo o histórico.

03 / POSSIBILIDADES

Conhecimento em movimento.

Da descoberta à decisão, respeitando as permissões da sua conta.

⌕01

Descubra

Pergunte em linguagem natural e filtre por regras, decisões ou invariantes, com os resultados mais próximos primeiro.

search_business_knowledge
⌘02

Conecte

Explore entidades, processos e relações registradas ou monte um pacote de contexto para uma tarefa.

build_context_pack
≋03

Rastreie

Veja quem alterou um arquivo, os PJs citados e o diff de cada PR, além das fontes de cada coleta.

get_file_history

Fontes, pistas e dados provisórios apoiam a decisão; não são, por si só, conhecimento institucional aprovado. Como ler as respostas

PADRÕES DO DESENVOLVIMENTO

Do manual do time
direto para o editor.

O assistente consulta os manuais da Wiki enquanto você implementa e cita a página de cada padrão que aplicar.

implementar-com-padroes

“Como implemento isso do jeito do time?”

O QUE ENTREGA

Checklist dos padrões com links, plano passo a passo, divergências com o código, riscos e passos de commit.

revisar-pr

“Este PR segue os padrões?”

O QUE CONFERE

Requisitos do PJ, impacto e desvios dos manuais, com a página de referência de cada ponto.

No Claude Code: /mcp__yzidro-knowledge__implementar-com-padroes. Veja como usar

CASOS DO TIME N3

O que o time N3 já resolveu.

Os atendimentos do time N3, do Desenvolvimento, no canal do Discord viram casos pesquisáveis: problema, erro exato, causa e solução, sem nomes nem dados de clientes.

search_support_cases

“Já resolvemos esse erro?”

ONDE PROCURA

Mensagem de erro, código, sintoma ou número do chamado, nos casos destilados de todo o histórico do canal.

read_support_case

“Como foi resolvido?”

O QUE ENTREGA

Causa, solução, passos e ressalvas do caso, e a conversa original higienizada, sem credenciais, acessos nem dados de clientes.

Avaliação automática

“Foi resolvido mesmo?”

QUEM DECIDE

A IA lê cada atendimento e classifica: resolvido, parcial, não resolvido ou indefinido, com grau de confiança. Ninguém precisa aprovar caso a caso; marcar a solução no Discord é opcional e só reforça.

Casos são precedentes, não regra oficial: confira versão e contexto antes de aplicar. Veja como pedir

04 / COMO FUNCIONA

Da pergunta
à descoberta.

Conecte um cliente MCP compatível e consulte a base no contexto do seu trabalho.

01

Conecte seu assistente

Configure no cliente o endereço público do servidor MCP, terminado em /mcp. O guia mostra como.

02

Autorize o acesso

Use OAuth no cliente e aprove os escopos. Também é possível usar uma credencial MCP pessoal. Bugs, planejamento e código exigem todos os escopos.

03

Descreva o que precisa

Peça em linguagem natural ou use os fluxos prontos para investigar um bug, planejar um PJ, avaliar impacto, revisar um PR ou implementar seguindo os padrões do time.

PARA DESENVOLVEDORES

Pronto para explorar?

Comece pelo guia do MCP ou consulte os endpoints REST, seus parâmetros e contratos na documentação interativa.