Liga o Gmail, o Google Sheets e o Slack ao Teu Construtor de Apps
A Mythex consegue agora atuar nas ferramentas que já usas. Liga o Gmail, o Google Sheets, o Slack, o Notion ou centenas de outras apps uma vez, e depois pede ao agente no chat para ler uma folha de cálculo, enviar um email ou publicar uma mensagem. A tua conta fica ligada à Mythex, não ao teu código: o agente nunca vê a credencial, e nada vai parar ao teu repositório.
O que faz
Um conector é uma ligação entre a tua conta Mythex e uma conta que tens noutro sítio. Depois de estabelecida, o agente pode usar essa conta em teu nome quando lho pedires no chat. Por exemplo:
Lê a folha "Pipeline Q4" e cria-me um painel a partir dela
O agente encontra a ação certa para a tarefa, verifica os argumentos de que precisa e executa-a. Por trás disso estão quatro ferramentas:
| Ferramenta | O que faz |
|---|---|
AppListConnections | Lista as apps que ligaste |
AppSearchTools | Encontra a ação certa para uma tarefa e os argumentos que ela recebe |
AppConnect | Dá-te uma ligação para ligares uma app de que precisa |
AppRun | Executa uma ação na tua conta ligada |
Se o agente precisar de uma app que não ligaste, a resposta para num cartão com um botão Ligar, em vez de uma ligação escondida num parágrafo. Carregas nele, aprovas no separador que abre e voltas: o cartão percebe e passa a Ligado. Pede outra vez e o agente continua. Não tenta adivinhar os teus dados nem inventar uma folha de cálculo enquanto espera.
Porque o construímos
Construir algo útil costuma implicar mexer em dados reais: uma folha de leads, uma caixa de entrada, um canal de equipa. O caminho habitual é criar uma chave de API, colá-la num ficheiro de definições e esperar que nunca acabe num commit. Isso é trabalhoso para quem não é programador e arriscado para todos.
Os conectores tiram a chave da equação. Iniciaste sessão com o fornecedor da forma habitual (OAuth, em termos técnicos), e a credencial fica com o serviço de ligações da Mythex:
- Cifrada em repouso
- Nunca escrita no teu projeto, no teu
.envou no código gerado - Nunca enviada para o sandbox onde a tua app é construída: o sandbox pede ao servidor que faça a chamada e recebe o resultado de volta
- Removida quando desligas ou eliminas a tua conta
Como usar
Ligar uma app
- Abre Conectores. Está na barra lateral esquerda, em Projetos, e dentro de um projeto também podes carregar em + ao lado da caixa de mensagens e escolher Conectores. Abre por cima do que estavas a fazer, para não perderes o teu lugar.
- Pesquisa a app. A pesquisa cobre todo o catálogo, não apenas o que está no ecrã.
- Clica em Ligar. A página de início de sessão do fornecedor abre num novo separador, por isso o teu projeto e qualquer mensagem a meio ficam como estavam.
- Aprova o acesso aí.
- Volta ao separador da Mythex. A app mostra um ponto verde e diz Ligado.
Aprova todas as permissões que o fornecedor pedir. No Google, em particular, o acesso é dividido por produto: aprovar o Gmail mas não o Drive deixa a ligação meio funcional, e o agente vai reportar ACCESS_TOKEN_SCOPE_INSUFFICIENT quando tentar usá-la. A solução é desligar, ligar de novo e aprovar tudo.
Pede o que queres
Depois de ligado, basta dizê-lo em linguagem natural. Não tens de indicar a ferramenta nem a ação.
Desligar
Abre Conectores, muda para Ligados na barra lateral esquerda e passa o cursor sobre a app. Desligar revoga imediatamente o acesso da Mythex junto do fornecedor. Tudo o que o agente já construiu fica; apenas deixa de conseguir chegar a essa conta.
O planeamento nunca envia um email
Nos modos Perguntar e Plano, o agente só pode consultar. Pode listar as tuas ligações e pesquisar o que elas poderiam fazer, mas não pode executar uma ação nem iniciar uma ligação. Isso torna o modo Plano um sítio seguro para definir o que queres antes de qualquer coisa tocar na tua caixa de entrada ou nos teus canais. Mais sobre isso em planear antes de construir.
Servidores MCP personalizados
Nem tudo está no catálogo. Conectores → MCP personalizado aceita o URL de qualquer servidor MCP: o teu, o da tua empresa ou um que um fornecedor te deu. Preenche um nome e o URL, escolhe a forma de autenticação e carrega em Adicionar e autorizar:
- Se o servidor pedir que inicies sessão, o seu próprio ecrã de consentimento abre num separador.
- Se pedir um token estático, cola-o no campo de token Bearer. Um token guardado nunca volta a ser mostrado.
- Se não precisar de nada, liga-se imediatamente.
A lista de ferramentas é lida nesse momento, por isso um URL errado ou um token recusado falha no formulário e não a meio de uma construção. Podes desativar um servidor sem o remover, e Atualizar volta a ler as suas ferramentas depois de alterares algo. As autenticações são renovadas em segundo plano. Podes adicionar até dez servidores por conta.
Limites
- As ligações são tuas e são partilhadas por todos os teus projetos.
- Nem todas as apps listadas conseguem ligar-se já. Algumas do catálogo não suportam a ligação e aparecem como indisponíveis.
- Aplicam-se limites de pedidos à frequência com que o agente pode chamar uma app ligada, para proteger a quota da tua conta junto do fornecedor.
- Se um fornecedor revogar ou expirar a autorização, o que é comum após uma alteração de palavra-passe ou de permissões do espaço de trabalho, o agente indica que a app precisa de ser ligada de novo. Desliga e volta a ligar.
Este texto trata do que o agente pode fazer por ti no chat. Para a imagem completa, lê a documentação dos Conectores.