Plugin da Sofia para o Claude

Conecte a Sofia ao Claude e comande suas organizações por linguagem natural. O plugin dá acesso à API da Sofia dentro do Claude, liberando interações que hoje não são possíveis diretamente pela interface — como conciliação bancária assistida por IA, dashboards sob medida em tempo real e edições em lote.

Assista ao vídeo acima para ver o passo a passo em tela e use este guia como referência.

O que dá para fazer

  • Conciliação bancária assistida por IA — o Claude sugere os pareamentos e concilia em lote, seguindo as suas regras.
  • Dashboards e BI em tempo real — DRE, fluxo de caixa, projeção e health score da organização, do seu jeito.
  • Edições em lote — o que na interface seria um por um sai em um único comando.
  • Cadastros rápidos — contatos, categorias e tags; suba sua planilha padrão e configure uma org nova em segundos.
  • Lançamentos e recorrências — crie lançamentos avulsos, parcelados ou recorrentes conversando.
  • Consultas e exportações — qualquer dado da Sofia organizado e em Excel na hora.
  • Rotinas no Claude Cowork — deixe tarefas prontas para o Claude executar por você.

Antes de tudo: segurança da sua Chave de API

Sua Chave de API está vinculada ao seu usuário e dá acesso a TODAS as organizações a que você tem acesso. Trate-a como uma senha.

  • Nunca compartilhe sua chave.
  • Não use em um Claude compartilhado. Como a chave fica salva nas instruções do projeto, qualquer pessoa com acesso àquele Claude poderá interagir com todas as suas organizações.
  • Use expiração curta (recomendamos ~7 dias). Se a chave vazar, ela expira rápido e você gera uma nova. Dá um trabalho a mais, mas é uma camada de segurança importante — sobretudo se sua operação lida com dados sensíveis.

Pré-requisitos

  • Uma conta no Claude — funciona tanto na versão online (navegador) quanto no app para desktop (Mac, Windows e Linux).
  • Uma assinatura do Claude compatível com plugins e com o Claude Cowork.

Os planos e recursos do Claude mudam com frequência. Confirme o plano adequado direto no site do Claude antes de começar.

Passo a passo da instalação

1. Acesse o Claude

Você pode usar o Claude direto no navegador ou pelo app de desktop (Mac, Windows ou Linux). O passo a passo abaixo segue o app de desktop, como no vídeo — na versão online os passos são equivalentes.

2. Libere os domínios permitidos

No Claude, vá em Configurações → Capacidades → Domínios permitidos e adicione todos os domínios.

Esse passo é obrigatório: sem ele, o Claude não consegue buscar e autorizar o plugin da API da Sofia.

3. Instale o plugin da Sofia

  1. Abra a área de Plugins.
  2. Clique em Adicionar → Adicionar marketplace / a partir de um repositório.
  3. Informe o repositório do plugin da Sofia e confirme:
/sofia-open-source/sofia-anthropic

O Claude vai baixar o plugin, que é um conjunto de skills (habilidades) prontas da Sofia. Você pode abrir a lista de skills para conferir tudo e validar com a segurança da sua operação.

4. Configure um projeto para cada cliente

Recomendamos criar um projeto no Claude para cada cliente/organização que você atende. Dentro das instruções do projeto, adicione duas informações:

a) ID da organização na Sofia

Na Sofia, com a organização aberta, clique no seu nome → Organização e copie o ID exibido.

b) Chave de API (API Key)

Na Sofia, clique no seu nome → Perfil → Chaves de API:

  1. Gere uma nova chave.
  2. Defina a expiração (recomendamos ~7 dias).
  3. Copie o código gerado — ele aparece apenas uma vez.
  4. Cole nas instruções do projeto e salve.

Para facilitar, use o modelo abaixo nas instruções do projeto, substituindo pelos seus dados:

SOFIA_API_KEY: ak_ABC
organizationId: org_ABC

Pronto. A partir daqui, toda conversa dentro desse projeto já reconhece automaticamente a organização e a sua chave — você não precisa reescrever nada.

Como usar na prática

Dentro de um projeto configurado, é só conversar. Alguns casos de uso que entregam valor real no dia a dia do BPO:

Conciliação bancária assistida por IA

Peça algo como "concilie as transações pendentes desta organização". O Claude puxa as transações bancárias ainda não conciliadas, sugere os pareamentos com os lançamentos correspondentes — seguindo as regras e orientações que você definir — e concilia em lote após a sua confirmação.

Por que importa: a conciliação é a tarefa mais repetitiva da rotina. Aqui ela vira uma conversa, com você no controle das aprovações.

Dashboards e BI em tempo real, do seu jeito

Peça o painel que quiser: "monte um dashboard de fluxo de caixa dos últimos 6 meses com projeção" ou "me mostra a DRE do trimestre com os principais indicadores". O Claude gera análises com os dados ao vivo da Sofia — DRE, fluxo de caixa, projeção de caixa, saldo por conta, health score da organização, com status em semáforo e insights.

Por que importa: relatório sob medida, na hora, sem depender de exportar e montar planilha à mão.

Edições em lote

O que na interface exigiria abrir registro por registro sai em um comando: "adicione 'Equipe' na frente do nome de todos os colaboradores", "recategorize todos os lançamentos do fornecedor X" ou "padronize as tags da carteira".

Por que importa: editar dezenas ou centenas de contatos e lançamentos deixa de ser trabalho de horas.

Árvore de categorias padrão em segundos

Suba sua planilha de categorias padrão e peça para aplicá-la. O Claude substitui as categorias atuais pelas do seu modelo — ideal para deixar uma organização nova já no seu padrão.

Por que importa: onboarding de cliente novo muito mais rápido.

Lançamentos e recorrências

Crie lançamentos avulsos, parcelados ou recorrentes conversando — ou suba uma planilha e lance tudo de uma vez.

Por que importa: menos digitação manual, mais tempo para análise.

Consultas e exportações

"Liste todos os meus contatos agrupados por tipo", "exporte os lançamentos de março em Excel". O Claude organiza os dados e entrega o arquivo na hora.

Proteções que o plugin oferece

  • Confirmação antes de editar — em ações que alteram dados, o Claude pede sua confirmação antes de executar.
  • Snapshot automático — antes das alterações, o Claude salva um "snapshot" (backup) no contexto da conversa. Se algo sair errado, é possível reverter.
  • Autocorreção — quando encontra um erro de execução na API (ex.: um campo faltando), o Claude identifica, corrige e tenta novamente sozinho.

Boas práticas de segurança

  • Um projeto por cliente, com a chave e o ID corretos.
  • Expiração curta na Chave de API (~7 dias) e renovação periódica.
  • Nunca compartilhe a chave nem use um Claude compartilhado.
  • Confira as skills do plugin antes de usar, junto com a segurança da sua operação.
  • Sempre revise as confirmações antes de aprovar edições em lote.

Precisa de ajuda?

Ficou com alguma dúvida na configuração ou quer sugerir um caso de uso? Fale com a gente — estamos à disposição para ajudar você a tirar o máximo do plugin.