Módulo 04 · O módulo âncora

Composio: a ponte para suas ferramentas

Até aqui o Claude trabalhou com arquivos. Agora ele vai entrar nas ferramentas que tocam seu negócio de verdade: Gmail, Google Sheets, Agenda e centenas de outras. Com sua autorização, e só com ela.

Pré-requisitos: Módulos 00 e 01

Ao final deste módulo você vai:

Ter uma conta no Composio conectada ao seu Claude;
Ter autorizado seus primeiros aplicativos (Google Sheets, Gmail, Agenda);
Entender o que é OAuth e por que você nunca entrega sua senha a ninguém;
Saber revogar qualquer acesso em 1 minuto.

Por que o Claude precisa de uma ponte

Por segurança, o Claude não nasce com acesso a nada seu: nem e-mail, nem planilhas, nem agenda. Para ele conversar com essas ferramentas existe um padrão chamado MCP. Pense numa tomada universal: qualquer ferramenta que siga o padrão pode ser "plugada" no Claude.

O Composio é um serviço que já traz mais de mil ferramentas plugadas nessa tomada: Gmail, Google Sheets, Google Agenda, Notion, Slack e muitas outras. Em vez de configurar uma conexão para cada aplicativo, você conecta o Composio uma vez, e ele vira a sua central de integrações.

O Claude pede, o Composio verifica sua autorização e executa no aplicativo. Cada acesso é seu, revogável a qualquer momento.

OAuth: autorizar sem entregar a senha

Aqui está o conceito de segurança mais importante do curso. Quando o Composio pedir acesso ao seu Google, você não vai digitar sua senha do Google no Composio. Vai acontecer o OAuth, o mesmo mecanismo do botão "Entrar com Google" que você já usa em outros sites:

OAuth é um crachá de visitante: dá acesso limitado, tem dono, e pode ser cancelado. Sua senha nunca viaja.

⚠️

Cheque de segurança: na tela de autorização, confira sempre o endereço no navegador (deve ser do serviço oficial, como accounts.google.com) e leia o que está sendo autorizado. Se algum site pedir sua senha do Google fora do site do Google, não é OAuth: é golpe.

Mão na massa: conecte tudo

Crie sua conta no Composio

Acesse composio.dev e crie uma conta (pode usar "Entrar com Google": olha o OAuth aí). Guarde o e-mail usado: essa conta é o seu chaveiro de integrações.
Abra os conectores do Claude

No Claude Desktop, clique na sua foto ou iniciais (o mesmo canto que você aprendeu no Módulo 00) e abra Settings (Configurações). Na lista, procure Connectors (Conectores).
Ali, clique em "Add custom connector" (adicionar conector personalizado). Se a sua tela estiver diferente, procure sempre a palavra "Connectors": ela é o seu norte.
Cole o endereço do Composio

No campo do conector, cole exatamente:
https://connect.composio.dev/mcp
Não precisa preencher mais nada: sem senha, sem código. Clique em Connect.
Autorize no navegador

Seu navegador vai abrir uma página do Composio pedindo pra autorizar a conexão com o Claude. Faça login com a conta que criou no passo 1 e aprove. Pronto: a ponte está de pé.
Conecte seu primeiro aplicativo (Google Sheets)

Volte ao Cowork e use o prompt "Primeira conexão" abaixo. Na primeira vez que o Claude tentar usar um aplicativo, o Composio gera um link de autorização (o fluxo OAuth do diagrama). Aprove no navegador e a conexão fica salva para as próximas vezes.
Aprenda a revogar (antes de precisar)

Entre no painel do Composio (dashboard.composio.dev) e encontre suas conexões ativas. Localize onde se desconecta um aplicativo. Só de saber o caminho, você usa tudo com mais tranquilidade. Pra cortar tudo de uma vez, também dá pra remover o conector no próprio Claude.

Prompt · primeira conexão

Usando o Composio, verifique quais conexões de aplicativos eu já tenho ativas. Depois quero conectar o Google Sheets: me guie pelo processo de autorização, explicando cada tela que aparecer. Quando estiver conectado, liste as minhas planilhas mais recentes para confirmarmos que funcionou.

Casos de uso

Caso básico

Conversar com a planilha de clientes da Reviva

Primeiro, leve o arquivo 01 Clientes/clientes.xlsx do kit para o Google Sheets: abra drive.google.com, arraste o arquivo e abra com duplo clique. Depois use o prompt:

Prompt · perguntas à planilha

Abra minha planilha "clientes" no Google Sheets e me responda:
1. Quantos clientes ativos a Reviva tem?
2. Quantos clientes estao pausados?
3. Quem faz aniversario neste mes?
4. Tem algum cliente com pacote atual vencido ou pendente?

Se a estrutura da planilha estiver confusa para responder, me diga o que reorganizar.

A planilha deixa de ser um lugar onde você digita e vira um lugar com quem você conversa.

