개요
Nudgen은 앱 출처의/mcp에서 MCP 서버를 제공합니다. Streamable HTTP를 통한 MCP 2026-07-28을 지원하며 OAuth 2.1이 필요합니다. 브라우저에서 로그인하고 필요한 권한을 승인하세요. 기능이 활성화되면 워크스페이스 하나 또는 현재와 향후 가입하는 모든 워크스페이스의 접근을 명시적으로 허용할 수 있습니다. 대시보드 전환은 MCP 기본값을 바꾸지 않습니다.
여러 워크스페이스 사용하기
기존 연결은 다시 연결하여 더 넓은 접근 범위를 승인할 때까지 원래 워크스페이스로 제한됩니다. 모든 워크스페이스 접근을 허용하면 새로 가입한 곳도 자동으로 사용할 수 있습니다. 멤버 자격을 잃으면 해당 워크스페이스의 이후 작업은 차단됩니다. 역할, 구독, 할당량은 워크스페이스별로 적용됩니다.list_workspaces에 page와 pageSize를 전달하면 ID, 이름, slug, 역할, 기본 상태를 확인할 수 있습니다. teams:read가 필요합니다. 워크스페이스 도구 호출에 workspaceId를 추가하면 해당 작업에만 대상을 지정합니다. 생략하면 연결 기본값을 사용합니다. 캠페인을 검토하고 보낼 때는 동일한 워크스페이스 ID를 명시하세요.
OAuth 동의 시 기본 워크스페이스를 선택하세요. 설정 → API 키 → 연결된 MCP 앱 또는 workspaceId와 teams:write 권한을 사용하는 set_default_workspace로 변경할 수 있습니다. 변경 사항은 해당 연결을 사용하는 모든 채팅에 적용됩니다. 개별 호출의 대상 지정은 기본값을 바꾸지 않습니다. 기본 워크스페이스가 삭제되거나 접근할 수 없게 되면 다른 ID를 지정하거나 기본값을 수정하세요. Nudgen은 대체 대상을 임의로 선택하지 않습니다.
이것이 중요한 이유
어시스턴트는 연락처 확인, 업체 검색, 캠페인 초안 작성을 할 수 있습니다. 채팅에서 발송이나 예약을 허용하면 브라우저 승인 링크 없이 직접 실행합니다.클라이언트 연결
프로덕션 엔드포인트는 다음과 같습니다.
인증 서버는 PKCE S256, 리소스 바인딩, 새로 고침 토큰 순환이 포함된 인증 코드 방식을 사용합니다. Client ID Metadata Documents와 동적 클라이언트 등록을 지원합니다.
Codex CLI에서는 다음 명령을 사용하세요.
nudgen이라는 클라이언트가 이미 구성되어 있다면 해당 항목을 /mcp URL로 업데이트하세요.
조회는
campaigns:read, 초안과 수정은 campaigns:write, 허용한 이메일 작업은 campaigns:send를 사용하세요. 연결 시 OAuth 동의는 계속 필요합니다.
개인 액세스 토큰은 개발자 API를 인증하지만
/mcp 인증에는 사용할 수 없습니다. MCP 클라이언트는 OAuth 로그인을 완료해야 합니다.사용 가능한 도구
create_campaign은 **캠페인 초안 (one-time, drip, lifetime)**을 저장합니다. 직접 발송하거나 예약할 수 없습니다. get_campaign을 사용하면 시작 전에 제목, 콘텐츠, 링크, 오디언스, 발신자를 확인할 수 있습니다.
서버는 campaigns:read에서 읽기 전용 리소스도 제공합니다.
지도 리드 찾기 및 가져오기
- 어시스턴트에게 도시와
marketing agency같은 비즈니스 키워드 등 위치와 비즈니스 키워드를 사용해search_map_leads를 호출하도록 요청하세요. - 선택적 필터로는
radiusKm(1~100),lat,lng, 이메일을 공개한 비즈니스만 유지하는emailOnly가 있습니다. - 결과에
nextPageToken이 포함되면 이를pageToken으로 전달해 다음 페이지를 불러오세요. - 어시스턴트에게 동일한 위치와 키워드, 저장할 리드 객체를 사용해
import_map_leads를 호출하도록 요청하세요. 호출당 최대 200개의 리드를 받을 수 있습니다.
캠페인 초안 시작하기
get_campaign으로 캠페인 이름, 제목, 내용, 실제 발신자, 예상 수신자 수와 발송 시간을 확인하세요.- 채팅에서 작업을 허용하세요. 어시스턴트가 캠페인 ID와 즉시 발송을 위한
sendNow: true또는 시간대가 포함된 미래 시간의scheduledAt을 지정하여launch_campaign을 직접 호출합니다. 서로 모순되는 시간 인수를 지정하지 마세요. 이미 허용한 작업은 다시 확인할 필요가 없습니다. - 반환된 상태, 예약 시간, 대시보드 링크를 확인하세요. 대기열에 있거나 예약된 상태는 전달 완료가 아닙니다. 결과가 불확실하면 재시도 전에
get_campaign과get_campaign_stats를 확인하세요.
액세스 관리
설정 → API 키 → 연결된 MCP 앱에서 접근을 확인하거나 기본값을 바꾸거나 연결을 해제하세요. 여러 워크스페이스 연결을 해제하면 모든 워크스페이스에 대한 해당 연결의 토큰과 대기 중인 인증 코드가 취소됩니다. 별도의 REST 연결에는 영향을 주지 않습니다. REST OAuth와 앱 내 어시스턴트는 기존 워크스페이스 경계를 유지합니다.문제 해결
전달자 토큰과 직접 REST 엔드포인트를 사용하는 스크립트에 대해서는 개발자 API를 참조하세요.
검색 반경 및 정보 보강
API와 MCP의 기본값은 5 km이며 정수radiusKm 1~100을 지원합니다. 대시보드 확인 대화상자는 표시하지 않습니다. nextPageToken을 pageToken으로 전달할 때 같은 검색 조건을 유지하세요. 빈 페이지에도 다음 페이지가 있을 수 있습니다.
enrichmentPending은 완료되지 않은 웹사이트 조사를 나타냅니다. 제공되는 businessSummary와 businessSources를 검토하세요. 가져온 비즈니스 정보는 개인화된 캠페인 소개에 도움이 됩니다. 이메일이 없으면 조사가 진행 중일 수 있습니다.
enrichmentRetryToken이 있으면 campaigns:read 권한으로 retry_map_leads_enrichment에 token을 전달하세요. 토큰은 연결된 워크스페이스 전용이며 15분 후 만료되고 한 번만 사용됩니다. 가져오기 전에 placeId로 결과를 병합하세요. emailOnly는 현재 응답을 필터링하므로 재시도 후 리드가 나타날 수 있습니다.
초안 편집 및 지원 범위
update_campaign으로 기존 초안을 편집하고 delete_campaign으로 초안을 삭제하세요. 두 도구 모두 campaigns:write가 필요하며 이메일을 보내거나 예약하지 않습니다. 새로운 제품 영역에는 별도의 OAuth 권한이 필요합니다. 요청 시 다시 연결하고 해당 권한을 승인하세요.
도구 목록에서 사용 가능한 도구와 인수를 확인할 수 있습니다. 브라우저 안내 자체는 작업을 실행하지 않습니다. 결제, 공급자 인증, 초대, 워크스페이스 생성/삭제/가입, 민감한 지급 설정은 브라우저에서 완료하세요. MCP 대상이나 기본값을 변경해도 대시보드 워크스페이스는 전환되지 않습니다. 관리 기능, 인증 정보, 웹훅, 추적 콜백, 내부 도우미는 제외됩니다.
get_api_capabilities로 API 지원 범위를 확인하세요. 채팅에서 허용한 후 send_test_email, activate_lifetime_campaign, trigger_lifetime_campaign을 직접 호출하세요. 테스트는 계정 이메일로만 발송됩니다. lifetime 활성화는 향후 자동 발송을 허용합니다. 브라우저 승인이나 승인 ID는 필요하지 않습니다. 결과가 불확실하면 재시도 전에 상태나 실행 기록을 확인하세요.