MCP

O servidor MCP da Duobox

Conecte o ChatGPT, o Claude, o Cursor ou outro cliente MCP ao e-mail da sua empresa. Seu agente lê o e-mail, escreve e envia mensagens e administra a equipe, com as permissões que você escolher.

MCPhttps://mcp.duobox.io/v1/mcpOAuth
Cole este endereço no seu cliente MCP e entre com a sua conta. Não tem API key.

1.0  Acesso

Ele entra com a sua conta, não com uma chave

O agente entra por OAuth com a sua conta de e-mail da Duobox: o mesmo endereço e a mesma senha com que você abre o seu inbox.

  • Ao conectar, a Duobox mostra o que ele pede. Vem tudo marcado: tire o que você não quiser.
  • Se uma ferramenta precisa de uma permissão que você tirou, ela é pedida de novo.
  • No e-mail, Agentes → Conexões lista cada app conectado, desde quando e a última vez que entrou. Cortar o acesso deixa ele de fora agora mesmo.
  • Administrar a empresa não substitui o seu papel: se você não administra a empresa, essas ferramentas respondem que não.

Pode

  • Ler seu e-mailVer os e-mails que chegam para você.mail:read
  • Salvar rascunhosDeixá-los prontos, sem enviar.mail:draft
  • Enviar e-mailEnviar pelos seus endereços.mail:send
  • Administrar a empresaO time, o plano e os inboxes.company
Enviar e-mail inclui salvar rascunhos, e salvar rascunhos inclui ler.

Para desenvolvedores

Transporte
HTTP, POST /v1/mcp
Autenticação
OAuth com PKCE. Registro dinâmico de clientes ou Client ID Metadata Documents.
Metadata
https://mcp.duobox.io/.well-known/oauth-protected-resource
Protocolo
A versão de 2026 e também a 2025-11-25.

2.0  Conectar

Conecte onde você já trabalha

Os passos de cada um, com o texto para colar. Quando ele pedir para entrar, use a sua conta de e-mail da Duobox.

  1. 1Abra Personalizar, depois Conectores, e adicione um conector.
  2. 2Cole o endereço. Deixe o acesso ligado para que ele peça a sua conta.
Endereço
https://mcp.duobox.io/v1/mcp
  1. 1Abra Plugins e adicione um servidor MCP.
  2. 2Cole o endereço e escolha OAuth.
Endereço
https://mcp.duobox.io/v1/mcp
  1. 1Abra Ajustes, MCP, e adicione um servidor. Ou cole isto em .cursor/mcp.json.
Arquivo
{
  "mcpServers": {
    "duobox": {
      "url": "https://mcp.duobox.io/v1/mcp"
    }
  }
}
  1. 1Rode isto na pasta do projeto. Fica em .mcp.json.
Terminal
claude mcp add --transport http duobox https://mcp.duobox.io/v1/mcp
  1. 1Na paleta de comandos, MCP: Add Server. Ou cole isto em .vscode/mcp.json.
Arquivo
{
  "servers": {
    "duobox": {
      "type": "http",
      "url": "https://mcp.duobox.io/v1/mcp"
    }
  }
}
  1. 1No Cascade, abra Manage MCPs. Ou cole isto em ~/.codeium/windsurf/mcp_config.json.
Arquivo
{
  "mcpServers": {
    "duobox": {
      "serverUrl": "https://mcp.duobox.io/v1/mcp"
    }
  }
}
  1. 1Rode isto. Fica em ~/.gemini/settings.json.
Terminal
gemini mcp add --transport http duobox https://mcp.duobox.io/v1/mcp
  1. 1Rode isto. Fica em ~/.codex/config.toml.
Terminal
codex mcp add duobox --url https://mcp.duobox.io/v1/mcp
  1. 1Se pedir um endereço, cole o do servidor. Se pedir um arquivo, cole isto. Se pedir o tipo, é http.
Arquivo
{
  "mcpServers": {
    "duobox": {
      "url": "https://mcp.duobox.io/v1/mcp"
    }
  }
}

Os mesmos passos estão no e-mail, em Ajustes → MCP.

3.0  Ferramentas

O que ele pode fazer

