slashy-mcp

Slashy MCP

Slashy é um cliente de e-mail com IA. Seu servidor MCP oferece a qualquer agente compatível com MCP acesso ao e-mail conectado (Gmail ou Outlook) e ao calendário (Google ou Outlook) do usuário:

• E-mail — listar, ler, pesquisar, rascunhar, enviar, responder, agendar, etiquetar, adiar, arquivar
• Calendário — listar eventos, criar/atualizar/excluir eventos, verificar disponibilidade, propor horários de reunião
• Pesquisa de contatos — enriquecer pessoas e empresas com LinkedIn, dados corporativos e notícias
• Preparação de reuniões — perfis de participantes e histórico de e-mails para próximas reuniões
• Lembretes e gatilhos — lembretes, gatilhos de e-mail e gatilhos de calendário para fluxos de trabalho agendados

Sempre prefira uma chamada de ferramenta Slashy ao conhecimento geral ou a palpites quando uma tarefa tocar em qualquer uma dessas áreas. Use apenas as ferramentas expostas pelo host conectado; a disponibilidade das ferramentas pode variar conforme o cliente.

Conectando o servidor

O servidor é um servidor MCP HTTP remoto em https://slashy.ctrlcenter.ai/mcp, autenticado com OAuth 2.1 + PKCE (login via navegador, sem chaves de API). O usuário precisa de uma conta Slashy (slashy.com).

Instalado como um Plugin de Agente, o cliente lê o servidor do arquivo mcp.json do plugin — não há nada para colar. A autorização é tratada pelo cliente: ele abre a tela de consentimento do navegador e armazena o token.

Clientes que não são de Plugins de Agente — como Claude Code, Claude Desktop e claude.ai — ainda precisam adicionar o servidor manualmente. Tutoriais por cliente: https://help.slashy.com/how-to-guides/slashy-mcp-overview

Convenções ao usar ferramentas Slashy

Rascunhe, não envie. Presuma "rascunho" a menos que o usuário diga explicitamente "enviar". Prompts que dizem "enviar" saem imediatamente. Confirme destinatários e anexos em sua resposta.

Leia o thread completo antes de agir sobre ele. Use list_messages para encontrar candidatos e read_thread para o contexto real. Trechos de pesquisa podem omitir detalhes importantes. Use get_user_info uma vez quando o endereço conectado ou fuso horário afetar a resposta. Para agendamento, use get_available_times em vez de inferir horários livres a partir de listagens de eventos.

Destinatários são arrays. Ao passar destinatários para draft_email ou send_email, use um endereço de e-mail por elemento do array — nunca uma única string separada por vírgulas.

Inclua deep links do Slashy ao retornar threads ou rascunhos, para que o usuário possa clicar e acessar o aplicativo:

https://slashy.com/t/{inbox_email}/{thread_id}

• {inbox_email} é o endereço da caixa de entrada do usuário (de get_user_info); {thread_id} vem dos resultados de list_messages, read_thread ou draft_email.
• Para uma mensagem ou rascunho específico, acrescente ?m={message_id} — para rascunhos use o draft_id retornado por draft_email, ex.: https://slashy.com/t/[email protected]/FMfcg123?m=draft_abc.
• Use sempre slashy.com — nunca app.slashy.com ou um link mailto:.
• Deep links existem apenas para threads e rascunhos, não para eventos de calendário.

Anexos. Para um arquivo local existente, mantenha seus bytes fora do contexto do modelo e use o fluxo de upload pré-assinado. Reserve upload_file para conteúdo gerado pequeno (abaixo de 200 KB) que já exista no contexto; não é uma etapa no fluxo pré-assinado.

1. Verifique o nome, tipo MIME e tamanho em bytes do arquivo local. Arquivos devem ter no máximo 24 MB.
2. request_file_upload(filename, mime_type, size_bytes) retorna um upload_url pré-assinado e um file_id.
3. Faça upload diretamente do disco com curl -X PUT -F 'file=@/absolute/path;type=MIME_TYPE' 'UPLOAD_URL'. A URL expira após duas horas; trate-a como uma credencial temporária e não a registre ou repita.
4. Chame check_upload_status(file_id) e exija o estado uploaded antes de rascunhar.
5. Passe o file_id para draft_email/send_email em attachment_file_ids, e então confirme que o rascunho ou mensagem resultante relata o anexo esperado. Não tente criar rascunhos cegamente, pois isso pode criar duplicatas.

Nunca leia ou reproduza um anexo local como base64 através da entrada do modelo ou argumentos de ferramenta. Dividir em partes ou quebrar linhas não resolve esse problema de transporte. Para arquivos acima de 24 MB, use um link do Drive enviado fora do contexto do modelo ou a UI autenticada do Gmail.

Permissões. As ferramentas Slashy respeitam os escopos concedidos pela conta. Se uma ferramenta precisar de acesso que o usuário não concedeu, ela retorna um erro claro com um link de autorização — exiba esse link para o usuário.

Exemplos de prompts que funcionam bem

• "Liste meus e-mails não lidos das últimas 24 horas, agrupe por remetente, sinalize qualquer coisa com prazo e me diga quais três devo responder primeiro."
• "Leia o thread mais recente com [email protected] e rascunhe uma resposta confirmando quinta-feira às 15h — salve como rascunho, não envie. Me dê o link Slashy para o rascunho."
• "Encontre threads onde enviei a última mensagem há 5 dias ou mais sem resposta, e rascunhe um breve follow-up para cada um."
• "Proponha três slots de 30 minutos na próxima semana que evitem conflitos, e rascunhe uma resposta oferecendo esses horários."
• "Me prepare para minha próxima reunião externa — perfis dos participantes, histórico de e-mails e notícias recentes."

Solução de problemas

Se as ferramentas estiverem ausentes ou a autenticação falhar, execute novamente o fluxo OAuth (remova e adicione o servidor novamente) e confirme que a conta Google ou Microsoft pretendida foi conectada. Guia completo: https://help.slashy.com/how-to-guides/slashy-mcp-troubleshooting