Pular para o conteúdo principal

O que é MCP Pro

MCP significa Model Context Protocol. É um padrão para conectar um assistente de IA a ferramentas externas de forma estruturada.

No Rica Pro, isso significa que o planejador pode conversar com uma IA e pedir que ela consulte dados da Rica, monte análises e prepare a operação do atendimento sem depender de copiar planilhas, prints ou resumos manuais.

A explicação em uma frase​

MCP é o jeito de a IA pedir para a Rica: "me dê os dados certos, com permissão, no formato certo, para eu ajudar o planejador nesta conversa".

Os quatro papéis​

Planejador​

É você. Você define a pergunta, escolhe o cliente, revisa respostas e confirma ou bloqueia ações.

Host​

É o aplicativo onde a conversa acontece, como Claude ou ChatGPT.

Cliente MCP​

É a camada do host que sabe listar ferramentas, pedir autorização e chamar o servidor MCP.

Servidor MCP Rica Pro​

É a parte da Rica que oferece ferramentas profissionais, como listar_clientes, listar_lancamentos_cliente, analisar_fluxo_caixa_cliente e listar_pipeline_consultoria.

Por que isso melhora o atendimento​

Sem MCP, a IA depende do que você cola na conversa. Com MCP, ela pode consultar dados autorizados da Rica e trabalhar com contexto atualizado.

Sem MCPCom MCP Rica Pro
Você abre várias telas antes da reunião.O assistente busca clientes, estrutura, lançamentos, metas e análises.
Você cola dados em uma conversa.A IA chama ferramentas com contratos públicos e sanitizados.
A reunião depende da sua memória operacional.A IA ajuda a organizar pontos de validação, inconsistências e próximas tarefas.
A pós-reunião vira retrabalho.A conversa vira minuta de follow-up, lista de ajustes e roteiro de acompanhamento.

Conceitos essenciais​

Ferramenta​

Uma ferramenta é uma ação que a IA pode chamar. Ela tem nome, descrição, entrada esperada, escopo e anotações de segurança.

Exemplo:

analisar_fluxo_caixa_cliente

Essa ferramenta pede clienteUsuarioId e retorna agregações mensais de entradas, saídas, provisões, investimentos e quantidade de lançamentos.

clienteUsuarioId​

É o identificador do cliente dentro da Rica. Toda ferramenta ligada a um cliente precisa dele.

O fluxo seguro é:

  1. listar clientes com listar_clientes;
  2. escolher o cliente correto;
  3. usar o clienteUsuarioId nas ferramentas seguintes;
  4. pedir ao assistente para confirmar o cliente antes de executar qualquer diagnóstico ou ação.

Escopo​

Escopo é a permissão do token OAuth.

  • clientes:read: permite leitura e análise.
  • clientes:write: permite ferramentas de escrita, destrutivas ou com efeito operacional, respeitando confirmações.

Veja a configuração em Conectar e permissões.

structuredContent​

As respostas das ferramentas não são apenas texto. Elas também retornam conteúdo estruturado para a IA trabalhar com dados de forma mais confiável.

O contrato público do MCP Rica Pro segue este formato:

{
  "schemaVersion": "rica-pro-mcp.v1",
  "tipo": "analise_fluxo_caixa",
  "dados": {
    "meses": []
  }
}

Esse formato ajuda o assistente a separar narrativa de dado, reduzindo erro de interpretação.

Exemplo 1. Preparação de reunião​

Pedido do planejador:

Prepare minha reunião com o cliente Carlos.
Primeiro liste meus clientes e me mostre os possíveis Carlos encontrados.
Depois, quando eu escolher o cliente, consulte fluxo de caixa, patrimônio,
metas e dados disponíveis para a conversa.

O que o assistente pode fazer:

  1. chamar listar_clientes;
  2. pedir sua confirmação do cliente correto;
  3. chamar analisar_fluxo_caixa_cliente;
  4. chamar analisar_patrimonio_cliente;
  5. chamar listar_metas_cliente;
  6. chamar listar_openfinance_cliente e listar_b3_cliente;
  7. entregar uma pauta objetiva de reunião.

Ganho: a reunião começa com contexto, não com navegação.

Exemplo 2. Auditoria de organização​

Pedido do planejador:

Audite a estrutura do cliente selecionado.
Quero saber se existem pessoas sem projeto, contas sem lançamentos recentes,
categorias com muitos lançamentos sem classe e metas sem ciclos ativos.
Mostre as evidências e depois sugira uma ordem de correção.

O que o assistente pode fazer:

  1. chamar obter_sessao_cliente;
  2. listar pessoas, projetos, contas, categorias, classes, lançamentos, metas e ciclos;
  3. comparar os conjuntos;
  4. devolver uma fila de ajuste com impacto no atendimento.

Ganho: a IA ajuda a transformar manutenção de cadastro em qualidade de consultoria.

O que o MCP não faz sozinho​

O MCP não decide por você. Ele também não deve ser usado para "arrumar tudo" sem revisão.

Use o MCP Rica Pro como uma camada de trabalho:

  • a IA consulta e organiza;
  • você interpreta e decide;
  • ferramentas sensíveis exigem escopo, confirmação e auditoria;
  • recomendações profissionais continuam sendo responsabilidade do planejador.

Próximos passos​