> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/recursos/recursos/agente-mac.md).

# Instalação agente: Mac

O agente Inteligente Tiflux é compatível com a versão do MacOS 12 Monterey e superiores.

## 📘 Instalação e Configuração do Agente Remoto Tiflux no macOS

```
📍 Localização:
📂 Menu > Recursos > Ações > Baixar agente remoto
```

***

### 🎯 Introdução

O Agente Inteligente Tiflux é compatível com dispositivos Apple rodando macOS (versão 12 Monterey ou superior). Este guia orienta o processo de download, instalação, concessão de permissões de segurança e configuração inicial no Mac de forma simples e segura.<br>

***

### 📚 Sumário

1. 🔧 Pré-requisitos
2. 🛠️ Passo a Passo da Instalação
3. ⚙️ Configurações e Permissões Necessárias (TCC)
4. 👤 Primeiro Acesso e Identificação
5. 🛠️ Troubleshooting (Erros Comuns)
6. ⚠️ Avisos Importantes
7. 🧾 Resumo
8. ❓ Perguntas Frequentes (FAQ)<br>

***

### 🔧 Pré-requisitos

* Sistema Operacional: macOS 12 Monterey ou superior com suporte ativo.
* Acesso ao Tiflux: Login e credencial ativos de usuário técnico no painel do Tiflux.
* Identificação da Arquitetura do Processador:
  * Intel (x64): Pacote destinado a Macs com processadores Intel.
  * Apple Silicon (Arm64): Pacote destinado a Macs com chips da série M (M1, M2, M3, M4, etc.).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FJONBE4tNU6d1AvrQKnu2%2Fimage.png?alt=media&amp;token=46198ce3-abd4-4961-873c-d6b28eeb5be8" alt=""><figcaption></figcaption></figure>

> 💡 Dica rápida: Para checar seu processador, clique no menu Apple () > Sobre Este Mac.

### 🛠️ Passo a Passo da Instalação

1. Acesse o menu Recursos no painel do Tiflux.
2. Clique em `Ações > Baixar agente remoto`.
3. Selecione o Cliente desejado para liberar os campos de download.
4. Preencha os campos obrigatórios e defina o *Grupo de Recurso* (opcional).
5. Selecione o sistema operacional macOS.
6. Escolha a arquitetura correspondente (x64 ou Arm64).
7. Localize o arquivo `TiAgent.pkg` na pasta de Downloads e dê um duplo clique para executar o assistente de instalação (wizard).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FBnlhILcfJfgeDfRo0XoF%2Fimage.png?alt=media&amp;token=5ac146e1-1d8b-4dd0-91ff-e7d25cfa6ae5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F9II2Kqj9uveswWjAyTrp%2Fimage.png?alt=media&amp;token=55ce1784-b507-45d7-b983-9df14bb3b764" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fvn3y1NRILw7BNWplOMAv%2Fimage.png?alt=media&amp;token=8c028334-c6a1-4af2-a26b-bf4698a4c95f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Frh7L6AnOnpQRoXEWerDK%2Fimage.png?alt=media&amp;token=ea2b890c-0887-4aa7-b21b-591d92d385c8" alt=""><figcaption></figcaption></figure>

***

### ⚙️ Configurações e Permissões Necessárias (TCC)

Por exigência de segurança do macOS, concede-se permissão manual para a coleta de inventário e assistência remota:<br>

1. Acesse `Ajustes do Sistema` (ou *Preferências do Sistema*) > `Privacidade e Segurança`.
2. Desbloqueie as alterações autenticando com a senha de administrador da máquina.
3. Habilite o TiAgent obrigatoriamente nas seguintes seções:

   * 🔓 Acesso Total ao Disco: Permite ao agente coletar inventários de hardware/software e executar diagnósticos.
   * 🎥 Gravação de Tela: Permite a visualização do desktop durante as sessões de suporte remoto.

   <br>

   <figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F9FYJ6dZ92YShYH29OA6X%2Fimage.png?alt=media&amp;token=4404fd40-63f0-4268-8c96-37298224c5d2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FJ3uEPGq6y5JcZpQW7DG3%2Fimage.png?alt=media&amp;token=44f21569-4779-4c1f-b281-448e46be3cec" alt=""><figcaption></figcaption></figure>

***

### 👤 Primeiro Acesso e Identificação

1. Abra o aplicativo TiAgent após concluir a instalação e liberar as permissões.
2. Aceite os Termos de Uso.
3. Preencha o Nome e E-mail do solicitante/usuário do dispositivo (Telefone e Ramal são opcionais).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FDjfKNw3Zo29nES02KamG%2Fimage.png?alt=media&amp;token=b5c58a09-c6de-4445-9df8-2b27ecfffb45" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fx8h97pgCttGYH1OjK5AY%2Fimage.png?alt=media&amp;token=8f14e518-bc39-43da-8ebf-0976d97ce963" alt=""><figcaption></figcaption></figure>

***

### 🛠️ Troubleshooting (Erros Comuns)

🔹 Problema: O técnico não consegue visualizar ou controlar a tela do Mac remotamente

* ✅ Solução: Acesse `Ajustes do Sistema > Privacidade e Segurança > Gravação de Tela` e certifique-se de que a chave do TiAgent está ativada.

🔹 Problema: O agente não coleta informações de hardware ou inventário

* ✅ Solução: Vá em `Ajustes do Sistema > Privacidade e Segurança > Acesso Total ao Disco` e confirme se o TiAgent possui permissão concedida.<br>

***

### ⚠️ Avisos Importantes

> Aviso de Desenvolvedor ("Márcio"): Em versões recentes do macOS, pode surgir um alerta com o nome de desenvolvedor "Márcio". Este nome refere-se ao CEO da empresa e está atrelado à conta oficial de desenvolvedor da Apple do Tiflux para fins de assinatura e licenciamento. O software é seguro e o alerta pode ser confirmado sem riscos.

### 🧾 Resumo

A instalação do Agente Tiflux no macOS requer a escolha do pacote de acordo com a arquitetura do chip (Intel ou Apple Silicon), a instalação via arquivo `.pkg` e a liberação manual das permissões de Acesso Total ao Disco e Gravação de Tela nos ajustes de Privacidade do Mac.<br>

***

### ❓ Perguntas Frequentes (FAQ)

🔹 1. O agente Tiflux é compatível com quais versões do macOS? \
É compatível com o macOS 12 Monterey e versões superiores.\
\
🔹 2. Preciso liberar todas as permissões no Mac? \
Sim. É obrigatório liberar *Acesso Total ao Disco* e *Gravação de Tela* para que o acesso remoto e a coleta de inventários funcionem.\
\
🔹 3. Quem precisa logar no agente após a instalação? \
O download vincula a máquina ao cliente via painel técnico. Na máquina do usuário final, basta informar o Nome e E-mail do solicitante.\
\
🔹 4. Posso ignorar as mensagens sobre o desenvolvedor "Márcio"? \
Sim. A mensagem faz parte do processo de assinatura de software da Apple e não representa nenhum risco à segurança.\
\
🔹 5. Como saber qual arquitetura (x64 ou Arm64) devo baixar? \
Consulte o menu Apple () > *Sobre Este Mac*. Se indicar "Intel", baixe a versão x64. Se indicar "Apple M1", "M2", "M3" ou superior, baixe a versão Arm64.

***

### 🔍 Palavras-chave para IA, indexação e busca

```
instalacao agente tiflux mac
agente tiflux macos
configurar agente mac
permissoes agente tiflux
instalacao tiagent mac
acesso total ao disco mac
gravacao de tela mac
```