anon.li

Crear, editar y eliminar alias de correo electrónico y gestionar archivos cifrados compartidos con anon.li MCP.

Ver en anon.li

Documentación

Documentation Menu

Servidor MCP

Conecta agentes de IA (Claude, Cursor, MCP Inspector) a anon.li con OAuth y gestiona alias, destinatarios y drops.

El servidor de Protocolo de Contexto de Modelo (MCP) de anon.li permite a los agentes de IA leer y modificar tus alias, destinatarios y drops a través de un transporte MCP estándar. Utiliza OAuth 2.1 con PKCE, por lo que nunca pegas una clave de API en una herramienta de terceros — el agente se conecta, tú lo apruebas desde un inicio de sesión normal de anon.li, y recibe un token de portador de corta duración limitado a tu cuenta.

Endpoint

Código

https://anon.li/api/mcp

El transporte es HTTP Streamable. El servidor habla las revisiones de protocolo 2025-03-26, 2025-06-18 y 2025-11-25 (respuestas JSON, sin sesión), así como 2026-07-28.

Añadir el servidor a Claude

En Claude Desktop o Claude en la web:

  1. Abre Configuración → Conectores → Añadir conector personalizado.
  2. Establece la URL a https://anon.li/api/mcp.
  3. Claude abre una pestaña del navegador — inicia sesión en anon.li (y completa la 2FA si la tienes habilitada) y aprueba la pantalla de consentimiento.
  4. Una vez conectado, pregunta a Claude cosas como "lista mis alias de anon.li" o "crea un alias personalizado newsletters@anon.li y reenvíalo a mi destinatario predeterminado."

El mismo flujo funciona para cualquier cliente compatible con MCP. Con el Inspector MCP:

Código

npx @modelcontextprotocol/inspector https://anon.li/api/mcp

Descubrimiento

anon.li publica metadatos de descubrimiento bien conocidos en la raíz, para que los clientes MCP puedan encontrar el transporte y la configuración de OAuth sin configuración manual:

DocumentoRutaTarjeta de Servidor MCP (borrador SEP-1649)/.well-known/mcp/server-card.jsonRFC 8414 — Metadatos del Servidor de Autorización/.well-known/oauth-authorization-serverRFC 9728 — Metadatos del Recurso Protegido OAuth/.well-known/oauth-protected-resource/api/mcp (también en /.well-known/oauth-protected-resource)

Datos clave que un cliente leerá:

  • Emisor: https://anon.li
  • Endpoints: /api/auth/oauth2/authorize, /api/auth/oauth2/token, /api/auth/oauth2/revoke; claves de firma en /api/auth/jwks
  • Tipos de concesión: authorization_code, refresh_token
  • PKCE: obligatorio, solo S256
  • Registro de cliente: Documentos de Metadatos de ID de Cliente (un client_id HTTPS), o RFC 7591 registro dinámico en /api/auth/oauth2/register. Las URI de redirección deben ser HTTPS, o http://localhost / 127.0.0.1 / [::1] para clientes nativos.
  • Indicador de recurso: los tokens están vinculados a https://anon.li/api/mcp (RFC 8707); los clientes que omiten el recurso lo reciben completado.
  • Tokens de acceso: JWTs firmados de 1 hora
  • Tokens de actualización: 14 días, rotados en cada uso (una actualización reintentada dentro de 30 segundos recibe la misma respuesta)
  • Consentimiento: cada autorización muestra la pantalla de consentimiento de anon.li; la 2FA debe completarse primero si está habilitada en la cuenta. Las aplicaciones concedidas se listan, y pueden revocarse, en Configuración → Aplicaciones conectadas

Herramientas

El servidor expone doce herramientas. Las llamadas a herramientas de alias, drop y formulario cuentan contra la misma cuota mensual de API que la API REST para tu nivel (consulta Precios para los límites de nivel). Las herramientas de destinatario (list_recipients, add_recipient) no consumen cuota mensual; solo están limitadas por tasa.

Las herramientas toggle_* toman el estado objetivo (active para alias, disabled para drops y formularios) y lo establecen, reflejando la semántica PATCH de REST — repetir una llamada es seguro y nunca invierte el estado. Los resultados de las listas se ordenan primero los más recientes con un desempate estable, por lo que paginar con offset nunca repite ni omite un elemento.

Alias

