mailinapp
Documentation menu

AI 커넥터

Claude나 Gemini를 MailInApp 계정에 연결하면 채팅만으로 인터랙티브 이메일을 디자인하고 발송하고 결과를 확인할 수 있습니다 — "상품 출시 이메일 만들어줘", "지난주 설문에 누가 응답했어?", "화요일 뉴스레터를 활성 구독자 리스트로 보내줘" 같은 식으로요. 어시스턴트는 스튜디오 내 AI 코파일럿을 구동하는 것과 동일한 도구 사용 코어를 통해 실제 프로젝트를 편집하고 실제 데이터를 읽습니다. 커넥터는 그저 스튜디오 자체의 사이드 패널 대신, AI 플랫폼이 사용자를 대신해 쥐고 있는 그 코어로 통하는 두 번째 관문일 뿐입니다.

어디서나 하나의 URL

https://mailinapp.com/api/mcp

모든 플랫폼이 바로 이 URL로 연결됩니다 — Streamable HTTP 기반의 원격 MCP 서버입니다. 붙여넣기 전에 따로 설정할 것은 없습니다. 클라이언트가 연결되는 순간 서버가 인증 방식(사용자의 명시적 동의를 거치는 OAuth 2.1)을 알려주고, 나머지는 플랫폼이 처리합니다. 플랫폼별 절차는 Claude와 Gemini 문서에 있습니다.

연결하면 일어나는 일

  1. Claude나 Gemini 자체의 커넥터 설정에 위 URL을 붙여넣습니다.
  2. 플랫폼이 사용자로 로그인된 상태로 브라우저에서 MailInApp의 동의 화면을 엽니다.
  3. 둘 이상의 회사(자신의 계정과, 활성 멤버로 속한 모든 팀)에 속해 있다면 이 연결이 어느 계정으로 동작할지 선택합니다 — 하나의 연결은 항상 정확히 하나의 계정으로만 범위가 지정됩니다.
  4. 어떤 권한("스코프")을 부여할지 선택합니다 — 자세한 내용은 스코프 및 권한을 참고하세요. 읽기 전용 권한은 모두 기본으로 체크되어 있지만, 메일 발송 권한은 체크되어 있지 않습니다.
  5. 승인하면 이제 어시스턴트가 해당 계정을 대신해 MailInApp의 도구를 호출할 수 있습니다.

이 절차를 완료하기 전까지는 아무것도 공유되지 않습니다 — 연결한다고 해서 비밀번호나 API 키가 넘어가는 것이 아니라, 플랫폼에 범위가 제한되고 언제든 취소할 수 있는 토큰이 전달될 뿐입니다.

할 수 있는 일

  • 디자인 — 프로젝트의 블록 트리와 테마를 읽고 편집하고, 44개 블록 카탈로그를 둘러보고, 저장된 템플릿이나 커뮤니티 템플릿을 적용하고, 실시간 미리보기를 렌더링합니다.
  • 결과 확인 — 캠페인 오픈/클릭/응답/매출, 폼 질문별 집계, 주문, 발송 이력, 반복 발송 일정, 요금제 사용량.
  • 수신자 관리 — 연락처 리스트 조회, 연락처 검색·추가·수정, 수신 거부 목록 관리.
  • 답장 — 메일함 스레드와 지원 티켓에 답장하며, 두 경우 모두 수신자가 작성한 신뢰할 수 없는 콘텐츠로 격리 처리됩니다(보안 참고).
  • 발송 — prepare_send → confirm_send로 이어지는 2단계 절차로, 실제 발송 전에 항상 수신자 수와 렌더링된 미리보기를 보여줍니다. 전체 목록은 도구 레퍼런스를, 발송이 정확히 어떻게 제한되는지는 보안을 참고하세요.

의도적으로 할 수 없는 일

어떤 도구도 Stripe/결제에 관여하지 않고(차지백 환불은 대시보드에서만 가능), API 키를 발급하지 않고, 웹훅 시크릿을 재발급하지 않고, SMTP/결제/도메인 설정을 변경하지 않으며, 팀 초대도 관리하지 않습니다 — editor 팀원이 다른 모든 곳에서 이미 차단당하는 것과 동일한 예외 항목입니다. campaigns:send는 기본적으로 절대 부여되지 않으며, 부여되더라도 발송에는 여전히 위의 2단계 확인 절차가 필요합니다.

요금제별 이용 가능 여부

커넥터는 Free를 포함한 모든 요금제에서 이용할 수 있습니다 — 프로젝트와 결과를 읽고 새로 만드는 데는 이미 책정된 것 외에 추가 비용이 들지 않습니다. 계량되는 것은 월별 도구 호출 횟수(Free는 200회, 요금제가 올라갈수록 증가)와, 별도로 커넥터가 한 달에 발송할 수 있는 수신자 수(Free는 0 — 발송하려면 최소 Starter 이상이 필요)입니다. 정확한 수치는 요금제 페이지를, 이번 달 누적 사용량은 대시보드의 Connections를 참고하세요.

연결 관리

대시보드의 Connections(/dashboard/connections)에는 승인한 모든 어시스턴트가 나열됩니다 — 클라이언트 이름, 부여된 스코프, 마지막 호출 시각까지 표시되며, 클릭 한 번으로 Revoke할 수 있습니다. 취소는 즉시 적용됩니다. 해당 어시스턴트가 보유한 모든 토큰은 만료를 기다릴 필요 없이 다음 호출부터 곧바로 작동을 멈춥니다.