Aplicativos

Em Aplicativos você conecta servidores MCP (Model Context Protocol) e dá ao agente acesso às ferramentas deles — CRMs, analytics, mensageria e outros serviços da sua operação.

Acesse pela sidebar (menu lateral) → Aplicativos, quando o item estiver habilitado na sua conta.

Não confunda com Integração com o Claude (MCP): lá o Knewin AI vira uma ferramenta dentro do Claude; aqui é o contrário — outros serviços viram ferramentas dentro do Knewin AI.

Adicionar um aplicativo

1. Clique em Adicionar aplicativo e informe o nome, a URL do servidor (tem de começar com https) e, se quiser, uma descrição de quando usá-lo.
2. Escolha a autenticação, que tem três formas:
   • Nenhuma — servidores abertos.
   • Token de acesso — você cola o token que o serviço lhe deu.
   • OAuth — o botão Conectar abre a tela de login do serviço numa janela e volta autorizado. Servidores que exigem cadastro prévio têm campos opcionais de ID e segredo.
3. As ferramentas do servidor são sincronizadas e passam a aparecer no cartão do aplicativo.

São no máximo 10 aplicativos por conta.

Escolher o que o agente pode usar

O interruptor no cartão liga/desliga o aplicativo inteiro. Clique no cartão para abrir o detalhe:

• Ferramentas — um interruptor por ferramenta; desligue as que o agente não deve usar. Desligar é um clique; religar uma ferramenta de escrita pede uma confirmação a mais, porque essa é a decisão nova.
• Descrição para o agente (quando usar) — em que situação recorrer àquele aplicativo.
• Ressincronizar — relê o que o servidor oferece.
• Excluir — o agente perde acesso às ferramentas dele.

A ressincronização também acontece sozinha: depois de você autorizar por OAuth, e em segundo plano quando o agente tenta usar uma ferramenta que sumiu do outro lado — a chamada da vez falha, e o turno seguinte já vê a lista nova.

Quando o outro serviço muda o que oferece, o cartão avisa com a data, uma vez só — e o agente reconfere antes de repetir uma ação que já tinha feito.

Leitura e escrita

• Toda ferramenta sincronizada já nasce disponível para o agente — inclusive as de escrita. Se houver alguma que ele não deve usar, desligue-a.
• O que protege a escrita não é o interruptor, é a aprovação: ferramenta de escrita pede a sua confirmação antes de cada execução, com o conteúdo e o destino exatos à vista. Veja Envios e Aprovações.
• Quando o servidor não declara o que é leitura, o Knewin AI trata tudo como escrita: todas pedem confirmação, inclusive as de consulta. O detalhe do aplicativo avisa, e você pode marcar as de consulta como somente leitura.
• Ao escrever, o agente tem de apontar de qual leitura copiou o destino, e o par nome+identificador é conferido dentro dela. Destino deduzido pelo formato é recusado antes de o card chegar a você.

E-mail pela sua própria caixa

Mandar e-mail funciona sem conectar nada — sai pelo remetente da Knewin. Se você quiser que ele saia da sua caixa, com a sua assinatura e ficando no seu histórico, conecte a conta de e-mail aqui. O WhatsApp tem porta própria e não passa por Aplicativos.

Esperas e limites

Conectar espera 15 segundos; cada chamada, 30 — e uma ferramenta que reporta progresso pode levar até 5 minutos. Falha de rede é tentada mais uma vez; credencial recusada não é, e o aplicativo passa a pedir reconexão. Resultado grande demais é cortado, sempre com o corte declarado.

Dados de terceiros

As respostas dos aplicativos não passam pela curadoria da base de mídia da Knewin e nunca são somadas às métricas dela. O agente sempre cita esses dados indicando o aplicativo de origem. Conecte apenas servidores em que você confia.