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
RecomendadoPara 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
DesenvolvedoresPara 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
O app chama o servidor sem token e recebe 401 com um link para os metadados de autorização da Sendcorex.
- 2
O app se registra (dynamic client registration) e abre uma janela da Sendcorex.
- 3
Você faz login no dashboard se precisar, escolhe as permissões (ou a caixa de email) e clica em Authorize.
- 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.
| Área | Leitura | Full adiciona |
|---|---|---|
| Domínios | domain:read | domain:create, domain:delete |
| Remetentes | sender:read | sender:create, sender:update, sender:delete |
| Templates | template:read | template:create, template:update, template:delete |
| Contatos | contact:read | contact:create, contact:update, contact:delete |
| Logs | logs:read | — |
| Bounces e reclamações | feedback:read | — |
| Contadores | counters:read | — |
| Preferências de tracking | privacy:read | privacy: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.
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:readvê 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.
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_unsubscribedRevogar 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