Como conectar Notion, GitHub e Gmail às tarefas de um agente de IA

Em Conta → Conecte seus apps, vincule Google Drive, Gmail, Notion, GitHub, Linear, Slack, Fireflies ou Granola, e um agente conectado ganha quatro novas ferramentas MCP: list_connections, search_context, read_context e save_context. Com elas, ele encontra e lê contexto real antes de fazer uma tarefa, em vez de você mesmo colar uma especificação ou uma conversa nas notas da tarefa. A leitura vem em primeiro lugar, e isso é proposital. Um agente pode trazer um documento do Notion ou uma issue do GitHub para o trabalho e gravar um resultado pronto no Google Drive, mas não pode enviar o seu e-mail, publicar no Slack nem abrir uma issue no rastreador de ninguém. Não são coisas que ele foi apenas instruído a não fazer: são coisas que ele não tem como fazer.

De quais apps um agente pode trazer contexto?

• Google Drive: lê e grava arquivos, com escopo drive.file. Isso inclui os arquivos que este app criou e os que você entregou a ele de forma explícita, nunca o seu Drive inteiro.
• Gmail: busca e leitura de e-mails, somente leitura. O Google classifica esse escopo como restrito, então ele só aparece depois que a instalação do Done passa pela etapa extra de verificação que o libera.
• Notion: lê e grava páginas. O OAuth do Notion não tem nenhum parâmetro de escopo. O que um agente alcança são as páginas que você escolheu durante a instalação, e não algo que o Done solicita.
• GitHub: lê e grava arquivos e issues nos repositórios que você autorizar. O escopo repo é tudo ou nada em repositórios privados, pois o GitHub não oferece um escopo somente leitura mais restrito para eles.
• Linear: lê e grava issues. Os tokens de acesso duram 24 horas, e o Done renova a conexão nos bastidores para que ela não expire sem você perceber.
• Slack: busca somente leitura no histórico dos canais e grupos que você autorizar, reaproveitando o mesmo app do Slack que as notificações de aprovação do Done já usam.
• Fireflies: transcrições de reuniões em modo somente leitura, com uma chave bearer que você cola a partir das configurações do próprio Fireflies (plano Pro do Fireflies ou superior).
• Granola: transcrições de reuniões em modo somente leitura, do mesmo jeito, com uma chave das configurações do Granola (plano Business ou Enterprise do Granola).

Como um agente usa de fato um app conectado em uma tarefa?

list_connections é o ponto de partida. Ele mostra o que está conectado, para qual conta cada conexão aponta e exatamente quais capacidades aquela conexão tem, que podem ser menos do que o app oferece se você restringiu a tela de consentimento ao conectar. A partir daí, search_context recebe uma consulta e devolve resultados com título, tipo (arquivo, nota, issue, mensagem, transcrição, e-mail), link e referência, mas nunca o conteúdo. read_context recebe essa referência e devolve o texto em si. Em geral, um agente busca a especificação ou a conversa que a tarefa menciona, lê o resultado que corresponde e trabalha a partir dele, em vez de adivinhar só pelo título da tarefa. Se produziu algo que vale guardar, save_context grava em uma conexão do Drive com files.write, e o agente continua informando o resultado na própria tarefa com propose_completion ou complete_task, como em qualquer outra execução.

O que search_context realmente busca? É o texto completo de tudo?

Não, e as diferenças importam para o que um agente deve esperar encontrar. O Drive busca em nomes e conteúdo de arquivos. A busca do GitHub cobre só issues e pull requests, não código: ler um arquivo específico é uma chamada a read_context com a referência dele (owner/repo:path), não um resultado de busca. O Slack busca em mensagens, o Notion em títulos e texto de páginas, e o Fireflies e o Granola só nos títulos das reuniões. Algo dito dentro de uma transcrição não aparece, a menos que a própria reunião tenha esse nome. Nada disso é um índice unificado de texto completo de todos os apps conectados. Cada provedor responde com o que a própria API realmente oferece.

Um agente conectado pode enviar e-mail, publicar no Slack ou abrir uma issue por mim?

Não, e isso é proposital. Não existe nenhuma capacidade de enviar e-mail ou mensagem definida na camada de conectores. Um agente pode ler a sua caixa de entrada e os seus canais para ter contexto, mas não tem nenhum caminho para enviar a partir deles. save_context também é mais restrita do que a lista de provedores pode sugerir. É a única ferramenta de gravação, e hoje só o adaptador do Google Drive implementa a gravação de fato. Mesmo uma conexão do GitHub ou do Notion com permissão de gravação ainda não pode receber nada por save_context. Um agente que propõe mandar um e-mail a alguém ou publicar uma atualização está descrevendo o que uma pessoa deve fazer em seguida, não algo que ele consiga executar aqui.

Os apps conectados funcionam com um token com escopo de espaço de trabalho ou somente leitura?

Só um token completo, sem escopo, pode usá-los. Uma conexão é uma credencial pessoal ligada à sua conta, não a um espaço de trabalho específico. Por isso, list_connections, search_context, read_context e save_context são recusadas de imediato para um token MCP com escopo de espaço de trabalho ou de projeto. É o mesmo tratamento dado a get_digest e às outras ferramentas da conta inteira que não têm um recorte por quadro ao qual se limitar. O seu Gmail não tem “a fatia deste espaço de trabalho”. Em vez de aplicar um escopo pela metade, o Done recusa toda essa superfície para um token mais restrito.

Preciso de um plano pago para conectar um app?

Do lado do Done, não. Não há verificação de plano em nenhum ponto, do painel da Conta até search_context ou save_context. Dois dos oito, Fireflies e Granola, podem exigir um plano pago no próprio serviço antes de emitir uma chave de API para você, mas esse é o preço deles, não o do Done. Quais apps com OAuth mostram de fato um botão Conectar na sua conta depende de quem opera o Done ter configurado as credenciais daquele provedor nesta instalação. Um app que não está configurado avisa isso com clareza, em vez de oferecer um botão que termina na página de erro de outro serviço.