Apps de IA (MCP)

Autenticação

Faça login com OAuth e escolha as permissões, ou use uma API key. De qualquer forma, o app só recebe o que você permitir, e você pode revogar quando quiser.

  • OAuth 2.1 + PKCE
  • Acesso de 1 hora, renovado pelo app
  • Revogue em Connected apps

Qual usar

OAuth

Recomendado

Para o Claude (claude.ai e desktop) e qualquer cliente que suporte. Você faz login, escolhe as permissões e clica em Authorize. Nenhuma key para copiar ou guardar.

API key

Desenvolvedores

Para Claude Code, Cursor, VS Code e scripts. Envie a key como Authorization: Bearer. Os scopes da key definem quais tools aparecem.

OAuth

Seu app faz tudo isso sozinho. Você só vê a janela da Sendcorex.

  1. 1

    O app chama o servidor sem token e recebe 401 com um link para os metadados de autorização da Sendcorex.

  2. 2

    O app se registra (dynamic client registration) e abre uma janela da Sendcorex.

  3. 3

    Você faz login no dashboard se precisar, escolhe as permissões (ou a caixa de email) e clica em Authorize.

  4. 4

    O app recebe um access token (1 hora) e um refresh token (30 dias, renovado a cada uso) e começa a chamar as tools.

Membros de uma organização só podem conceder as permissões que eles mesmos têm.

Permissões

Na tela Authorize, cada área fica como No access, Read ou Full. Os mesmos scopes funcionam nas API keys. Gerenciamento de conta, cobrança, equipe e API keys nunca fica disponível para apps de IA.

ÁreaLeituraFull adiciona
Domíniosdomain:readdomain:create, domain:delete
Remetentessender:readsender:create, sender:update, sender:delete
Templatestemplate:readtemplate:create, template:update, template:delete
Contatoscontact:readcontact:create, contact:update, contact:delete
Logslogs:read—
Bounces e reclamaçõesfeedback:read—
Contadorescounters:read—
Preferências de trackingprivacy:readprivacy:write
Validação de email—tools:validate
Envio de email—email:send

API key

Crie uma key no dashboard só com os scopes de que o app precisa e envie em toda requisição.

Requisição
POST https://g.sendcorex.com/mcp/account
Authorization: Bearer SENDCOREX_API_KEY
Content-Type: application/json
  • A lista de tools segue a key. Uma key só com logs:read vê só as tools de logs.
  • IPs permitidos continuam valendo. Apps na nuvem chamam a partir dos próprios servidores, então uma key travada nos seus IPs será recusada lá. Use OAuth nesses casos.
Abrir API Keys

Acesso à caixa de email

O servidor da caixa de email trabalha com uma caixa por vez. Com OAuth, você escolhe a caixa na tela Authorize (a busca ajuda quando você tem muitas). No código, o token da caixa de email da API de Recebimento de Emails também funciona. API keys gerais nunca abrem uma caixa de email.

Acesso somente leitura

Ao conectar uma caixa, você escolhe Acesso total ou Somente leitura. Somente leitura é o padrão para apps e a escolha mais segura para assistentes de IA que só precisam ler seus e-mails.

Um token criado como Somente leitura, ou um app autorizado como Somente leitura, só consegue ler a caixa.

Qualquer comando de escrita responde READ_ONLY_ACCESS (HTTP 403 no upload de anexo).

No MCP, as tools de escrita não aparecem: o app só vê as tools que pode usar.

Comandos permitidos

whoamilist_foldersget_counterslist_threadsget_threadlist_messagesget_messagessearchget_attachmentget_raw_sourcelist_draftsget_draftget_trackinglist_activityactivity_countslist_contactscount_contactsget_mailbox_contactlist_segmentsget_audiencecheck_recipientsget_delivery_statusget_contact_eventsget_trustlist_trustlist_junkblocked_junk_countlist_top_sendersget_filter_modelist_signaturesget_conversationlist_assigneeslist_conversationslist_conversation_noteslist_rulesget_rulerule_optionstest_rulelist_templatesget_templatelist_labelsget_contactlist_followupsget_unsubscribe_optionslist_unsubscribed

Revogar acesso

Connected apps, no dashboard, lista todos os apps que você autorizou, o que cada um pode acessar e quando foi usado pela última vez. Revogue e o app perde o acesso em até um minuto. Para usar de novo, conecte e autorize mais uma vez.

Abrir Connected apps