mailinapp
Documentation menu

Servidor MCP

MailInApp expone un servidor MCP para que un cliente de IA externo — Claude Desktop, Claude Code, o cualquier otra herramienta compatible con MCP — pueda construir y editar los proyectos de correo de tu cuenta directamente, de la misma forma en que lo hace el copiloto de IA dentro del estudio. Es el mismo núcleo de uso de herramientas en ambos casos: un cliente MCP y el panel del estudio son solo dos puertas de entrada distintas al mismo conjunto de ediciones.

Esta página cubre la vía para desarrolladores: tu propio backend o herramientas de CLI autenticándose con una clave de API que tú mismo generas, la misma credencial que usa la API de envío.

Endpoint y autenticación

https://mailinapp.com/api/mcp

Autentícate con el mismo encabezado Authorization: Bearer <apiKey> que la API de envío — genera o reutiliza una clave desde Desarrolladores en el panel. No hay una credencial específica de MCP separada que gestionar para esta vía; una clave ya representa "el propio backend de esta cuenta", así que se le confía al mismo nivel aquí, con cada herramienta documentada abajo disponible sin importar el alcance.

El endpoint no guarda estado: cada solicitud es una llamada MCP autocontenida, así que no hay nada que mantener activo entre mensajes ni un paso separado de conectar/desconectar más allá de la configuración normal de tu cliente MCP.

Conectar Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

Claude Desktop y otros clientes MCP compatibles con un servidor HTTP remoto usan la misma URL y el mismo encabezado — consulta la propia documentación de tu cliente para saber dónde pegarlos.

Herramientas

Una clave de API tiene el nivel de confianza completo de propietario de cuenta, así que ve cada herramienta disponible — diseño de proyectos, contactos y supresiones, resultados de campaña y pedidos, envío (incluyendo envíos de campaña reales, no solo pruebas), respuestas de buzón de correo y tickets, y uso del plan.

Las herramientas de edición de árbol (add_block/update_block/remove_block/move_block/set_theme, y similares) reciben todas un projectId inicial (de list_projects/create_project) — un cliente MCP no tiene una pestaña de estudio abierta de la cual inferirlo. Cada tipo de bloque válido, sus padres aceptados, y su lista de campos se describen al modelo como parte del conjunto de herramientas mediante list_block_types, así que se mantiene sincronizado con cualquier tipo de bloque que el estudio ofrezca actualmente; no necesitas indicarle qué está disponible.

Cómo se aplican las ediciones

Cada llamada de herramienta que modifica algo es su propia escritura atómica directamente al proyecto — no hay un paso de "aplicar" como el que tiene el panel dentro del estudio, ya que no hay un lienzo abierto al cual aplicar. Si tienes el proyecto abierto en el estudio al mismo tiempo que un cliente MCP lo edita, tu próximo guardado automático muestra el aviso normal de conflicto "Cambiado en otro lugar", exactamente como si un compañero de equipo lo hubiera editado — recarga para obtener el cambio hecho por MCP, o guarda como copia para conservar tus propias ediciones en curso.

Cada edición de MCP también se registra en el hilo de chat del copiloto del proyecto (etiquetada como proveniente de MCP, no del panel del estudio), así que aparece en el mismo historial que muestra el panel del Copiloto de IA dentro del estudio.

Límites de tasa y disponibilidad por plan

  • Por clave de API: 60 solicitudes/minuto, independiente de otras claves de la misma cuenta.
  • Por cuenta: cada llamada de herramienta consume de un contador mensual (plan.connectorCallsMonthly, separado de la propia asignación de turnos del copiloto de IA dentro del estudio, ya que una llamada MCP nunca invoca un modelo de IA del propio lado de MailInApp). Disponible con una cuota real en todos los planes, incluido Free — mira precios para los números exactos, o llama a get_plan_usage para leer el uso del mes en curso de tu cuenta.
  • Enviar campañas reales a través de esta vía se mide de la misma forma que confirm_send, con el mismo flujo de confirmación y tope de volumen.