Temway MCP Server
Design Visual de Email para Equipes
Documentação
Visão geral
O servidor Model Context Protocol (MCP) da Temway permite que um assistente de IA como Claude ou ChatGPT crie e edite seus e-mails e layouts para você — você descreve o que deseja em linguagem simples, e o assistente faz os cliques. Comece um novo e-mail a partir da sua marca, insira um botão, ajuste o título, visualize e publique — tudo a partir de uma conversa.
Não há nada para instalar ou compilar. A Temway hospeda o servidor MCP, e tanto o Claude quanto o ChatGPT se conectam a ele pelo transporte padrão Streamable HTTP do MCP. Por padrão, uma conexão é limitada a um único workspace, então um assistente só pode tocar nos e-mails e layouts desse workspace — um proprietário ou administrador que gerencia vários clientes pode, em vez disso, conceder acesso a todos os workspaces da equipe com uma única credencial.
Como você se conecta depende do cliente:
- Conectores web (claude.ai, ChatGPT) usam um fluxo de login padrão — você cola um URL, faz login na Temway e escolhe o workspace para compartilhar. Sem chave para gerenciar.
- Clientes desktop e programáticos (Claude Desktop, scripts) usam uma chave de API
tmw_live_…que você cola na configuração do cliente. Você pode restringir a chave para somente leitura, para um assistente que pode ver, mas não alterar.
O servidor MCP está disponível em todos os planos, incluindo o Free — ele usa o acesso à API que já acompanha todos os workspaces, então não há nada extra para ativar ou comprar. Consulte a página de cobrança e planos para saber o que cada nível inclui.
Obter uma chave de API
As chaves de API são criadas na entrada Developer na barra lateral principal do aplicativo Temway. Crie uma dedicada ao seu assistente de IA (você pode nomeá-la "Claude", por exemplo, para lembrar para que serve).
- A chave completa começa com
tmw_live_e é mostrada apenas uma vez na criação — copie-a em um local seguro. - Uma nova chave pode fazer tudo por padrão: ler e editar e-mails e layouts, visualizar, publicar e enviar testes.
- Quer um assistente somente leitura? Restrinja os escopos ao criar a chave (por exemplo, apenas
emails:readelayouts:read). - Por padrão, a chave está vinculada a um único workspace, e o workspace é derivado automaticamente da chave — você nunca precisa colar um ID de workspace no seu cliente de IA. Um proprietário ou administrador pode, em vez disso, criar a chave com escopo para todos os workspaces da equipe.
Conectar o Claude Desktop
Abra o arquivo de configuração do desenvolvedor do aplicativo desktop do Claude e adicione uma entrada temway em mcpServers com o URL MCP da Temway e sua chave de API em um cabeçalho Authorization.
Localização do arquivo de configuração: macOS — ~/Library/Application Support/Claude/claude_desktop_config.json · Windows — %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"temway": {
"url": "https://mcp.temway.com/mcp",
"headers": {
"Authorization": "Bearer tmw_live_xxxxxxxxxxxxxxxx"
}
}
}
}
Salve o arquivo e reinicie o Claude Desktop. Você verá uma confirmação de conexão, e as ferramentas da Temway ficarão disponíveis para o Claude no workspace ao qual essa chave pertence.
Conectar claude.ai ou ChatGPT na web
Clientes web hospedados como claude.ai e ChatGPT não aceitam chaves de API estáticas para conectores personalizados — eles guiam você por um fluxo de login OAuth padrão. Você só precisa do URL MCP da Temway; o cliente cuida do resto.
URL do conector — igual para Claude e ChatGPT, sem cabeçalho ou chave:
https://mcp.temway.com/mcp
- No seu cliente de IA, abra as configurações de conector / conector personalizado e adicione um novo conector com o URL acima. Não adicione cabeçalho ou chave.
- O cliente abre uma página de autorização da Temway. Faça login com sua conta Temway (Google) se ainda não estiver.
- Escolha o workspace ao qual o conector pode acessar — proprietários e administradores em uma equipe com mais de um workspace também veem a opção Todos os workspaces desta equipe — revise as permissões e selecione Autorizar.
- Você é redirecionado de volta ao claude.ai ou ChatGPT, e o conector fica ativo para suas conversas.
Por padrão, a conexão está vinculada ao workspace que você escolheu, então ela só vê os e-mails e layouts desse workspace. Para apontá-la para um workspace diferente, remova o conector e adicione-o novamente, escolhendo o outro workspace durante a autorização — ou, se você autorizou todos os workspaces da equipe, basta pedir ao assistente para alternar em vez de reconectar. Você pode reutilizar o mesmo conector em todos os chats.
Nota: Se o seu cliente ainda pedir um cabeçalho Authorization (a maioria dos clientes desktop e CLI pede), use o fluxo de chave de API em vez disso.
Para agências: uma credencial em todos os workspaces
Gerencia uma agência com vários workspaces de clientes em uma equipe? Em vez de uma chave ou conexão separada por cliente, um proprietário ou administrador pode criar uma credencial com escopo para toda a equipe em vez de um único workspace — marque "disponível para todos os workspaces desta equipe" ao criar uma chave de API, ou escolha "Todos os workspaces desta equipe" ao autorizar um conector claude.ai/ChatGPT. O assistente começa no workspace padrão da equipe e pode alternar entre clientes no meio da conversa, sem reconectar:
| Ferramenta | O que faz |
|---|---|
list_workspaces | Lista todos os workspaces que esta credencial pode acessar, indicando qual está ativo no momento |
switch_workspace | Move o restante da conversa para um workspace diferente, sem reconectar |
Prefere chaves separadas e revogáveis individualmente? O gerador de chaves em massa da página Developer cria uma chave tmw_live_ por workspace em um clique e devolve um único bloco de configuração com uma entrada nomeada para cada cliente — cole-o no Claude Desktop e todos os workspaces se conectam de forma independente.
Nada disso muda para uma credencial com escopo de workspace (o padrão) — ela continua funcionando exatamente como descrito acima, vendo apenas o workspace para o qual foi criada. Um administrador de equipe também pode restringir o workspace de um cliente específico a uma lista escolhida de funcionários (consulte Gerenciamento de Equipe); uma credencial pertencente a alguém fora dessa lista para de funcionar para esse workspace na próxima autorização ou renovação.
O que você pode pedir
Depois de conectado, basta conversar naturalmente com o Claude. Alguns exemplos para começar — misture e combine para se adequar ao seu fluxo de trabalho.
Começar um novo e-mail
- "Crie um novo e-mail chamado Boletim de Junho."
- "Comece um novo e-mail com a minha marca."
- "Faça um e-mail promocional usando o modelo promocional."
- "Crie um e-mail a partir do meu layout Newsletter."
Editar conteúdo e design
- "Adicione um botão que diz Compre agora com link para temway.com."
- "Mude o título para Promoção de Verão e use a nossa cor de marca."
- "Troque a imagem principal por [URL]."
- "Adicione um bloco social com nossos perfis do Facebook, Instagram e X."
- "Aplique nossas fontes de marca em todo o e-mail."
Visualizar e publicar
- "Mostre-me uma prévia."
- "Publique."
- "Envie um teste para [email protected]."
Criar e reutilizar layouts
- "Crie um layout de duas colunas que eu possa reutilizar."
- "Adicione um retângulo arredondado atrás do logotipo."
- "Publique este layout para que eu possa começar novos e-mails a partir dele."
Capacidades completas
Estas são as ferramentas que o Claude pode chamar em seu nome. Você não precisa memorizá-las — descreva o que deseja, e o Claude escolhe a certa. Elas estão listadas aqui para que você saiba exatamente o que a conexão permite. Ações de leitura precisam de um escopo de leitura; qualquer coisa que altere conteúdo precisa de um escopo de escrita.
Descoberta e contexto
Deixe o Claude entender seu workspace e os blocos de construção disponíveis antes de começar a editar.
| Ferramenta | O que faz |
|---|---|
get_branding | Lê a marca do seu workspace — cores, fontes, logotipo, padrões de remetente |
list_block_types | Lista os tipos de bloco disponíveis em e-mails (texto, botão, imagem…) |
get_block_schema | Obtém as propriedades editáveis de um tipo de bloco |
list_layout_element_types | Lista os tipos de elemento para layouts (imagem, texto, botão, forma, divisor, contagem regressiva) |
get_element_schema | Obtém as propriedades editáveis de um elemento de layout |
get_universal_schema | Obtém as configurações de nível de marca (universais) para um e-mail |
list_fonts | Lista as fontes disponíveis (seguras para e-mail, ou todas, incluindo Google e customizadas do workspace para layouts) |
list_templates | Lista os modelos iniciais de e-mail |
list_layout_templates | Lista os modelos iniciais de layout |
list_concepts | Lista os scaffolds de conceito reutilizáveis (blocos de construção de conteúdo componíveis) |
get_concept | Obtém os detalhes de um conceito |
list_workspaces | Lista todos os workspaces que esta conexão pode acessar (mais útil para uma credencial de equipe — consulte para agências) |
switch_workspace | Move a sessão para um workspace diferente sem reconectar |
E-mails
| Ferramenta | O que faz |
|---|---|
list_emails | Lista os e-mails no workspace |
get_email | Lê um e-mail (metadados ou conteúdo completo) |
create_email | Cria um novo rascunho de e-mail |
update_email | Atualiza o nome, assunto, preheader, tags ou conteúdo de um e-mail |
delete_email | Exclui um e-mail |
duplicate_email | Duplica um e-mail |
create_email_from_layout | Cria um novo e-mail a partir de um layout publicado |
set_content | Substitui todo o conteúdo de um e-mail (avançado) |
validate_content | Valida o conteúdo de um e-mail contra o esquema |
Blocos de e-mail
A forma natural de editar um e-mail — adicionar, alterar, remover ou reordenar blocos individuais.
| Ferramenta | O que faz |
|---|---|
add_block | Adiciona um novo bloco (texto, botão, imagem, divisor…) |
update_block | Atualiza as propriedades de um único bloco |
remove_block | Remove um bloco |
move_block | Reordena um bloco dentro do e-mail |
set_universal | Aplica configurações de nível de marca em todo o e-mail (cores, fontes) |
apply_template | Aplica um modelo inicial ao e-mail |
Visualizar, publicar e enviar
Estas ferramentas executam uma renderização rápida em segundo plano e relatam o resultado. Publicar armazena a versão que as pessoas veem em links compartilhados; envio de teste entrega a versão de caixa de entrada para um endereço de e-mail.
| Ferramenta | O que faz |
|---|---|
preview_email_web | Renderiza uma prévia web rápida e precisa (a prévia preferida) |
preview_email_html | Renderiza a versão de caixa de entrada/HTML para verificar como chega nos clientes de e-mail |
publish_email | Renderiza e publica o e-mail (versão web, com um snapshot da versão salva) |
test_send_email | Envia um e-mail de teste para um endereço que você especificar |
Layouts
Layouts são canvases reutilizáveis nos quais você pode basear novos e-mails. Publique um layout uma vez e comece e-mails a partir dele.
| Ferramenta | O que faz |
|---|---|
list_layouts | Lista os layouts no workspace |
get_layout | Lê um layout |
create_layout | Cria um novo rascunho de layout |
update_layout | Atualiza o nome, descrição ou conteúdo de um layout |
delete_layout | Exclui um layout |
set_layout_content | Substitui todo o conteúdo do layout (avançado) |
apply_layout_template | Aplica um modelo inicial de layout |
add_layout_element | Adiciona um elemento ao canvas (texto, imagem, botão…) |
add_custom_shape | Adiciona uma forma SVG personalizada (arte vetorial sob medida) |
update_layout_element | Atualiza as propriedades de um elemento |
remove_layout_element | Remove um elemento |
publish_layout | Publica um layout para que novos e-mails possam ser criados a partir dele |
Quando alguém está editando no navegador
A Temway mantém um bloqueio de edição leve em um e-mail ou layout enquanto alguém o tem aberto no navegador, para que duas pessoas não sobrescrevam as alterações uma da outra. Se você pedir ao Claude para editar algo que um colega está editando no momento, ele informará quem detém o bloqueio, em vez de assumir silenciosamente.
Se você tiver certeza de que deseja continuar mesmo assim (por exemplo, um bloqueio deixado por uma aba fechada), o Claude pode forçar a liberação do bloqueio — mas ele está configurado para pedir sua confirmação primeiro, porque forçar a liberação pode perder o trabalho não salvo da outra pessoa. A mesma proteção funciona ao contrário: alguém no navegador pode assumir um bloqueio que o Claude detém.
| Ferramenta | O que faz |
|---|---|
acquire_email_lock / acquire_layout_lock | Assume o bloqueio de edição |
release_email_lock / release_layout_lock | Libera um bloqueio que você detém |
force_release_email_lock / force_release_layout_lock | Força a liberação do bloqueio de outra pessoa (o Claude pede antes de fazer isso) |