35 ferramentas, agrupadas por tarefa. Cada uma diz ao app se só lê, se não dá para desfazer e se envia algo para fora da sua conta, e com isso o app decide quando perguntar para você.

  • list_my_mailboxesSó lêmail:read

    Os inboxes que a sua conta pode abrir.

  • list_messagesSó lêmail:read

    Lista um inbox por pasta, com busca e filtros por alias, data e responsável pela conversa.

  • get_messageSó lêmail:read

    Lê um e-mail inteiro, com a conversa, os anexos e, num compartilhado, quem está com ele.

  • get_folder_countsSó lêmail:read

    Quantos e-mails há em Recebidos, Rascunhos e Spam, e quantas propostas do agente aguardam o seu ok.

  • download_attachmentSó lêmail:read

    Baixa um anexo de até 25 MB, com um link que vence em 10 minutos.

  • save_draftmail:draft

    Salva um rascunho marcado como do agente, sem enviar.

  • send_messageEnvia para foraNão dá para desfazermail:send

    Escreve um e-mail ou uma resposta. Se não pedirem outra coisa, devolve uma prévia e não envia.

  • confirm_messageEnvia para foraNão dá para desfazermail:send

    Envia a prévia exatamente como foi mostrada, depois que você aprovou.

  • mark_messagemail:draft

    Marca como lido ou não lido, para todos que compartilham o inbox.

  • assign_threadmail:draft

    Define o responsável por uma conversa: o agente, uma pessoa do inbox ou ninguém.

  • add_notemail:draft

    Deixa uma nota para a equipe na conversa. O cliente não vê.

  • list_skillsSó lêmail:read

    Os seus skills: instruções que reescrevem o corpo de um e-mail antes de ele sair.

  • create_skillmail:draft

    Cria um skill: o tom, o idioma, o tamanho, o que sempre precisa ser dito.

  • update_skillNão dá para desfazermail:draft

    Edita as instruções de um skill, a descrição ou se ele vale sempre.

  • delete_skillNão dá para desfazermail:draft

    Exclui um skill. O que já saiu com ele não muda.

  • list_aliasesSó lêmail:read

    Os aliases que chegam em um inbox.

  • create_aliasmail:draft

    Adiciona um alias ao inbox, no mesmo domínio. Até cinco.

  • delete_aliasNão dá para desfazermail:draft

    Remove um alias. O inbox continua.

  • get_forwardSó lêmail:read

    As regras de encaminhamento de um inbox e se já estão ativas.

  • set_forwardEnvia para foraNão dá para desfazermail:send

    Encaminha o que chega: tudo, o que vem de um remetente ou o que chega em um endereço. Um endereço de fora fica pendente até confirmar.

  • delete_forwardNão dá para desfazermail:send

    Remove uma regra de encaminhamento.

  • list_organizationsSó lêmail:read

    As empresas da sua conta.

  • list_organization_mailboxesSó lêcompany

    Todos os inboxes da empresa e quem abre cada um.

  • create_mailboxcompany

    Cria um inbox, pessoal ou compartilhado.

  • retry_mailboxcompany

    Tenta de novo um inbox que não pôde ser criado.

  • report_mailboxNão dá para desfazercompany

    Avisa o suporte sobre um inbox que não pôde ser criado.

  • delete_mailboxNão dá para desfazercompany

    Exclui um inbox e os aliases dele.

  • list_membersSó lêcompany

    As pessoas da empresa e o papel de cada uma.

  • list_invitationsSó lêcompany

    Os convites ainda não aceitos.

  • create_invitationEnvia para foraNão dá para desfazercompany

    Convida alguém: a pessoa recebe um e-mail com um link para escolher a senha.

  • resend_invitationEnvia para foraNão dá para desfazercompany

    Envia um convite de novo. O link anterior para de funcionar.

  • delete_invitationNão dá para desfazercompany

    Cancela um convite ainda não aceito.

  • get_meSó lêmail:read

    A sua conta: nome, e-mail e idioma.

  • set_localemail:read

    O idioma dos e-mails que enviamos para você.

  • get_entitlementsSó lêcompany

    Quantas pessoas, domínios e inboxes o plano permite, e quantos estão em uso.

Ele também publica quatro prompts com o passo a passo de cada tarefa —mail, addresses, team e account— e exemplos prontos, como resumir o que não foi lido ou responder um e-mail.

4.0  Enviar

O agente propõe, você envia

send_message não envia: deixa o e-mail como rascunho do agente e devolve ao app a prévia, exatamente como sairia. confirm_message envia sem mexer em nada.

  • Se você pediu para ele não perguntar, send_message com auto envia no mesmo passo.
  • Cada inbox decide se o agente pode enviar sozinho: Enviar sem o seu ok, em Ajustes → MCP. Nos inboxes novos começa desligado, e a proposta espera uma pessoa enviar.
  • O que ele propõe fica em Rascunhos com Aguarda seu ok. O que ele fez, em Agentes → Atividade.

O agente entra com uma conta de e-mail

A conta nasce no hub: você cria a empresa, ativa o e-mail no seu domínio e cria o seu endereço. O agente entra com esse endereço.

Criar conta

Algo não funciona? Escreva para nós