desarrollador

adbtd por MCP

Añade adbtd como servidor Model Context Protocol en Claude Code, Claude Desktop, Cursor o cualquier agente compatible con MCP. Tu agente puede listar buzones, enviar correo y leer métricas de entregabilidad — sin que tengas que envolver la API REST a mano.

Una sola URL de servidor: https://mcp.adbtd.com. Autorización por OAuth, revocable desde tu panel en cualquier momento.

paso 1

Añade el servidor

Una línea en la configuración MCP de tu agente — mira abajo según el cliente.

paso 2

Autoriza en el navegador

En la primera conexión se te enviará a adbtd para aprobarla. Creamos automáticamente una clave API en tu cuenta con el nombre del agente adjunto.

paso 3

Usa las herramientas

Tu agente ya puede llamar a list_mailboxes, send_email, get_deliverability y más.

Instalación

Claude Code

Desde tu terminal:

claude mcp add --transport http adbtd https://mcp.adbtd.com

El flag --transport http es obligatorio — sin él Claude Code asume un servidor local por stdio y no consigue conectar.

En el primer uso, Claude Code abre tu navegador para completar el flujo OAuth. Aprueba en tu panel de adbtd y la conexión queda lista.

Si antes ejecutaste el comando sin el flag, elimina primero la entrada rota: claude mcp remove adbtd.

Claude Desktop

Claude Desktop ejecuta los servidores MCP en local. Usa el puente mcp-remote para que pueda hablar con un servidor HTTP remoto como el nuestro. Edita tu configuración (~/Library/Application Support/Claude/claude_desktop_config.json en macOS; %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "adbtd": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adbtd.com"]
    }
  }
}

Reinicia Claude Desktop. La primera conversación que toque el servidor abrirá tu navegador para el flujo OAuth.

Cursor

En ~/.cursor/mcp.json (o el equivalente por proyecto):

{
  "mcpServers": {
    "adbtd": {
      "url": "https://mcp.adbtd.com"
    }
  }
}

Otros agentes compatibles con MCP

Cualquier agente que soporte MCP sobre Streamable HTTP puede usar https://mcp.adbtd.com. El servidor habla OAuth 2.1 con Dynamic Client Registration — tu agente descubrirá el servidor de autorización a partir de los metadatos estándar en /.well-known/oauth-protected-resource.

Los agentes que no hablan MCP remoto de forma nativa pueden usar el puente mcp-remote mostrado arriba para Claude Desktop.

Herramientas

Todas las herramientas están limitadas al espacio de trabajo — el token OAuth de tu agente lo vincula a un único espacio de trabajo de adbtd. El acceso entre espacios de trabajo es imposible por construcción. El conjunto replica uno a uno la API REST de cliente — todo lo que puedes hacer vía /api/v1/* lo puedes hacer vía MCP.

herramienta	qué hace
get_me	Información del espacio de trabajo + estado de la suscripción — equivale a GET /v1/me.
list_mailboxes	Lista buzones, opcionalmente filtrados por dominio o estado.
get_mailbox	Obtiene un buzón por id.
create_mailbox	Aprovisiona un buzón en un dominio verificado. Devuelve los datos SMTP/IMAP listos para usar.
delete_mailbox	Elimina definitivamente un buzón por id. Irreversible — el maildir en disco se borra.
send_email	Envía correo a través de uno de tus buzones vía envío SMTP.
list_messages	Obtiene los mensajes recientes de un buzón por IMAP. Paginado.
get_message	Obtiene el cuerpo completo + adjuntos de un mensaje por UID IMAP.
list_domains	Lista los dominios de tu espacio de trabajo con su estado SPF/DKIM/DMARC.
add_domain	Añade un dominio (propio) a tu espacio de trabajo. Los registros DNS a publicar se devuelven en list_domains.
delete_domain	Elimina un dominio y todos sus buzones. Irreversible.
list_ips	Lista las IPs dedicadas y sus listados en RBL.
add_ips	Pide N IPs dedicadas adicionales. Puede devolver una URL de pago de Stripe si se requiere acción.
release_ip	Libera una IP dedicada de vuelta al pool. Liberar la última IP cancela la suscripción.
get_deliverability	Volumen enviado en 7d, puntuación de spam promedio, principales símbolos, estado RBL — los mismos datos que /dashboard/deliverability.

Autorización

Aprovisionamiento automático. Nunca pegas una clave API. La primera vez que tu agente se conecta, tu navegador abre adbtd.com/oauth/authorize — apruebas, y creamos una clave en tu cuenta.
Visible en tu panel. Cada conexión aparece en /dashboard/api-keys bajo "conexiones MCP" con el nombre que el propio agente declara (p. ej. "Claude Code").
Revocable en cualquier momento. "Desconectar" cambia un flag — la siguiente llamada MCP de ese agente devuelve 401. Sin reinicio, sin retraso de propagación.
Limitado al espacio de trabajo. El token se vincula a un único espacio de trabajo. Un agente nunca puede ver, listar ni actuar sobre datos de otro espacio de trabajo, ni aunque lo intente.
Basado en estándares. OAuth 2.1 + Dynamic Client Registration + PKCE (solo S256). Consulta /.well-known/oauth-authorization-server.
Trata el token de acceso como una contraseña. Vive en la configuración local de tu agente — nunca lo pegues en ventanas de chat, gestores de incidencias ni scripts públicos. Si se filtra, desconéctalo desde el panel y vuelve a autorizar.

Precios

MCP no tiene precio aparte. La suscripción por buzón + por IP que ya tiene tu espacio de trabajo cubre el uso de MCP igual que cubre el acceso por API REST e IMAP/SMTP — consulta precios.