Descripción general
Nudgen aloja un servidor MCP en/mcp del origen de tu aplicación. Admite MCP 2026-07-28 mediante Streamable HTTP y requiere OAuth 2.1. Inicia sesión en el navegador y aprueba los permisos solicitados. Cuando esté disponible, elige un espacio de trabajo o autoriza explícitamente todos los espacios actuales y futuros a los que pertenezcas. Cambiar de espacio en el panel no cambia el predeterminado de MCP.
Trabaja con varios espacios
Las conexiones existentes siguen limitadas a su espacio original hasta que vuelvas a conectarlas y apruebes un acceso más amplio. Con acceso a todos los espacios, las nuevas membresías están disponibles automáticamente. Perder la membresía bloquea las siguientes acciones en ese espacio. Los roles, suscripciones y cuotas se aplican por separado en cada espacio. Usalist_workspaces con page y pageSize para consultar identificadores, nombres, slugs, roles y el espacio predeterminado. Requiere teams:read. Añade workspaceId a una llamada para elegir otro espacio solo para esa acción. Si lo omites, se usa el predeterminado de la conexión. Al revisar y enviar una campaña, pasa el mismo identificador explícito.
Elige el espacio predeterminado durante el consentimiento OAuth. Cámbialo en Configuración → Claves API → Aplicaciones MCP conectadas o llama a set_default_workspace con workspaceId y el permiso teams:write. El cambio afecta a todos los chats que usan esa conexión. Una selección para una sola llamada no cambia el predeterminado. Si se elimina el espacio o pierdes acceso, indica otro identificador o actualiza el predeterminado. Nudgen nunca elige un sustituto sin avisar.
Por qué esto es importante
Tu asistente puede consultar contactos, buscar empresas y crear borradores de campañas. Autoriza el envío o la programación en el chat; el asistente ejecuta la acción directamente sin enlaces de aprobación en el navegador.Conectar tu cliente
El endpoint de producción es:
El servidor de autorización usa el flujo de código de autorización con PKCE S256, vinculación de recursos y rotación de tokens de actualización. Admite documentos de metadatos de ID de cliente y el registro dinámico de clientes.
Para Codex CLI, usa:
nudgen, actualiza esa entrada con la URL /mcp.
Usa
campaigns:read para consultar, campaigns:write para borradores y cambios, y campaigns:send para acciones de correo autorizadas. El consentimiento OAuth sigue siendo necesario.
Los tokens de acceso personal autentican la API de desarrollador, pero no autentican
/mcp. Un cliente MCP debe completar el inicio de sesión mediante OAuth.Herramientas disponibles
create_campaign guarda una campaña como borrador (one-time, drip o lifetime). No puede enviarla ni programarla directamente. get_campaign te permite comprobar el asunto, el contenido, el enlace, la audiencia y el remitente antes del lanzamiento.
El servidor también expone recursos de solo lectura mediante campaigns:read:
Buscar e importar leads del mapa
- Pide al asistente que llame a
search_map_leadscon una ubicación y palabras clave del negocio, como una ciudad ymarketing agency. - Los filtros opcionales son
radiusKm(1–100),lat,lngyemailOnlypara conservar los negocios que publican un correo electrónico. - Cuando el resultado incluya
nextPageToken, pásalo comopageTokenpara cargar otra página. - Pide al asistente que llame a
import_map_leadscon la misma ubicación y las mismas palabras clave, además de los objetos de leads que quieres guardar. Cada llamada admite hasta 200 leads.
Lanzar una campaña en borrador
- Revisa nombre, asunto, contenido, remitente efectivo, estimación de destinatarios y horario con
get_campaign. - Autoriza la acción en el chat. El asistente llama directamente a
launch_campaigncon el ID ysendNow: truepara enviar ahora oscheduledAtcon una fecha futura y zona horaria. No combines horarios contradictorios. Una autorización existente no requiere otra confirmación. - Revisa el estado, la hora programada y el enlace al dashboard. En cola o programado no significa entregado. Consulta
get_campaignyget_campaign_statsantes de reintentar un resultado incierto.
Gestionar el acceso
Abre Configuración → Claves API → Aplicaciones MCP conectadas para revisar el acceso, cambiar el predeterminado o desconectar. Desconectar una conexión de varios espacios revoca sus tokens y códigos de autorización pendientes en todos los espacios sin desconectar conexiones REST independientes. OAuth REST y el asistente integrado conservan sus límites actuales.Solución de problemas
Para scripts que usen tokens bearer y endpoints REST directos, consulta la API de desarrollador.
Radio de búsqueda y enriquecimiento
API y MCP usan 5 km por defecto y aceptan un enteroradiusKm de 1 a 100, sin diálogo de confirmación. Mantén los parámetros al pasar nextPageToken como pageToken. Una página vacía puede tener una página siguiente.
enrichmentPending indica investigación del sitio pendiente. Revisa businessSummary y businessSources cuando estén disponibles. El contexto importado puede apoyar introducciones personalizadas. Un correo ausente puede seguir pendiente de investigación.
Si recibes enrichmentRetryToken, llama a retry_map_leads_enrichment con token y campaigns:read. El token está vinculado al workspace conectado, caduca en 15 minutos y se usa una vez. Combina los resultados por placeId antes de importar. emailOnly filtra la respuesta actual; pueden aparecer leads después del reintento.
Editar borradores y cobertura
Usaupdate_campaign para editar un borrador existente y delete_campaign para eliminarlo. Ambos requieren campaigns:write; ninguno envía ni programa correos. Las nuevas áreas del producto requieren permisos OAuth propios. Vuelve a conectarte y aprueba esos permisos cuando se soliciten.
La lista de herramientas muestra las herramientas disponibles y sus argumentos. Los enlaces al navegador no ejecutan acciones. Usa el navegador para pagos, autorización de proveedores, invitaciones, creación/eliminación/ingreso a espacios y datos confidenciales de cobro. Seleccionar un espacio o cambiar el predeterminado por MCP no cambia el espacio del panel. Se excluyen la administración, las credenciales, los webhooks, los callbacks de seguimiento y el asistente interno.
Usa get_api_capabilities para consultar la cobertura. Tras autorizar en el chat, llama directamente a send_test_email, activate_lifetime_campaign o trigger_lifetime_campaign. Las pruebas solo se envían al correo de la cuenta. Activar lifetime permite futuros envíos automáticos. No se requiere aprobación del navegador ni ID de aprobación. Ante un resultado incierto, revisa el estado o historial antes de reintentar.