Apps de IA (MCP)
Autenticación
Inicia sesión con OAuth y elige los permisos, o usa una API key. En cualquier caso, la app solo obtiene lo que permitas, y puedes retirarlo cuando quieras.
- OAuth 2.1 + PKCE
- Acceso de 1 hora, renovado por la app
- Revoca en Connected apps
Cuál usar
OAuth
RecomendadoPara Claude (claude.ai y escritorio) y cualquier cliente que lo admita. Inicias sesión, eliges los permisos y haces clic en Authorize. Ninguna key que copiar o guardar.
API key
DesarrolladoresPara Claude Code, Cursor, VS Code y scripts. Envía la key como Authorization: Bearer. Los scopes de la key deciden qué tools aparecen.
OAuth
Tu app hace todo esto por su cuenta. Tú solo ves la ventana de Sendcorex.
- 1
La app llama al servidor sin token y recibe 401 con un enlace a los metadatos de autorización de Sendcorex.
- 2
La app se registra (dynamic client registration) y abre una ventana de Sendcorex.
- 3
Inicias sesión en el dashboard si hace falta, eliges los permisos (o el buzón) y haces clic en Authorize.
- 4
La app recibe un access token (1 hora) y un refresh token (30 días, renovado con cada uso) y empieza a llamar a las tools.
Los miembros de una organización solo pueden conceder los permisos que ellos mismos tienen.
Permisos
En la pantalla Authorize, cada área es No access, Read o Full. Los mismos scopes funcionan en las API keys. La gestión de la cuenta, la facturación, el equipo y las API keys nunca está disponible para las apps de IA.
| Área | Lectura | Full añade |
|---|---|---|
| Dominios | domain:read | domain:create, domain:delete |
| Remitentes | sender:read | sender:create, sender:update, sender:delete |
| Plantillas | template:read | template:create, template:update, template:delete |
| Contactos | contact:read | contact:create, contact:update, contact:delete |
| Logs | logs:read | — |
| Bounces y quejas | feedback:read | — |
| Contadores | counters:read | — |
| Preferencias de tracking | privacy:read | privacy:write |
| Validación de email | — | tools:validate |
| Envío de email | — | email:send |
API key
Crea una key en el dashboard solo con los scopes que necesita la app y envíala en cada solicitud.
POST https://g.sendcorex.com/mcp/account
Authorization: Bearer SENDCOREX_API_KEY
Content-Type: application/json- La lista de tools sigue a la key. Una key solo con
logs:readsolo ve las tools de logs. - Las IP permitidas siguen aplicando. Las apps en la nube llaman desde sus propios servidores, así que una key limitada a tus IP será rechazada allí. Usa OAuth para esas.
Acceso al buzón
El servidor del buzón trabaja con un buzón a la vez. Con OAuth eliges el buzón en la pantalla Authorize (la búsqueda ayuda cuando tienes muchos). Desde código, el token del buzón de la API de Recepción de Emails también funciona. Las API keys generales nunca abren un buzón.
Acceso de solo lectura
Al conectar un buzón, eliges Acceso total o Solo lectura. Solo lectura es el valor por defecto para apps y la opción más segura para asistentes de IA que solo necesitan leer tu correo.
Un token creado como Solo lectura, o una app autorizada como Solo lectura, solo puede leer el buzón.
Cualquier comando de escritura responde READ_ONLY_ACCESS (HTTP 403 en la subida de adjuntos).
En el MCP, las tools de escritura no aparecen: la app solo ve las tools que puede 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_unsubscribedRevocar acceso
Connected apps, en el dashboard, lista todas las apps que autorizaste, a qué pueden acceder y cuándo se usaron por última vez. Revoca y la app pierde el acceso en menos de un minuto. Para volver a usarla, conéctala y autorízala otra vez.
Abrir Connected apps