Claude Code CLI: Programação com IA · Capítulo 13 de 23 · 18 min
Ligar o Claude ao e-mail, à agenda e aos seus sistemas
Sem conector o Claude só sugere; ligado ao e-mail, à agenda e ao seu sistema de vendas, ele age.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
Com o Cowork funcionando, o limite seguinte aparece rápido: enquanto o Claude apenas conversa, quem executa continua sendo você. Ele escreve uma resposta impecável ao cliente e para; o texto fica na tela esperando que você copie, cole no Gmail e clique em enviar, e o mesmo vale para abrir a agenda, procurar o horário livre e mandar o convite. O ganho de produtividade aparece quando o agente (o Claude operando por você) deixa de sugerir e passa a agir dentro das ferramentas onde o trabalho de fato mora. O mecanismo que faz essa ponte tem nome: conector, a ligação autorizada entre o Claude e um sistema, como a extensão de um ramal telefônico.
Um conector liga o Claude, tanto no chat quanto no Cowork, a um sistema externo por meio do MCP (Model Context Protocol), o protocolo que padroniza como o modelo enxerga ferramentas de terceiros. Você ativa cada conector em Personalizar > Conectores e autoriza o acesso uma única vez, em geral por OAuth, o mesmo fluxo de "entrar com o Google" que você já conhece. A partir daí, ler a caixa de entrada, consultar a agenda ou buscar um arquivo no Drive vira uma ação que o agente executa, em vez de um texto que ele manda você copiar.
Os conectores chegam ao Claude por três caminhos, e reconhecer qual é qual evita promessa que a ferramenta não cumpre. Os oficiais são mantidos pela Anthropic e já vêm prontos: Google Workspace (Gmail, Agenda e Drive) e Slack. O Microsoft 365 também é oficial e traz ferramentas de escrita, e-mail, agenda e arquivos no OneDrive e no SharePoint, com uma condição relevante: essas ações de escrita exigem consentimento do administrador no Microsoft Entra e habilitação pela organização, disponível desde meados de 2026. No diretório de conectores você encontra ainda opções como Notion, DocuSign e FactSet, entre outras, prontas para conectar. E há o conector personalizado, o caminho para tudo que é seu: você informa um nome e a URL de um servidor MCP remoto (o endereço de um sistema que fala o padrão MCP, explicado acima), e o Claude passa a enxergar as ferramentas daquele servidor como ações. HubSpot, Salesforce e Jira não são nativos hoje; entram justamente por esse caminho personalizado, desde que exista um MCP que os exponha.
Pense no MCP como o padrão da tomada e em cada conector como um aparelho que você pluga uma vez. Autorizar por OAuth é como entregar um crachá de visitante nominal: o agente passa a circular naquele sistema com as permissões que você concedeu, sem reapresentar a senha a cada tarefa. O crachá vale até você revogar, e cada sistema exige o seu.
Para ligar o primeiro conector oficial, por exemplo o Google Workspace: 1. Abra Personalizar > Conectores no Claude. 2. Localize o conector desejado na lista de oficiais e clique em conectar. 3. Você será levado à tela de OAuth do próprio provedor, a tela de login do Google no caso. 4. Revise as permissões solicitadas e confirme com a conta certa. 5. De volta ao Claude, o conector aparece como ativo e as ferramentas dele já ficam disponíveis para o agente. A autorização vale para as próximas conversas, então você faz isso uma vez e ela vale para todos os pedidos.
Personalizar > Conectores > Adicionar conector personalizado
Nome: CRM da equipe comercial
URL: https://mcp.suaempresa.com.br/crm/sse
O Claude conecta ao servidor MCP nesse endereço e passa
a listar as ferramentas que ele expõe, por exemplo:
- buscar_contato
- listar_negocios_abertos
- registrar_atividade
Cada ferramenta vira uma ação que o agente pode chamar,
sob as mesmas regras de aprovação dos demais conectores.O conector personalizado é a ponte para os sistemas que sustentam a operação: o CRM (o cadastro de clientes e vendas) onde vive o funil (as etapas da venda, do primeiro contato ao fechamento), o ERP que controla estoque e financeiro, ou uma automação que você mesmo montou: um fluxo no n8n (ferramenta de montar tarefas que rodam sozinhas) publicado como servidor MCP. Há um ganho de portabilidade que costuma passar despercebido: o mesmo conector personalizado funciona no Claude, no Cowork e no Claude Desktop. Você configura a ponte uma vez e ela acompanha o agente onde quer que ele trabalhe.
Existe conector OFICIAL para o sistema?
|-- Sim --> ative em Personalizar > Conectores (OAuth)
|
Nao: esta no DIRETORIO de conectores?
|-- Sim --> conecte pelo diretorio
|
Nao: o sistema tem um MCP proprio (ou via n8n)?
|-- Sim --> conector PERSONALIZADO (nome + URL do MCP)
|
Nao tem conector nem API?
|-- Sim --> Claude in Chrome opera a pagina no navegadorApagar um arquivo de forma permanente e as ações sensíveis, enviar um e-mail, assinar um documento, transacionar, sempre dependem da sua aprovação, conforme o modo que você escolheu. Um conector amplia o que o agente alcança, não o que ele decide sozinho. Antes de confiar uma tarefa recorrente a um conector de escrita, rode-a uma vez num modo que pede confirmação e observe o que ele realmente faz.
Em Team e Enterprise, quem habilita conectores para a organização é o administrador, e conectores de escrita podem exigir aprovação por tarefa, além de constarem numa allowlist do que é permitido. No plano gratuito há um limite de cerca de um conector personalizado por conta, o que obriga a escolher a ponte mais valiosa. Antes de desenhar qualquer rotina que dependa de um conector, confirme com o TI se ele está liberado e sob quais regras; é mais barato descobrir a política agora do que redesenhar o fluxo depois.
Suponha uma imobiliária de bairro que agenda visitas pelo Google Agenda e guarda os interessados num CRM próprio: com o Google Workspace oficial e um conector personalizado apontando para o CRM, o Claude cruza a agenda com a lista de interessados e prepara os convites, que só saem depois do ok do corretor. Mapeie o seu caso do mesmo jeito: liste os três sistemas em que a sua equipe mais trabalha e marque, para cada um, qual caminho do fluxograma acima ele segue. Se algum cair em "nem conector nem API" (API: a porta pela qual um programa conversa com outro), ele é candidato ao Claude in Chrome da dica abaixo.
Quando um sistema interno só existe no navegador, sem conector oficial nem API, o Claude in Chrome assume: ele opera a página de verdade, clicando, digitando e preenchendo campos por você. Está em disponibilidade geral em todos os planos diretos desde o fim de junho de 2026. As rotinas agendadas que você verá adiante se apoiam nesses mesmos conectores para agir; aqui o foco foi conectar e entender o que cada um faz, e o agendamento fica para lá.
Ative agora um único conector oficial, o Google Workspace ou o Slack, aquele cuja rotina mais consome seu dia. Faça o fluxo completo: Personalizar > Conectores, autorizar por OAuth com a conta certa, confirmar que aparece como ativo. Depois peça ao Claude uma tarefa apenas de leitura, como resumir seus compromissos de amanhã ou listar e-mails não lidos, sem autorizar nenhum envio. Se o agente trouxer a informação correta do sistema, o conector está funcionando e você já pode avançar para tarefas que escrevem, sempre com aprovação.
Tudo o que este capítulo mostrou parte da sua conversa: você pede, e o Claude lê o seu Slack com o seu crachá. O Claude Tag, em beta público nos planos Team e Enterprise, inverte o ponto de partida. Ele é o Claude trabalhando dentro dos canais do Slack do time (o aplicativo de mensagens da empresa, com uma sala por assunto) e agindo nas outras ferramentas por contas próprias, criadas pelo administrador.
Para o negócio, muda quem é dono do trabalho. Qualquer pessoa do canal escreve @Claude com um pedido, e o resultado sai numa thread (o fio de respostas pendurado embaixo de uma mensagem) que o time inteiro lê. Pelo conector, o mesmo resumo ficaria só na sua tela. Com o Claude Tag, qualquer colega redireciona o trabalho respondendo na thread, sem marcar o Claude de novo.
Conector do Slack ou Claude Tag: de onde parte o trabalho
Conector do Slack
Você
- Parte da sua conversa com o Claude
- Usa o seu acesso, autorizado por OAuth
- O resultado aparece só para você
- Serve ao seu trabalho pessoal
Claude Tag
O time
- Parte de um @Claude escrito no canal
- Usa contas do próprio Claude, criadas pelo administrador
- O resultado fica na thread, à vista do canal
- Serve ao trabalho que o time precisa ver e ajustar
A documentação da Anthropic resume a implantação numa frase: trate o Claude como um novo contratado. Ele ganha um e-mail da empresa e entra em cada ferramenta como membro, com o papel mais restrito que cobre o trabalho (somente leitura, quando a ferramenta oferece). A chave de API (a senha que um programa usa para entrar numa ferramenta) nasce dentro da conta dele. O ganho é triplo. Cada ação aparece no log de auditoria (o livro de registro de quem fez o quê) com o nome dele, cortar o acesso dele não mexe no de ninguém, e o papel mínimo limita o estrago de um pedido mal feito.
Confira as condições antes de marcar a data, porque cada uma trava um passo. O plano precisa ser Team ou Enterprise, e quem conduz precisa ser Owner (o papel de dono) da organização no Claude. As Routines precisam estar ligadas em claude.ai/admin-settings/claude-code, ou o Claude responde a toda menção que está indisponível. Um administrador do Slack precisa estar livre na mesma hora, porque só ele gera o código de pareamento. No plano Team, nada roda sem créditos de uso.
Roteiro de implantação do Claude Tag
Tudo começa em claude.ai/admin-settings/claude-tag, no botão Start setup. A página guarda o progresso se você parar no meio.
Passo 1: Instale o app do Claude no Slack pelo Marketplace
Em claude.com/claude-for-slack, clique em Add to Slack e aprove as permissões.
Deu certo quando: O Claude aparece com o selo APP quando alguém digita @Claude.
Passo 2: Gere o código de pareamento num canal
Rode /invite @Claude e depois envie @Claude connect, sem nenhum outro texto. Só o administrador do Slack consegue.
Erro comum: O código vale uma vez e expira em 15 minutos: combine a hora com o administrador antes.
Passo 3: Cole o código na página e escolha onde o Claude responde
O Slack inteiro, que é a opção recomendada, ou canais específicos, informados pelo ID de cada um.
Deu certo quando: Aparece Connected to seguido do nome do seu Slack.
Passo 4: Escolha ao menos duas ferramentas e conecte o GitHub
O GitHub, onde o time de software guarda o código, entra pelo Claude GitHub App, instalado por um dono da organização no GitHub.
Erro comum: App instalado na conta pessoal de alguém não serve: o Claude Tag só se liga a uma organização do GitHub.
Passo 5: Crie a identidade do Claude em cada ferramenta
E-mail da empresa para ele, convite como membro com o papel mais restrito e chave de API criada já com o login do Claude. Feche uma ferramenta antes de abrir a próxima.
Deu certo quando: A ferramenta aparece como conectada depois que você cola a chave.
Passo 6: Defina o limite mensal de gasto e lance
Escolha o teto e clique em Launch Claude Tag.
Erro comum: Até o lançamento, toda menção recebe a resposta Claude is disabled in this channel.
No fim você tem: O Claude passa a responder às menções no Slack pareado, com as ferramentas que você conectou.
O limite de gasto separa dois bolsos. O trabalho nos canais sai do saldo de uso da organização, e não do assento de cada pessoa. O teto mensal escolhido no lançamento (US$ 500, 1.000, 2.500, 5.000, ilimitado ou personalizado até US$ 1.000.000) limita esse consumo, e ao chegar nele o Claude para e avisa na thread que não conseguiu terminar.
A DM (a mensagem direta, conversa privada entre uma pessoa e o Claude) roda na conta claude.ai de quem escreve e fica fora do teto. A Anthropic não publica tabela de custo por pedido: no piloto, escolha um teto que você aceitaria gastar no primeiro mês e acompanhe o gasto por canal em claude.ai/admin-settings/usage/claude-tag.
No canal ou na mensagem direta: em nome de quem e quem paga
| No canal | Na mensagem direta | |
|---|---|---|
| Age como | As contas do próprio Claude | Você |
| Alcança | As conexões que o administrador ligou ao canal | Os seus conectores pessoais do claude.ai |
| Aparece no registro da ferramenta | Com o nome do Claude | Com o seu nome |
| Quem paga | O saldo da organização, até o limite mensal | O seu assento, com os limites dele |
Quatro tropeços aparecem em quase toda implantação: - O código de pareamento expira em 15 minutos. Se você só viu o código depois do almoço, peça outro ao administrador do Slack. - O GitHub só se liga a uma organização. O app instalado na conta pessoal de alguém trava esse passo. - A resposta Claude is disabled in this channel quer dizer que o lançamento não foi concluído, e não que falta permissão no canal. - A thread aberta antes de você conectar uma ferramenta não enxerga a conexão nova. Se o Claude disser que não alcança algo recém-ligado, abra uma thread nova.
Suponha uma importadora de vinhos com 12 pessoas, cinco em vendas, no plano Team. A sócia, Owner no Claude, marca meia hora com o funcionário que administra o Slack e gera o código com ele na mesma chamada. Ela conecta duas ferramentas com o papel mais restrito de cada uma: no quadro de chamados das pendências de clientes, a conta do Claude só cria e comenta registros; na pasta de propostas do Drive, só lê.
Ela escreve no #vendas um único pedido de rotina, e toda sexta o resumo aparece ali antes da reunião de segunda. Na terça, uma thread longa sobre um lote com rótulo errado termina sem dono. Um vendedor pede, na própria thread, que o Claude registre o problema como chamado, e o link volta com o responsável já atribuído. No histórico do quadro, o chamado aparece em nome da conta do Claude.
Comece por um canal de um único time, com duas ferramentas no papel mais restrito e um teto de gasto baixo no primeiro mês. Rode as três verificações no dia do lançamento e marque a rotina semanal com o fuso escrito no pedido, porque os horários do Claude Tag correm em UTC. A implantação está certa quando o resumo de sexta chega sozinho, o gasto do canal cabe no teto e cada ação do Claude aparece no registro da ferramenta com o nome dele.
Os conectores do claude.ai cobrem e-mail, agenda e Slack. Para os números de mídia e de site, o Google mantém dois servidores MCP oficiais no GitHub: o google-analytics-mcp, que roda relatórios do GA4 pela Data API, e o google-ads-mcp, que consulta campanhas pela API do Google Ads, com a versão 0.0.4 publicada em 25 de setembro de 2026. Os dois só leem: o Claude monta o relatório, mas não muda orçamento nem campanha. Ligados ao Claude Code, eles transformam o fechamento da semana num pedido de um parágrafo.
Gerar o relatório semanal de GA4 e Google Ads pelo MCP
Pré-requisitos: acesso de leitura à propriedade do GA4 e à conta do Google Ads, um projeto no Google Cloud e o pipx instalado. Peça ao TI o token de desenvolvedor do Google Ads se a empresa ainda não tiver um.
Passo 1: Ative as APIs no projeto do Google Cloud
Google Analytics Admin API, Google Analytics Data API e Google Ads API, na biblioteca de APIs do console.
Deu certo quando: as três aparecem como ativadas no painel de APIs do projeto.
Erro comum: ativar num projeto e gerar a credencial em outro; o servidor responde com erro de permissão.
Passo 2: Gere a credencial de leitura com o gcloud
O comando gcloud auth application-default login, com os escopos analytics.readonly e adwords, grava um arquivo JSON e mostra o caminho dele no fim.
Deu certo quando: o terminal termina com Credentials saved to file e o caminho do arquivo.
Erro comum: entrar com uma conta sem acesso à propriedade; o login funciona, mas os relatórios voltam vazios.
Passo 3: Adicione o servidor do GA4 ao Claude Code
Use o comando claude mcp add do bloco abaixo, trocando o caminho do arquivo e o ID do projeto.
Deu certo quando: o /mcp mostra analytics-mcp como conectado.
Erro comum: confundir o ID da propriedade do GA4, só números, com o ID de medição, que começa com G-.
Passo 4: Adicione o servidor do Google Ads
O claude mcp add-json recebe o bloco de configuração do repositório oficial, com o token de desenvolvedor. Quem acessa pela conta de administrador (MCC) informa também GOOGLE_ADS_LOGIN_CUSTOMER_ID.
Deu certo quando: o /mcp mostra google-ads-mcp como conectado, e a pergunta liste as contas que eu acesso devolve os IDs.
Erro comum: token de desenvolvedor só com acesso de teste; o erro avisa que ele está aprovado apenas para contas de teste.
Passo 5: Peça o relatório e guarde o pedido como skill
Use o pedido do bloco abaixo. Quando o formato estiver bom, peça ao Claude que o transforme numa skill chamada relatorio-semanal.
Deu certo quando: o arquivo relatorios/semana-AAAA-MM-DD.md sai com as duas tabelas e os três destaques.
Erro comum: aceitar o primeiro relatório sem conferir; compare dois números com a interface do GA4 e do Google Ads.
No fim você tem: um relatório semanal de site e mídia gerado por um comando, com números conferidos contra as telas oficiais.
# Servidor do GA4 (somente leitura), para todos os seus projetos
claude mcp add analytics-mcp --scope user \
-e GOOGLE_APPLICATION_CREDENTIALS=/caminho/para/credenciais.json \
-e GOOGLE_PROJECT_ID=id-do-seu-projeto \
-- pipx run analytics-mcp
# Servidor do Google Ads (somente leitura)
claude mcp add-json google-ads-mcp --scope user '{"command":"pipx","args":["run","--spec","git+https://github.com/googleads/google-ads-mcp.git","google-ads-mcp"],"env":{"GOOGLE_APPLICATION_CREDENTIALS":"/caminho/para/credenciais.json","GOOGLE_PROJECT_ID":"id-do-seu-projeto","GOOGLE_ADS_DEVELOPER_TOKEN":"SEU_TOKEN"}}'Para o relatório rodar sozinho toda segunda, com o notebook fechado, o caminho é uma rotina na nuvem, e aí vale um detalhe da documentação: servidores adicionados com claude mcp add ficam na sua máquina e não aparecem para as rotinas. Na rotina, o servidor entra como conector do claude.ai ou, numa rotina de um repositório só, declarado no .mcp.json dele. Acertou quando o relatório desta semana bater, número a número, com duas linhas que você conferiu nas telas do GA4 e do Google Ads.
Perguntas frequentes deste capítulo
Preciso saber programar para usar um conector?
O Claude vai enviar e-mails ou mexer nos meus sistemas sozinho?
HubSpot, Salesforce ou Jira têm conector pronto?
Uso o plano gratuito. Quantos conectores personalizados posso ter?
Qual a diferença entre o conector do Slack e o Claude Tag?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Explore os conceitos e compare abordagens em outros cursos. As conexões indicam assuntos relacionados; a sequência de estudo continua no índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacDar ao Claude controle do Google ChromeExaminar conexões de Dar ao Claude controle do Google Chrome
- Setup Completo: do zero ao Claude CodeDeixe o Claude operar o seu Chrome (avançado, opcional)Examinar conexões de Deixe o Claude operar o seu Chrome (avançado, opcional)
- MCP para quem decideControlar a tela de terceiro dentro da conversaExaminar conexões de Controlar a tela de terceiro dentro da conversa
- Segundo cérebro com IAComo ligar o assistente à agenda de reservas sem perder o controleExaminar conexões de Como ligar o assistente à agenda de reservas sem perder o controle
Voltar ao capítulo anterior: Usar o agente do Claude no escritório, sem abrir o terminal
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Claude Code CLI: Programação com IA
- 11Revisar o plano antes de agir e ligar suas ferramentas
- 12Usar o agente do Claude no escritório, sem abrir o terminal
- 13Ligar o Claude ao e-mail, à agenda e aos seus sistemas
- 14Deixar a caixa de entrada e a agenda no piloto automático
- 15Transformar a planilha crua no resumo de uma página da diretoria