Conectar o MCP Pro e autorizar o acesso
A conexão é feita uma vez no Claude ou no ChatGPT. Você entra com a conta da Rica Pro numa página da Rica e o aplicativo passa a consultar a sua carteira. A senha não fica com o Claude nem com o ChatGPT.
Dados da conexão
| Campo | Valor |
|---|---|
| Nome | Rica Pro |
| Endereço do servidor | https://pro.mcp.rica.com.br/mcp |
| Autenticação | OAuth, com login na página da Rica |
Use o endereço completo, com /mcp. Não existe chave de API para copiar.
Conectar
- No Claude ou no ChatGPT, abra a área de conectores ou aplicativos e escolha adicionar um servidor MCP remoto.
- Informe o nome Rica Pro e o endereço
https://pro.mcp.rica.com.br/mcp. Se o aplicativo pedir o tipo de autenticação, escolha OAuth. - Inicie a conexão. Abre a página de entrada da Rica, em
entrar.rica.com.br. - Entre com o e-mail da sua conta da Rica Pro.
- Volte ao aplicativo e espere a lista de ferramentas aparecer.
- Numa conversa nova, habilite a Rica Pro.
No Claude, o caminho é Configurações → Conectores → Adicionar conector personalizado (na interface em inglês, Settings → Connectors → Add custom connector). Depois de adicionar, clique em Conectar para abrir o login da Rica. Numa conversa, ative a Rica Pro no botão de ferramentas da caixa de mensagem.
Os nomes dos menus mudam com o produto e o plano. Siga a ajuda oficial do Claude para conectores remotos e do ChatGPT para servidores MCP. Em contas de empresa, o administrador pode precisar liberar o conector antes.
A Rica aceita o retorno do login do Claude, do ChatGPT e de aplicativos instalados no computador. Outros aplicativos na web podem não concluir a entrada.
Fazer o primeiro teste
Use a Rica Pro só para consulta.
Liste meus clientes e mostre nome, e-mail mascarado e quantidade de pessoas.
A resposta deve trazer a Família Costa, a Família Oliveira, a Família Santos, Carlos Mendes e os demais clientes da sua carteira, com o e-mail mascarado (por exemplo, “m***@demo.local”). Nenhum cliente de outro planejador aparece.
Depois:
Use a Família Costa. Confirme o nome em uma linha e liste pessoas,
projetos e contas. Não altere nada.
Confira se aparecem Marina, Rafael e Lia, o projeto Casa e as contas Nubank e Itaú.
Consulta e alteração
O acesso tem duas permissões:
| Permissão | Para quê |
|---|---|
clientes:read | Todas as consultas e análises. |
clientes:write | Criar, editar e remover lançamentos, objetivos, realizações, metas, categorias, conceitos, caixas e templates. |
O Claude e o ChatGPT costumam pedir as duas ao conectar. Se o aplicativo pedir só a primeira, as alterações respondem “Escopo insuficiente para executar … Requer clientes:write.”. Desconecte e conecte de novo. Renovar o acesso mantém as permissões da primeira entrada.
As remoções, e algumas ações marcadas no conector, pedem ainda confirmar: true. O aplicativo mostra o pedido de confirmação antes; leia e confirme só o que você quer.
Validade e desconexão
O acesso vale 24 horas e é renovado sozinho pelo aplicativo. A renovação funciona por até 10 anos depois da última renovação. Em geral, você não precisa entrar de novo.
Não há tela na Rica Pro para ver ou encerrar conexões MCP. Para cortar o acesso, remova ou desconecte o conector no Claude ou no ChatGPT. Para trocar de conta, desconecte e entre com a outra.
Se o aplicativo mostrar uma lista antiga de ferramentas, atualize o conector ou desconecte e conecte de novo.
Se algo der errado
| Mensagem ou situação | Causa | O que fazer |
|---|---|---|
| “Voce ainda nao tem um PlanoAssinante ativo no Rica Pro. Para habilitar o acesso MCP profissional, acesse https://socialrica.com.br/ e siga as instrucoes para profissionais.” | A conta não tem assinatura própria ativa. | Regularize a assinatura em Configurações da conta. |
| A mesma mensagem para um afiliado de Office | O vínculo com o Office foi encerrado. Enquanto o vínculo está ativo, o plano criado pelo Office conta como assinatura do afiliado. | Fale com o responsável pelo Office ou com o suporte da Rica. |
| “Cliente nao encontrado ou nao vinculado ao planejador autenticado.” | O cliente não está na sua carteira, ou o aplicativo usou um identificador errado. | Peça para listar os clientes de novo e escolha da lista. |
| “Escopo insuficiente para executar … Requer clientes:write.” | A conexão tem só consulta. | Desconecte e conecte de novo. |
| “A tool … exige confirmar=true.” | A ação pede confirmação. | Leia o que será feito e confirme no aplicativo. |
| “Erro interno ao executar Rica Pro MCP. Referencia: …” | Falha na Rica. | Tente de novo. Se repetir, envie a referência ao suporte. |
| O aplicativo responde sem consultar a Rica | A Rica Pro não está habilitada na conversa. | Habilite o conector na conversa e repita o pedido. |
| Não aparece a opção de servidor MCP | O plano ou a organização não liberam. | Confira com o administrador do Claude ou do ChatGPT. |
Antes de usar com clientes, leia segurança e controle.