IA e MCP

translate e compose gastam cada um uma ação de IA da quota diária do espaço de trabalho, e uma quota esgotada para com o código de saída 8. compose e summarize passam pelas ferramentas MCP composeEmail e getThreadSummary, e é por isso que precisam de um início de sessão no navegador: uma chave de API não chega ao servidor MCP.

openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

Executa a tradução que um envio traduzido executaria e mostra o resultado, para que o possa ler antes de sair alguma coisa. Nada é guardado nem enviado. --to aceita um código, um nome em inglês ou o nome da língua nessa língua. O corpo vem de --text, --html, --body-file ou stdin, e --text e --html também leem um ficheiro com @path.

• —O seu texto original fica por baixo da tradução, a menos que passe --no-original.
• —A língua de origem detetada é mostrada em stderr, e --json mostra a tradução completa.
• —Para traduzir ao enviar, use openemail send --translate de.

openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4

• —compose mostra um corpo redigido no seu estilo e não envia nada, por isso encaminhe-o para openemail send quando estiver satisfeito. Com --thread, lê primeiro as mensagens mais recentes da conversa e redige uma resposta. --tone é um de formal, friendly, casual, concise, direct ou warm.
• —summarize mostra o resumo com o assunto, o remetente e a data. Os resumos são escritos quando o correio chega, e uma conversa que tem uma mensagem cifrada não tem nenhum, o que sai com o código 5.

O servidor MCP do OpenEmail dá a um cliente de IA as ferramentas que o assistente da aplicação usa: pode ler e enviar correio e gerir contactos, modelos, domínios e mais, limitado ao que aprovar. Um cliente liga-se de uma de duas formas, e openemail mcp config mostra ambas para o seu cliente:

• —O servidor remoto. O cliente faz o seu próprio início de sessão no navegador, você aprova-o na página de consentimento do OpenEmail, e ele aparece em Conta → Aplicações ligadas. É a opção mais simples quando o cliente a suporta.
• —A ponte local, openemail mcp serve, que o cliente arranca através de npx. Usa o início de sessão desta CLI, por isso execute primeiro openemail login. Serve para clientes que só arrancam servidores locais.

openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json

claude mcp add --transport http openemail https://api.openemail.uk/mcp

claude mcp add openemail -- npx -y @openemail/cli mcp serve

Depois de adicionar o servidor remoto, o Claude Code inicia sessão a partir de /mcp e o Codex com codex mcp login openemail. O Claude Desktop adiciona-o em Settings → Connectors → Add custom connector. openemail mcp config --client <name> também diz que ficheiro cada cliente lê.

openemail mcp serve lê JSON-RPC delimitado por linhas em stdin, reencaminha cada mensagem para o servidor MCP com o seu início de sessão no navegador guardado e escreve cada resposta em stdout numa linha. Renova um token de acesso expirado sem o cliente dar por isso, responde a um lote como um único array e para quando stdin fecha. Só o protocolo chega a stdout, e stderr fica em silêncio a menos que passe --debug.

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'

• —mcp tools lista as ferramentas que este início de sessão pode usar, já sem as que a sua função ou a aprovação não permitem. Indique uma ferramenta para ver a descrição e os argumentos.
• —mcp call recebe os argumentos como um objeto JSON em --args (em linha, @file ou -), e --arg key=value define um de cada vez. Um valor é lido como JSON quando pode ser analisado, por isso ponha entre aspas um número que queira como texto.
• —O servidor MCP nunca pede confirmação, por isso uma ferramenta que envia ou elimina age de imediato.
• —Um resultado que começa por Refused ( sai com o código 4. Uma ferramenta desconhecida sai com 5, argumentos inválidos com 7, e uma quota de IA esgotada com 8.

Seis ferramentas fazem uma alteração que a API REST protege com um código de verificação, e pedem o mesmo código: createRule, setRuleEnabled, removeDomain, removeDomainAddress, deleteAudience para uma audiência que criou, e emptyAudience para uma audiência que criou e que ainda tem contactos. Num terminal, mcp call pede o código e volta a chamar a ferramenta. Sem supervisão sai com o código 4, por isso execute primeiro openemail verify.

openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read

• —docs ask faz uma pergunta ao assistente da documentação e mostra a resposta à medida que é escrita, e depois as páginas de onde veio. Responde só a partir desta documentação, não precisa de início de sessão e nunca envia as suas credenciais. Uma pergunta pode ter até 600 caracteres, e cada rede pode fazer um número limitado por dia.
• —docs open abre uma página no seu navegador, e --print mostra a ligação em vez disso.
• —docs read mostra uma página em Markdown. Sem página, mostra o índice de todas as páginas.