HerramientaQué hacelist_aliasesLista los alias de la cuenta, primero los más recientes, 50 por página (límite hasta 100, offset para paginar). Devuelve el total más id, email, active, contadores forwarded/blocked y marcas de tiempo. Las etiquetas y notas cifradas se omiten intencionalmente — están cifradas en la bóveda del lado del cliente y son ilegibles para un cliente de terceros.create_aliasCrea un alias. Pasa local_part para una dirección personalizada (el formato se establece en "custom" cuando se proporciona); omítelo — o pasa format: "random" — para autogenerar la parte local. local_part con format: "random" se rechaza. Los recipient_ids o recipient_email opcionales (no ambos) eligen el destino de reenvío — por defecto tu destinatario principal. Las etiquetas/notas no se pueden establecer aquí; edítalas desde la interfaz web después de la creación.toggle_aliasEstablece el estado de un alias: active: true reenvía el correo, active: false lo descarta silenciosamente. Acepta un ID de alias o la dirección de correo completa. Marcado como destructivo (deshabilitar descarta el correo entrante) e idempotente. Reactivar un alias que un administrador retiró falla con FORBIDDEN.delete_aliasElimina permanentemente un alias. El correo futuro a esa dirección se rechaza.

Destinatarios

HerramientaQué hacelist_recipientsLista tus buzones de destinatarios (las direcciones a las que los alias pueden reenviar). Incluye las banderas verified e is_default.add_recipientAñade un nuevo correo de destinatario. El destinatario debe hacer clic en el enlace de verificación antes de que cualquier alias pueda reenviarle.

Drops

HerramientaQué hacelist_dropsLista los drops de archivos solo con metadatos — tamaño, caducidad, descargas, descargas máximas, estado deshabilitado/retirado. Los nombres de archivo y contenidos están cifrados de extremo a extremo y no se pueden devolver a través de esta API.toggle_dropEstablece el estado de un drop: disabled: true rechaza todas las descargas, disabled: false restaura el acceso.delete_dropElimina permanentemente un drop y recupera su cuota de almacenamiento.

toggle_drop y delete_drop actúan solo sobre la lista independiente de drops que devuelve list_drops. Los adjuntos de formularios se gestionan con su formulario (delete_form los elimina), y un drop ya eliminado desaparece — ambos devuelven NOT_FOUND.

Formularios

HerramientaQué hacelist_formsLista tus formularios solo con metadatos — título, contadores de envíos, envíos máximos, fecha de cierre, estado activo/deshabilitado/retirado. Los contenidos de los envíos están cifrados de extremo a extremo y no se pueden devolver a través de esta API.toggle_formEstablece el estado de un formulario: disabled: true rechaza todos los nuevos envíos, disabled: false los acepta de nuevo. El resultado refleja disabled_by_user de list_forms.delete_formElimina permanentemente un formulario junto con todos sus envíos y cualquier drop de archivos adjuntos.

Ámbitos

Las herramientas están controladas por ámbitos de OAuth. El token que recibe tu cliente lleva una cadena de ámbito separada por espacios; llamar a una herramienta sin su ámbito se rechaza con un desafío de escalado HTTP 403 (consulta Ámbitos faltantes). Solicitar ningún ámbito concede todos ellos.

ÁmbitoConcedeanon.li:aliasesTodas las herramientas *_alias más list_recipients / add_recipient.anon.li:dropsTodas las herramientas *_drop.anon.li:formsTodas las herramientas *_form.offline_accessTokens de actualización (mantente conectado sin volver a consentir).

Lo que la IA no puede ver

Esto es por diseño. anon.li es un servicio de conocimiento cero para las partes que importan:

  • Las etiquetas y notas de alias están cifradas con una clave derivada de tu contraseña de bóveda. Solo tu navegador (o CLI con tu clave envuelta de bóveda) puede leer o escribirlas.
  • Los contenidos y nombres de archivo de los drops se cifran del lado del cliente antes de la subida. La clave de cifrado de un drop nunca sale de tu dispositivo — es parte del fragmento de URL de compartición.
  • Las subidas de drops no se exponen a través de MCP por la misma razón: una IA remota no tiene tus claves de bóveda.

Por lo tanto, el servidor MCP permite a un agente gestionar el plano de control (qué alias existen, qué destinatarios están verificados, qué drops siguen vivos) sin tocar nunca el plano de contenido.

Errores

Una llamada a herramienta fallida se devuelve como un resultado de herramienta MCP normal con isError: true — no como un error de protocolo JSON-RPC. Esto incluye argumentos inválidos, que devuelven VALIDATION_ERROR con una lista de issues. Los detalles estructurados están disponibles en dos lugares:

  • _meta["anon.li/error"] — { code, message, ... } legible por máquina para clientes que ramifican según los datos de error.
  • El bloque de contenido de texto — el mensaje, seguido de un bloque JSON con el código y cualquier campo adicional. Esto es lo que la mayoría de los bucles de agentes muestran al modelo.

Código

