Skip to main content

​
Descripción general

Nudgen aloja un servidor MCP en el endpoint /mcp del origen de tu aplicación. Usa MCP 2026-07-28 mediante Streamable HTTP y requiere OAuth 2.1. Conecta un cliente compatible con ese transporte. Inicia sesión en Nudgen desde el navegador, elige un workspace y aprueba los permisos que solicita el cliente. La conexión permanece vinculada a ese workspace, aunque más adelante cambies de workspace en el panel.

​
Por qué esto es importante

Tu asistente puede consultar contactos y campañas, encontrar negocios cercanos, preparar contenido y dejar una campaña lista para lanzarla sin gestionar una sesión del panel ni un token de acceso personal. Tú revisas cada envío real o programación en el navegador antes de que pueda continuar.

​
Conectar tu cliente

El endpoint de producción es:
Añádelo como servidor MCP HTTP remoto en un cliente compatible con OAuth. El cliente descubre el servidor de autorización de Nudgen desde el endpoint y abre un flujo de inicio de sesión y consentimiento en el navegador. Selecciona el workspace al que quieres que acceda el cliente y aprueba únicamente los scopes que necesita. Documentos de descubrimiento: 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:
Si ya hay configurado un cliente llamado nudgen, actualiza esa entrada con la URL /mcp. Si solo necesitas consultar datos, solicita campaigns:read. Añade campaigns:write cuando el cliente deba modificar contactos, borradores, la configuración de marca o leads importados. Añade campaigns:send solo cuando el cliente necesite solicitar la aprobación de un lanzamiento.
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

  1. Pide al asistente que llame a search_map_leads con una ubicación y palabras clave del negocio, como una ciudad y marketing agency.
  2. Los filtros opcionales son radiusKm (1–100), lat, lng y emailOnly para conservar los negocios que publican un correo electrónico.
  3. Cuando el resultado incluya nextPageToken, pásalo como pageToken para cargar otra página.
  4. Pide al asistente que llame a import_map_leads con 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.
La importación crea contactos en el workspace conectado. Se omiten los leads sin correo electrónico. Si un lead ya existe, se actualiza.

​
Aprobar el lanzamiento de una campaña

  1. Pide al asistente que consulte el borrador con get_campaign.
  2. Pídele que llame a prepare_campaign_launch con el ID de la campaña y la hora exacta de envío inmediato o programado que quieras. La llamada devuelve una URL de aprobación de un solo uso; todavía no se envía ningún correo.
  3. Abre la URL, revisa el workspace, la estimación de destinatarios, el contenido, el remitente y la hora y, después, haz clic en Aprobar lanzamiento.
  4. Vuelve al cliente para que pueda llamar a launch_campaign con el mismo ID de campaña, la misma hora y el mismo approvalId.
Una aprobación caduca a los 10 minutos y solo puede usarse una vez. Si cambia la campaña o el remitente, solicita una nueva aprobación. Nudgen vuelve a comprobar la disponibilidad del remitente, los destinatarios aptos, la suscripción, la cuota y la disponibilidad de la cola al realizar el lanzamiento. La entrega solo empieza después de que el worker de campañas procese el lanzamiento.
Aprobar y completar launch_campaign puede enviar correos reales. Usa el flujo de envío de prueba del panel para comprobar una vista previa en la bandeja de entrada antes de aprobar una audiencia real.

​
Gestionar el acceso

Abre Configuración → Claves API → Aplicaciones MCP conectadas para ver el workspace y los scopes de cada cliente conectado. Revoca allí una conexión si ya no debe tener acceso. La revocación desactiva sus tokens y las aprobaciones de lanzamiento pendientes. Puedes volver a conectarla mediante OAuth más adelante. Las concesiones de OAuth duran como máximo 90 días. Perder el acceso a un workspace también impide que el cliente use la conexión de ese workspace.

​
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 entero radiusKm 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

Usa update_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: completa los pagos, la autorización de proveedores, el envío de invitaciones, el cambio de espacio de trabajo y los datos confidenciales de cobro en el navegador. La conexión MCP sigue vinculada al espacio autorizado. 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 de la API. Para pruebas de envío, activación lifetime o eventos lifetime, solicita primero aprobación en el navegador con prepare_campaign_action. Después usa send_test_email, activate_lifetime_campaign o trigger_lifetime_campaign con los mismos argumentos. La aprobación vence en diez minutos y solo se usa una vez.