Manutenção da taxonomia

O MCP Pro permite manter a taxonomia em dois contextos separados: a estrutura de um cliente vinculado e o catálogo da própria consultoria. As ferramentas usam o planejador autenticado como autoridade; um identificador recebido na conversa apenas seleciona um cliente que já precisa pertencer à carteira.

Não misture estrutura de cliente e catálogo.Primeiro escolha o contexto, liste os itens existentes e reutilize somente os identificadores retornados nessa consulta.

O que está ativo

Contexto	Consultar	Criar, atualizar e remover
Cliente vinculado	categorias, conceitos, caixas e uso dos limites	categorias, conceitos e caixas
Catálogo da consultoria	categorias, conceitos, caixas e templates	categorias, conceitos, caixas e templates

Uma categoria pode pertencer a várias caixas. No catálogo, as relações seguem esta ordem:

categorias → caixas → templates

As relações de escrita usam identificadores canônicos: caixas recebem categoriasIds e templates recebem caixasIds. O MCP Pro não expõe compatibilidade com a modelagem removida.

Limites aplicados

Contexto	Categorias	Caixas	Conceitos por categoria
Estrutura de cliente	130	30	5
Catálogo da consultoria	sem limite total	sem limite total	5

Dados legados acima desses limites são preservados. É possível editar sem aumentar, desvincular ou remover, mas não ampliar a quantidade já excedida.

Fluxo seguro para um cliente

1. Liste os clientes e escolha o registro correto.
2. Use o clienteUsuarioId retornado pela Rica Pro; não tente adivinhar esse valor.
3. Consulte obter_uso_taxonomia_cliente.
4. Liste categorias, conceitos e caixas existentes.
5. Mostre a mudança projetada e espere confirmação.
6. Execute uma mudança por vez e consulte novamente o item alterado.

Liste os clientes que correspondem a “Mariana” e espere eu escolher.
No cliente confirmado, consulte o uso da taxonomia e liste categorias,
conceitos e caixas. Mostre duplicidades e lacunas, sem alterar nada.

Depois da revisão:

Prepare a criação da categoria “Saúde preventiva” no cliente confirmado.
Verifique nome equivalente e cota disponível, proponha no máximo cinco conceitos
e mostre todos os campos. Só execute depois da minha confirmação.

Fluxo seguro para o catálogo

O catálogo pertence ao planejador autenticado e não recebe clienteUsuarioId.

Liste categorias, conceitos, caixas e templates do meu catálogo.
Mostre a cadeia de referências e identifique nomes duplicados ou relações ausentes.
Não altere nada.

Ao criar uma cadeia nova, avance na ordem das dependências:

1. categoria e até cinco conceitos;
2. caixa usando os IDs das categorias;
3. template usando os IDs das caixas.

Prepare um novo template de estrutura para profissionais autônomos.
Reutilize itens equivalentes já existentes e mostre somente os itens realmente novos.
Crie uma etapa por vez e peça confirmação antes de cada gravação.

Remoção sem cascata

Ferramentas de remoção exigem confirmar=true. Antes disso, peça uma análise dos vínculos disponíveis. A verificação definitiva ocorre dentro da operação confirmada: se houver dependências, nada é removido e o MCP Pro devolve os bloqueios.

Item	Remoção bloqueada enquanto houver
Categoria do cliente	caixas, lançamentos ou gatilhos de agentes
Caixa do cliente	metas ou manutenções de investimentos
Categoria do catálogo	caixas do catálogo
Caixa do catálogo	templates
Template	configurações, contatos ou convites que o selecionem

Clones que já foram aplicados em estruturas são independentes e não bloqueiam a remoção do item original do catálogo. A remoção nunca desfaz vínculos nem apaga dependências automaticamente.

Permissões e conflitos

Consultas exigem clientes:read. Criações, atualizações e remoções de taxonomia exigem clientes:write. Se o aplicativo de IA armazenou uma versão antiga das ferramentas, atualize as ações do conector ou reconecte o MCP Pro.

Conflitos esperados voltam como erro estruturado, sem gravação parcial:

Código	Significado
limite_taxonomia_excedido	A projeção ultrapassa a cota permitida.
nome_duplicado	Já existe um item equivalente no mesmo contexto.
referencia_fora_escopo	Um ID não pertence ao cliente ou catálogo autorizado.
entidade_em_uso	Há dependências que impedem a remoção.

Peça ao assistente para mostrar atual, limite, projecao, excedente e dependencias quando esses campos estiverem presentes.

A exceção de escrita é a taxonomia

Categorias, conceitos e caixas de clientes e categorias, conceitos, caixas e templates do catálogo têm manutenção real. Outras ações de criação, atualização, remoção, envio, cobrança ou upload que aparecem no MCP Pro continuam pendentes e retornam executada=false.