Caso avançado

O combo cobrança da Reviva: planilha + e-mail + agenda

Preparação: leve o arquivo 02 Financeiro/controle-pagamentos.xlsx do kit para o Google Sheets (mesmo processo: arrastar pro Drive).

Prompt · combo cobrança

Usando minhas conexoes do Composio e os dados da clinica Espaco Reviva:
1. Leia a planilha "controle-pagamentos" no Google Sheets e identifique clientes com pagamento atrasado ou vencendo nos proximos 5 dias;
2. Para cada um, crie um RASCUNHO de e-mail no meu Gmail (nao envie!) com um lembrete gentil, no tom da Renata: acolhedor, direto, sem constranger;
3. Crie um evento na minha Google Agenda para depois de amanha as 9h chamado "Revisar e enviar lembretes da Reviva", listando os clientes na descricao.

Me mostre o plano antes de executar.

Repare no "não envie!": o Claude prepara, você revisa e aperta o botão. Comunicação com cliente sempre passa por você (regra que vira lei no Módulo 07). Depois de funcionar com o kit, repita o combo com a sua planilha real.

Perguntas frequentes

O Composio é pago?

Tem plano gratuito que cobre o uso pessoal de começo (uma quantidade mensal de ações) e planos pagos pra volumes maiores. Comece no gratuito; se um dia esbarrar no limite, é sinal de que a ferramenta já se pagou. Confira as condições atuais em composio.dev, porque preços de serviço mudam.

O Composio vê minha senha do Google?

Não, e esse é o ponto do OAuth. Sua senha só é digitada na página oficial do Google. O que o Composio guarda é o "crachá" (token de acesso) que o Google emitiu, limitado ao que você autorizou e cancelável a qualquer momento.

E se eu me arrepender? Como corto o acesso?

Três camadas, da mais cirúrgica à mais radical: 1) desconectar um aplicativo específico no painel do Composio; 2) remover o conector Composio no Claude (corta a ponte inteira); 3) na sua Conta Google → Segurança → "Conexões de terceiros", cassar o crachá direto na fonte. Qualquer uma tem efeito imediato.

O Claude pode enviar e-mails sozinho em meu nome?

Tecnicamente, se você autorizar o Gmail com permissão de envio, ele consegue. Na prática, você controla: peça sempre RASCUNHOS (como no caso avançado) e mantenha "Ask before acting" pra ações de envio. Recomendação do curso: nada sai pro cliente sem seu clique.

Por que não conectar o Google direto no Claude, sem Composio?

O Claude tem alguns conectores nativos (incluindo Google) e eles funcionam bem; se seu uso for só isso, são suficientes. O Composio entra pela amplitude: mais de mil aplicativos num só lugar, incluindo ferramentas que não têm conector nativo (formulários, CRMs, redes). Aprendendo o caminho do Composio, você aprendeu o caminho pra tudo.

Quais aplicativos valem a pena conectar primeiro?

Os três do módulo: Sheets (seus controles), Gmail (comunicação) e Agenda (compromissos). Depois, olhe seu dia: usa Tally ou Google Forms pra captar clientes? Notion pra anotações? Conecte quando aparecer a necessidade real: conexão sem uso é só risco à toa.

A autorização expira? Vou ter que refazer isso sempre?

Não. Depois de autorizado, o acesso persiste entre sessões: você conecta uma vez e usa sempre. Ocasionalmente um serviço pede reautorização (por segurança ou mudança de senha); aí é só repetir o fluxo do crachá, que você já domina.

Posso conectar a conta do Google da minha empresa e a pessoal?

Pode, mas escolha UMA pra começar: a do negócio. Misturar contas confunde você e a IA ("qual agenda? qual Gmail?"). Se precisar das duas, deixe isso explícito nos prompts ("na minha conta profissional...").

Isso funciona com WhatsApp e Instagram?

Parcialmente. WhatsApp e Instagram têm regras rígidas para automação. Os catálogos de integração mudam com frequência e geralmente exigem contas comerciais/APIs oficiais. Verifique no catálogo do Composio o que está disponível hoje. Pra começo de jornada, a dupla e-mail + agenda resolve muito mais do que parece.

Apareceu um erro de conexão. E agora?

Roteiro de 3 passos: 1) peça ao próprio Claude "verifique minhas conexões do Composio e me diga qual está com problema"; 2) no painel do Composio, veja se o aplicativo aparece como conectado (se não, reconecte); 3) persiste? Remova o conector no Claude e refaça os passos 2-4 do módulo (leva 3 minutos). A maioria dos erros é crachá vencido.

É seguro deixar isso conectado pra sempre?

Com as práticas do curso, sim: você sabe o que autorizou, pede rascunhos em vez de envios, mantém "Ask before acting" pro que é sensível e sabe revogar em um minuto. Faça uma revisão trimestral: "o que está conectado que eu não uso mais?", e corte o que sobrar.