Documentation menu

Claude 연결하기

단계

  1. Claude에서 Settings → Connectors → Add custom connector로 이동합니다.
  2. https://mailinapp.com/api/mcp를 원격 MCP 서버 URL로 붙여넣습니다.
  3. Claude가 브라우저에서 MailInApp의 OAuth 동의 화면을 엽니다. 필요하면 로그인하고, 둘 이상의 계정에 속해 있다면 어느 계정으로 동작할지 선택한 뒤, 스코프를 고르고 승인합니다.
  4. Claude가 자동으로 다시 연결되고 다음 채팅부터 도구가 표시됩니다.

MailInApp 대시보드의 Connections(/dashboard/connections)에서도 동일한 단계를 진행할 수 있습니다 — URL을 복사해 붙여넣을 수 있는 버튼과, 플랫폼별로 동일한 3단계 설명이 제공됩니다.

Claude Desktop: 붙여넣기 대신 설치

데스크톱 앱을 사용한다면 URL을 직접 입력할 필요가 없습니다 — 대신 Settings → Extensions에서 .mcpb 데스크톱 확장을 설치하세요. 위 단계와 정확히 동일한 원격 MCP 서버와 OAuth 동의 화면을 가리키며, 유일한 차이는 사용자가 URL을 Connectors에 붙여넣는 대신 Claude Desktop이 연결과 재실행을 대신 처리해준다는 점뿐입니다. 첫 도구 호출 시 여전히 브라우저가 열려 동의 화면을 승인하고 스코프를 선택해야 하며, 어느 방식으로 연결했든 대시보드의 Connections에서 취소하면 여전히 즉시 적용됩니다.

동의 화면에서 보게 될 내용

읽기 전용 스코프와 연락처/템플릿 관리 스코프는 모두 기본으로 체크되어 있습니다. campaigns:send(Claude가 실제로 연락처에 메일을 발송할 수 있게 하는 권한)는 기본값이 꺼짐이며 별도의 경고 색상으로 표시됩니다 — 채팅이 실제 발송을 트리거할 수 있길 원한다면 명시적으로 체크하세요. 각 스코프가 정확히 무엇을 허용하는지는 스코프 및 권한을 참고하세요.

Claude 안의 위젯

Claude는 MCP Apps를 지원하므로, 세 가지 도구는 텍스트 블록 대신 대화 안에 바로 인터랙티브 카드를 렌더링합니다. preview_email/편집 도구는 제작 중인 이메일의 데스크톱/모바일 실시간 미리보기를 보여주고, get_campaign_results는 결과 대시보드를 보여주며, prepare_send는 정확한 수신자 수와 미리보기, 그리고 자체 Confirm & Send 버튼이 있는 카드를 보여줍니다 — 즉 발송 승인은 Claude가 사용자를 대신해 마음대로 처리할 수 있는 것이 아니라 그 카드를 클릭하는 행위입니다.

연결이 작동하지 않을 때

  • **"Couldn't reach the MCP server"**가 처음 연결 시 뜨는 것은 대부분 일시적인 문제입니다 — 한 번 다시 시도해보세요. 계속되면 대시보드의 Connections에서 같은 클라이언트로부터의 오래된 연결이 남아 있어 먼저 취소해야 하는 건 아닌지 확인하세요.
  • 도구 호출이 권한 오류로 실패한다 — 필요한 스코프가 부여되지 않은 것입니다. 대시보드에서 연결을 취소하고 다시 연결하면서 이번에는 동의 화면에서 해당 스코프를 선택하세요.
  • 팀을 옮겼거나, 팀원이 접근 권한을 취소했다 — 커넥터 토큰은 호출할 때마다 사용자의 실시간 계정 멤버십을 기준으로 재검증되므로, 회사에 대한 접근 권한을 잃으면(예: 팀 오너가 사용자를 제거) Claude 쪽에서 아무것도 하지 않아도 해당 연결의 호출이 즉시 비활성화됩니다.

취소하기

대시보드의 Connections에는 Claude를 포함해 승인한 모든 어시스턴트가 나열되며, 클릭 한 번으로 Revoke할 수 있습니다 — Claude 내부에서 무엇을 하든 상관없이 즉시 적용됩니다.