MCPAgentes

Traga o seu próprio agente.

Conecte Claude, ChatGPT, Gemini CLI, GitHub Copilot, Cursor ou o seu próprio código a uma caixa de e-mail, com as mesmas verificações do nosso agente.

01

Antes de começar

  • Uma equipe no MySendbox com Agents ativado e pelo menos uma caixa de e-mail.
  • Um proprietário na equipe para aprovar a conexão.
  • Para o agente responder, e não só ler: abra as configurações da caixa de e-mail no painel e defina Who answers como “Your connected agent” ou “Either”.

Ainda não tem conta? Adicione o servidor mesmo assim e escolha “Criar um espaço de trabalho para seu agente” quando pedir para entrar. Ele lê na hora; as respostas começam com o plano.

02

Adicione o servidor ao seu app

O servidor usa Streamable HTTP e faz login com OAuth, então a maioria dos apps só precisa da URL.

URL do servidorClaude, ChatGPT
https://mcp.mysendbox.com/mcp
  • Claude (web e desktop): adicione o MySendbox pelo diretório de conectores do Claude, ou vá em Settings → Connectors → Add custom connector e cole a URL.
  • ChatGPT: adicione como um conector personalizado (servidor MCP) com a mesma URL.
Claude Code
claude mcp add --transport http mysendbox https://mcp.mysendbox.com/mcp
Gemini CLI
gemini mcp add --scope user --transport http mysendbox https://mcp.mysendbox.com/mcp
Ou nas configurações do Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "mysendbox": { "httpUrl": "https://mcp.mysendbox.com/mcp" }
  }
}

Depois execute /mcp auth mysendbox no Gemini CLI para entrar e aprovar a conexão no navegador.

GitHub Copilot no VS Code.vscode/mcp.json
{
  "servers": {
    "mysendbox": { "type": "http", "url": "https://mcp.mysendbox.com/mcp" }
  }
}

Clique em Start acima do servidor no arquivo, entre quando o VS Code pedir e use pelo Copilot Chat no modo agente.

Cursor e outros clientesmcp.json
{
  "mcpServers": {
    "mysendbox": { "url": "https://mcp.mysendbox.com/mcp" }
  }
}
03

Aprove a conexão

Na primeira vez que o agente se conecta, seu app abre uma página em app.mysendbox.com. Entre como proprietário, escolha as caixas de e-mail que o agente pode usar e defina o acesso dele:

  • Read: ler e pesquisar e-mails.
  • Draft: ler, organizar e escrever rascunhos para uma pessoa da sua equipe enviar.
  • Reply: ler, organizar e responder. As respostas são verificadas e, quando arriscadas, esperam a revisão de uma pessoa.
04

Ferramentas

Ferramentaspor acesso
read    list_mailboxes  list_messages  search_messages
        get_message  get_thread  get_attachment  get_reply
        account_status   → what it may do in each mailbox, credits
        wait_for         → the reply it's waiting for, as it arrives
        wait_for_code    → the code or link from a sign-up email
        list_threads     → where each conversation stands
draft   + mark_read  move_messages  draft_reply  draft_email
        + set_thread     → a note or a follow-up date on a conversation
reply   + send_reply   → sent, or waits for review
        + send_email   → a new email: waits for a person to approve it,
                         unless the mailbox sends on its own

Vai se cadastrar ou entrar em algum lugar com o endereço da caixa de e-mail? Envie o formulário e chame wait_for_code: ele espera até 30 segundos pelo e-mail e retorna o código de uso único ou o link de verificação.

Para e-mails que precisam de resposta, filtre por category: "personal". As outras são updates, newsletters e promotions.

Depois de conectar, peça em palavras simples:

read · search_messagesO que chegou em support@ hoje e ainda precisa de resposta?
draft · draft_replyEscreva rascunhos de resposta para as perguntas sobre pedidos sem resposta, para eu conferir.
read · wait_for_codeCadastre-se na Acme com bookings@ e conclua a verificação por e-mail.
draft · move_messagesMova as newsletters desta semana da caixa de entrada para Archive.
reply · send_email · wait_forPeça orçamento a três fornecedores para 40 cadeiras e me diga o mais barato quando responderem.

Esperando uma resposta? Logo depois de send_email ou send_reply, chame wait_for com o thread_id da conversa: ele devolve a resposta assim que ela chega, até 30 segundos por chamada, para o seu agente não ficar listando a caixa de entrada sem parar.

Cada mensagem chega com seus dados: datas, valores, códigos de rastreio, um convite e se alguém está perguntando algo. Muitas vezes isso basta para agir sem ler o e-mail inteiro.

Agentes que rodam como servidores podem ser acordados por um webhook message.received; ele traz os mesmos dados.

05

Agentes sem uma pessoa para entrar

Servidores e scripts podem pular o OAuth e enviar uma chave de API como bearer token. Crie uma no painel em API keys, com os escopos de que o agente precisa, ou deixe o agente se cadastrar sozinho e receber uma chave com a própria caixa de entrada:

Cabeçalho
Authorization: Bearer msb_live_…
  • messages:read para ler, drafts:write para redigir, replies:send para responder.
  • messages:write para organizar: marcar como lido e mover mensagens.
06

O que continua seguro

  • Respostas, e e-mails novos que uma pessoa aprova. Uma resposta vai para quem escreveu, na mesma conversa, uma por mensagem. Um e-mail novo sai do seu próprio domínio para no máximo 10 pessoas e espera uma pessoa aprovar, a menos que a caixa esteja configurada para enviar sozinha.
  • Mesmas verificações, mesmas aprovações. Cada resposta é verificada contra vazamentos e instruções plantadas no e-mail. As arriscadas esperam por uma pessoa, seja qual for o agente que as escreveu.
  • E-mail de fora continua de fora. As mensagens chegam ao agente marcadas como não confiáveis, com os resultados da verificação. E-mails em quarentena nunca são mostrados.
  • Cada chamada fica registrada. Cada chamada de ferramenta é registrada com o agente, a caixa de e-mail e o resultado. As conexões são limitadas a 120 requisições por minuto, além dos limites diários de cada caixa de e-mail.

Mais sobre como mantemos o e-mail desejado: Segurança.

07

Desconectar

Os proprietários veem todos os agentes conectados em Connect agent e podem desconectá-los na hora.