# Ligar o seu assistente de IA

O e-mail da Simafri Suite liga-se ao seu assistente de IA por **MCP** (Model Context Protocol), o protocolo aberto que o Claude, o ChatGPT e os principais assistentes falam. Uma vez ligado, o seu assistente trata do seu correio por si: lê, procura, responde, escreve, arruma e agenda os seus envios, nas suas caixas, em seu nome.

|                            |                                                        |
| -------------------------- | ------------------------------------------------------ |
| **Servidor MCP do e-mail** | `https://suite-mcp.simafri.com/mcp`                    |
| **Transporte**             | HTTP streamable                                        |
| **Ligação**                | a sua conta Simafri Suite (conector), ou uma chave API |

## O que o seu assistente faz com os seus e-mails

| Gesto                           | O que o assistente faz                                                                                                                   |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Ler**                         | percorre as suas caixas e as respetivas pastas, as mensagens não lidas, um tópico inteiro com os anexos                                  |
| **Ler os anexos**               | o texto de um PDF, de um documento Word, de uma folha de cálculo Excel, de uma apresentação, de um ficheiro zip; as imagens, que observa |
| **Procurar**                    | numa caixa, por assunto, texto, correspondente ou nome de ficheiro anexado                                                               |
| **Responder e escrever**        | responde num tópico, ao remetente ou a todos, escreve uma nova mensagem, com cópias, cópias ocultas e anexos                             |
| **Reencaminhar**                | reencaminha uma mensagem para outra pessoa, anexos incluídos                                                                             |
| **Agendar**                     | fixa a hora de saída de uma mensagem, lista os envios agendados e recupera um deles                                                      |
| **Arrumar**                     | coloca um tópico no arquivo, na reciclagem ou na receção, marca-o como lido ou não lido                                                  |
| **Tratar o correio indesejado** | assinala um spam e bloqueia o remetente, cancela a subscrição de uma newsletter                                                          |
| **Rascunhos**                   | guarda uma mensagem para terminar, retoma-a, elimina-a                                                                                   |
| **Assinatura e contactos**      | define a assinatura de um endereço, consulta e mantém o livro de endereços                                                               |
| **Receber**                     | vai buscar o correio de imediato                                                                                                         |

O que o seu assistente envia sai dos seus endereços, com a assinatura DKIM do seu domínio, e fica arrumado em **Enviados**, exatamente como uma mensagem escrita em [suite.simafri.com](https://suite.simafri.com/).

### O que lhe pode pedir

* «Resume as mensagens não lidas de `contacto@` desde segunda-feira, e diz-me quais esperam resposta.»
* «Responde à Camille que o orçamento segue amanhã, anexa o PDF recebido ontem e agenda o envio para as 8h.»
* «Arquiva todas as notificações de entrega deste mês.»
* «Encontra o contrato que o Julien me enviou na primavera e diz-me a data de vencimento.»
* «Cancela a minha subscrição desta newsletter e assinala os dois últimos spams.»

## Ligar por conector

É o caminho mais simples: nada a copiar, nada a colar. Serve os assistentes que adicionam um servidor MCP pelo seu endereço, como os conectores do Claude e do ChatGPT.

1. No seu assistente, adicione um **conector personalizado** e indique-lhe o endereço `https://suite-mcp.simafri.com/mcp`.
2. O assistente abre [suite.simafri.com](https://suite.simafri.com/): entre como habitualmente, com o endereço da sua caixa ou a sua identidade Simafri.
3. A página de autorização mostra a aplicação que pede o acesso: confirme a autorização.
4. As ferramentas do seu e-mail aparecem no seu assistente. Peça-lhe, por exemplo, que liste as suas últimas mensagens.

Cada pessoa da equipa liga o seu próprio assistente, seja qual for o seu perfil na conta, e essa ligação age por ela.

## Ligar por chave

Para um assistente em que define os cabeçalhos por si próprio (Claude Code, Claude Desktop, um cliente MCP da sua empresa), a ligação faz-se por **chave API**.

1. O titular da conta abre [suite.simafri.com](https://suite.simafri.com/), **Definições**, **Chaves API**, e cria uma chave.
2. **Copie a chave de imediato**: é mostrada uma única vez.
3. Adicione o servidor ao seu assistente, com a chave no cabeçalho `Authorization`. Com o Claude Code:

```
claude mcp add --transport http --scope user simafri-suite https://suite-mcp.simafri.com/mcp --header "Authorization: Bearer A_SUA_CHAVE"
```

Uma chave age pela conta inteira: serve a automatização da empresa, como um programa que organiza o correio de todas as caixas. Para o assistente de uma pessoa, o conector é o caminho indicado.

## O que o seu assistente alcança

Um assistente ligado por conector trabalha **com as suas permissões**: vê o que o seu ecrã lhe mostra.

* **As suas caixas**: as que consulta, a sua e as caixas partilhadas que lhe são confiadas, como `contacto@`. Cada caixa abre-se às pessoas que a consultam, e ao assistente delas com elas.
* **Os seus envios**: saem de um endereço que consulta.
* **As definições da conta** (quem consulta que caixa, os convites, o livro de endereços comum) seguem o seu perfil, tal como no ecrã.
* **O seu lido e não lido** continua a ser seu: numa caixa partilhada, o que o seu assistente marca como lido fica lido só para si.

## Ver e cortar uma ligação

O ecrã **Aplicações ligadas** lista as suas ligações: abra-o a partir do menu da sua conta, no canto superior direito de [suite.simafri.com](https://suite.simafri.com/). Cada linha indica a aplicação, a data da autorização e a última vez que foi utilizada.

Desligar uma aplicação corta a ligação de imediato e por completo: o assistente perde o acesso no mesmo segundo.

* Cada pessoa vê e corta **as ligações que autorizou**.
* O **titular da conta** vê e corta **todas as ligações da conta**, com o nome da pessoa que autorizou cada uma. Quando um colaborador sai, um único gesto fecha o acesso do seu assistente.
* Uma chave API retira-se em **Definições**, **Chaves API**.

## O servidor MCP da conta: endereços, domínios, armazenamento

Um segundo servidor MCP trata da própria **conta** Simafri, aquilo que faz em [my.simafri.com](https://my.simafri.com/). Liga-se da mesma forma, por conector, com a sua identidade Simafri:

|                           |                                  |
| ------------------------- | -------------------------------- |
| **Servidor MCP da conta** | `https://mcp.simafri.com/v1/mcp` |

Aí, o titular da conta confia ao seu assistente a gestão da Simafri Suite:

* **os endereços**: rever a reserva e os endereços, criar um endereço com a respetiva palavra-passe, atribuir uma nova palavra-passe, fechar um endereço. A ficha de ligação aparece uma vez, para que o titular a entregue à pessoa;
* **os domínios**: as linhas DNS do encaminhamento do correio, a sua verificação, e a passagem do DMARC para uma política mais rigorosa;
* **o armazenamento**: a estimativa de um acréscimo, depois a fatura proforma, que o titular paga como habitualmente.

O mesmo servidor trata também dos seus [sites Serenity](https://docs.simafri.com/pt/serenity/) e dos seus VPS. Ligue os dois servidores ao mesmo assistente: passa assim a tratar da sua conta e do seu correio.

## Estamos aqui para ajudar

Escreva para <support@simafri.com> indicando o assistente que utiliza: acompanhamo-lo na ligação.
