Categorias, conceitos, caixas e templates pelo MCP Pro
O MCP Pro organiza a taxonomia em dois lugares: a estrutura de um cliente e o catálogo da consultoria. Use para padronizar categorias entre clientes, criar conceitos que ajudam a categorização e montar templates.
| Onde | Consultar | Criar, editar e remover |
|---|---|---|
| Cliente da carteira | 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 |
Nos pedidos, diga sempre em qual dos dois lugares mexer. “Crie a categoria Pets” pode ir para a Família Costa ou para o catálogo da Horizonte Planejamento.
Limites
| Limite | Cliente | Catálogo |
|---|---|---|
| Categorias | 130 | sem limite total |
| Caixas | 30 | sem limite total |
| Conceitos por categoria | 100 | 100 |
| Nome do conceito | 80 caracteres | 80 caracteres |
| Definição do conceito | 300 caracteres | 300 caracteres |
Estruturas antigas que já passam do limite continuam como estão. Dá para editar e reduzir, mas não aumentar.
Organizar a taxonomia de um cliente
- Confirme o cliente.
- Peça o uso dos limites e a lista atual.
- Peça a proposta da mudança.
- Confirme uma mudança por vez.
- Peça para ler de novo o item alterado.
Na Família Costa, mostre quantas categorias e caixas existem e quanto falta
para o limite. Liste as categorias de Essenciais com os conceitos de cada uma.
Na Família Costa, crie a categoria "Escola da Lia" com os conceitos
"Mensalidade escolar" (pagamentos mensais da escola da Lia) e
"Material escolar" (livros, cadernos e uniforme). Relacione à caixa Essenciais.
Mostre os dados e espere minha confirmação.
Uma categoria pode estar em mais de uma caixa. As relações usam os identificadores que a própria Rica devolve nas consultas; peça para o aplicativo não inventar identificadores.
Manter o catálogo da consultoria
O catálogo segue a ordem categorias → caixas → templates. Ao criar algo novo, crie nessa ordem:
- categoria e conceitos;
- caixa com as categorias;
- template com as caixas.
No catálogo da Horizonte Planejamento, crie um template "Autônomo" com as caixas
Receitas, Essenciais, Estilo de vida e Investimentos e uma caixa nova "Impostos"
com as categorias DAS e IRPF. Reaproveite o que já existe e crie uma etapa por vez,
pedindo minha confirmação em cada uma.
Mudar o catálogo não muda os clientes que já receberam o template. Para incluir agentes no template, use a tela de templates; o MCP Pro não altera agentes. Veja modelos de agentes e templates.
O que muda ao remover
As remoções pedem confirmar: true e não são bloqueadas por uso. A Rica remove o item e desfaz as ligações:
| Remover | O que acontece |
|---|---|
| Categoria do cliente | Os lançamentos ficam sem categoria, as caixas perdem a categoria e as condições de agentes deixam de citá-la. Se era a única categoria de um agente, ele passa a valer para todas. |
| Caixa do cliente | As metas perdem a caixa e as manutenções de investimentos manuais ligadas a ela são desvinculadas. |
| Categoria do catálogo | As caixas do catálogo perdem a categoria. |
| Caixa do catálogo | Os templates perdem a caixa. |
| Template do catálogo | Sai do catálogo. As estruturas criadas com ele continuam iguais. |
Antes de remover uma categoria de cliente, peça quantos lançamentos e caixas a usam:
Na Família Costa, quantos lançamentos e quais caixas usam a categoria Delivery?
Não remova nada ainda.
Como conferir
Na Rica Pro, abra a Família Costa em Estrutura para ver categorias, conceitos e caixas. O catálogo fica em Configurações da consultoria.
Se algo der errado
| Código e mensagem | Causa | O que fazer |
|---|---|---|
limite_taxonomia_excedido: “A operação projetaria 131 categorias, acima do limite 130.” | Acima do limite do cliente. | Junte ou remova categorias antes. |
limite_caracteres_conceito_excedido: “O campo nome do conceito possui 95 caracteres, acima do limite 80.” | Conceito longo demais. | Encurte o nome ou a definição. |
nome_duplicado: “Já existe categoria com o nome 'Mercado'.” | Nome igual no catálogo, ou renomear um item do cliente para um nome que já existe. No cliente, criar com um nome que já existe atualiza a categoria ou caixa existente em vez de dar erro. | Use a existente ou escolha outro nome. |
referencia_fora_escopo: “A referência de categoria não pertence ao contexto autorizado.” | Identificador de outro cliente ou do catálogo errado. | Peça a lista de novo e use os identificadores dela. |
| “Escopo insuficiente para executar … Requer clientes:write.” | Conexão só com consulta. | Veja conectar e autorizar. |
Nenhum desses erros grava parte da mudança. Consulte de novo antes de repetir.