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

Recomendado

Para 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

Desarrolladores

Para 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. 1

    La app llama al servidor sin token y recibe 401 con un enlace a los metadatos de autorización de Sendcorex.

  2. 2

    La app se registra (dynamic client registration) y abre una ventana de Sendcorex.

  3. 3

    Inicias sesión en el dashboard si hace falta, eliges los permisos (o el buzón) y haces clic en Authorize.

  4. 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.

ÁreaLecturaFull añade
Dominiosdomain:readdomain:create, domain:delete
Remitentessender:readsender:create, sender:update, sender:delete
Plantillastemplate:readtemplate:create, template:update, template:delete
Contactoscontact:readcontact:create, contact:update, contact:delete
Logslogs:read—
Bounces y quejasfeedback:read—
Contadorescounters:read—
Preferencias de trackingprivacy:readprivacy: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.

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:read solo 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.
Abrir API Keys

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_unsubscribed

Revocar 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