{
"isError": true,
"content": [
{
"type": "text",
"text": "Monthly API quota exceeded\n\n{\n \"code\": \"QUOTA_EXCEEDED\",\n ..."
}
],
"_meta": {
"anon.li/error": {
"code": "QUOTA_EXCEEDED",
"message": "Monthly API quota exceeded",
"quota_type": "alias",
"limit": 500,
"remaining": 0,
"reset_at": "2026-05-01T00:00:00.000Z"
}
}
}

Los códigos de error reflejan los de la API REST, por lo que una tabla de errores cubre ambos:

CódigoSignificadoCampos adicionalesQUOTA_EXCEEDEDCuota mensual de API agotada para el cubo de esta herramienta.quota_type (alias / drop / form), limit, remaining, reset_atRATE_LIMITEDSe alcanzó el límite de tasa por herramienta — reintenta después de reset_at.reset_atINSUFFICIENT_SCOPEEl token carece del ámbito que esta herramienta necesita. Reconéctate y apruébalo. Normalmente se responde en la capa HTTP (ver abajo); esto es el respaldo.required_scope, granted_scopesUPGRADE_REQUIREDSe alcanzó un límite del plan (p. ej., número de alias, número de destinatarios).upgrade (scope, currentTier, suggestedTier, ...)VALIDATION_ERRORLos argumentos fallaron el esquema de entrada de la herramienta (o el servicio rechazó la entrada).issues (path, message) para fallos de esquemaACCOUNT_BANNEDLa cuenta está suspendida.BAN_ALIAS_CREATIONLa creación de alias está deshabilitada para esta cuenta (create_alias).NOT_FOUND, FORBIDDEN, CONFLICTLa solicitud en sí fue rechazada (ID desconocido, rol de organización insuficiente o retirada de administrador, duplicado).INVALID_TOKEN, ACCOUNT_NOT_ACTIVEEl token no tiene sujeto, o la cuenta ya no existe.INTERNAL_ERRORError inesperado del servidor. La llamada no se reintentó — verifica su efecto antes de repetirla.

Ámbitos faltantes (escalado)

Llamar a una herramienta cuyo ámbito el token no tiene se rechaza antes de que la herramienta se ejecute con HTTP 403 y un desafío de escalado, tanto en el transporte MCP 2026-07-28 como en los transportes de la era 2025:

Código

WWW-Authenticate: Bearer error="insufficient_scope",
scope="anon.li:aliases offline_access anon.li:drops",
resource_metadata="https://anon.li/.well-known/oauth-protected-resource/api/mcp"

scope lista los ámbitos que el token ya tiene más el faltante, por lo que un cliente que reautoriza con él mantiene su acceso existente. tools/list sigue listando todas las herramientas, cualesquiera que sean los ámbitos del token.

Cuota y límites de tasa

El uso de MCP comparte el contador mensual por nivel con el uso de REST y CLI (por cubo: las herramientas de alias usan la cuota de alias, las de drop la cuota de drop, las de formulario la cuota de formulario). Las herramientas de destinatario no se miden contra la cuota mensual.

Las comprobaciones se ejecutan en este orden: ámbito, límite de tasa por herramienta, validación de argumentos, comprobaciones de baneo y luego la cuota mensual. Una llamada rechazada por cualquier comprobación anterior — incluida una con argumentos inválidos — no se carga contra la cuota mensual.

También se aplican límites de tasa por herramienta, compartiendo cubos con los endpoints REST correspondientes:

HerramientasLímitecreate_alias60 por horalist_aliases, toggle_alias, delete_alias, list_recipients100 por minutoadd_recipient60 por horalist_drops, list_forms60 por minutotoggle_drop, delete_drop, toggle_form, delete_form100 por hora

Seguridad de la cuenta

  • Consciente de 2FA. Si tu cuenta requiere 2FA, el paso de autorización de OAuth redirige a través de ella antes de la pantalla de consentimiento.
  • Consciente de baneos. Una cuenta suspendida recibe ACCOUNT_BANNED de todas las herramientas, y una cuenta con la creación de alias deshabilitada (p. ej., por infracciones de abuso) recibe BAN_ALIAS_CREATION de create_alias, en lugar de fallar silenciosamente.
  • Revocación. Para cortar el acceso de una aplicación desde el lado de anon.li, abre Configuración → Aplicaciones conectadas y elige Revocar. Sus tokens de consentimiento y actualización se eliminan, y cualquier token de acceso que aún tenga se rechaza en la siguiente solicitud. Reconectarse más tarde muestra la pantalla de consentimiento de nuevo. Eliminar un conector dentro de Claude (u otro cliente MCP) no revoca necesariamente su concesión con anon.li, por lo que usa Aplicaciones conectadas para estar seguro.

¿Necesitas ayuda?

En esta página