개요
Nudgen은 앱 출처의/mcp 엔드포인트에서 MCP 서버를 호스팅합니다. 이 서버는 Streamable HTTP를 통해 MCP 2026-07-28을 사용하며 OAuth 2.1이 필요합니다. 해당 전송 방식을 지원하는 클라이언트를 연결하세요. 브라우저에서 Nudgen에 로그인하고 워크스페이스를 선택한 다음 클라이언트가 요청하는 권한을 승인하세요. 이후 대시보드에서 워크스페이스를 전환하더라도 연결은 선택한 워크스페이스에 계속 귀속됩니다.
이것이 중요한 이유
어시스턴트는 대시보드 세션이나 개인 액세스 토큰을 다루지 않고도 연락처와 캠페인을 읽고, 주변 비즈니스를 찾고, 콘텐츠 초안을 만들며, 캠페인 시작을 준비할 수 있습니다. 실제 발송이나 예약은 진행되기 전에 매번 브라우저에서 검토합니다.클라이언트 연결
프로덕션 엔드포인트는 다음과 같습니다.
인증 서버는 PKCE S256, 리소스 바인딩, 새로 고침 토큰 순환이 포함된 인증 코드 방식을 사용합니다. Client ID Metadata Documents와 동적 클라이언트 등록을 지원합니다.
Codex CLI에서는 다음 명령을 사용하세요.
nudgen이라는 클라이언트가 이미 구성되어 있다면 해당 항목을 /mcp URL로 업데이트하세요.
데이터 조회만 필요하다면
campaigns:read를 요청하세요. 클라이언트가 연락처, 초안, 브랜드 설정 또는 가져온 리드를 변경해야 한다면 campaigns:write를 추가하세요. 클라이언트가 시작 승인을 요청해야 하는 경우에만 campaigns:send를 추가하세요.
개인 액세스 토큰은 개발자 API를 인증하지만
/mcp 인증에는 사용할 수 없습니다. MCP 클라이언트는 OAuth 로그인을 완료해야 합니다.사용 가능한 도구
create_campaign은 일회성 캠페인 초안을 저장합니다. 직접 발송하거나 예약할 수 없습니다. get_campaign을 사용하면 시작 전에 제목, 콘텐츠, 링크, 오디언스, 발신자를 확인할 수 있습니다.
서버는 campaigns:read에서 읽기 전용 리소스도 제공합니다.
지도 리드 찾기 및 가져오기
- 어시스턴트에게 도시와
marketing agency같은 비즈니스 키워드 등 위치와 비즈니스 키워드를 사용해search_map_leads를 호출하도록 요청하세요. - 선택적 필터로는
radiusKm(1~100),lat,lng, 이메일을 공개한 비즈니스만 유지하는emailOnly가 있습니다. - 결과에
nextPageToken이 포함되면 이를pageToken으로 전달해 다음 페이지를 불러오세요. - 어시스턴트에게 동일한 위치와 키워드, 저장할 리드 객체를 사용해
import_map_leads를 호출하도록 요청하세요. 호출당 최대 200개의 리드를 받을 수 있습니다.
캠페인 시작 승인
- 어시스턴트에게
get_campaign으로 초안을 조회하도록 요청하세요. - 캠페인 ID와 원하는 정확한 즉시 발송 또는 예약 시간을 사용해
prepare_campaign_launch를 호출하도록 요청하세요. 일회용 승인 URL이 반환되며 아직 이메일은 발송되지 않습니다. - URL을 열어 워크스페이스, 예상 수신자 수, 콘텐츠, 발신자, 발송 시점을 검토한 다음 시작 승인을 클릭하세요.
- 클라이언트로 돌아가 동일한 캠페인 ID, 발송 시점,
approvalId를 사용해launch_campaign을 호출하도록 하세요.
액세스 관리
설정 → API 키 → 연결된 MCP 앱을 열어 각 연결된 클라이언트의 워크스페이스와 범위를 확인하세요. 더 이상 액세스할 필요가 없는 연결은 여기에서 취소하세요. 연결을 취소하면 해당 토큰과 대기 중인 시작 승인이 비활성화됩니다. 나중에 OAuth를 통해 다시 연결할 수 있습니다. OAuth 권한 부여는 최대 90일간 유지됩니다. 워크스페이스에 대한 액세스 권한을 잃으면 클라이언트도 해당 워크스페이스의 연결을 사용할 수 없습니다.문제 해결
전달자 토큰과 직접 REST 엔드포인트를 사용하는 스크립트에 대해서는 개발자 API를 참조하세요.