MCP 서버

MailInApp은 MCP 서버를 제공하여 외부 AI 클라이언트 — Claude Desktop, Claude Code, 또는 다른 어떤 MCP 호환 도구든 — 가 스튜디오 내 AI 코파일럿과 동일한 방식으로 계정의 이메일 프로젝트를 직접 만들고 편집할 수 있게 합니다. 어느 쪽이든 동일한 도구 사용 코어를 공유합니다: MCP 클라이언트와 스튜디오 패널은 동일한 편집 집합으로 향하는 서로 다른 두 개의 창구일 뿐입니다.

이 페이지는 개발자 경로를 다룹니다: 직접 발급한 API 키로 인증하는 여러분 자신의 백엔드나 CLI 도구를 말하며, 발송 API가 사용하는 것과 동일한 자격 증명입니다.

엔드포인트 & 인증

https://mailinapp.com/api/mcp

발송 API와 동일한 Authorization: Bearer <apiKey> 헤더로 인증합니다 — 대시보드의 개발자에서 키를 새로 발급하거나 기존 키를 재사용하세요. 이 경로에는 별도로 관리해야 할 MCP 전용 자격 증명이 없습니다. 키는 이미 "이 계정 자신의 백엔드"를 나타내므로 여기서도 동일한 수준으로 신뢰되며, 아래 문서화된 모든 도구는 스코프와 무관하게 이용할 수 있습니다.

엔드포인트는 상태 비저장(stateless)입니다: 모든 요청은 그 자체로 완결된 MCP 호출이므로, 메시지 사이에 살아 있게 유지할 것이 없고 MCP 클라이언트의 일반적인 설정 절차 외에 별도의 연결/연결 해제 단계도 없습니다.

Claude Code 연결하기

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

원격 HTTP 서버를 지원하는 Claude Desktop 및 다른 MCP 클라이언트도 동일한 URL과 헤더를 사용합니다 — 어디에 붙여넣어야 하는지는 각 클라이언트 자체의 문서를 확인하세요.

도구

API 키는 완전한 계정 소유자 수준으로 신뢰되므로, 이용 가능한 모든 도구를 볼 수 있습니다 — 프로젝트 디자인, 연락처와 억제 목록, 캠페인 결과와 주문, (테스트뿐 아니라 실제 캠페인 발송을 포함한) 발송, 메일박스와 티켓 답변, 요금제 사용량입니다.

트리 편집 도구(add_block/update_block/remove_block/move_block/set_theme 등)는 모두 앞에 projectId(list_projects/create_project에서 얻음)를 받습니다 — MCP 클라이언트에는 이를 추론할 열려 있는 스튜디오 탭이 없기 때문입니다. 유효한 모든 블록 타입, 그 허용 부모, 필드 목록은 list_block_types를 통해 모델에게 도구 세트의 일부로 설명되므로, 스튜디오가 현재 제공하는 어떤 블록 타입과도 자동으로 보조를 맞춥니다 — 무엇이 사용 가능한지 직접 알려줄 필요가 없습니다.

편집 적용 방식

각 변경 도구 호출은 프로젝트에 대한 그 자체로 원자적인 쓰기입니다 — 열려 있는 캔버스가 없으므로 스튜디오 내 패널이 가지고 있는 것과 같은 "적용" 단계가 없습니다. 스튜디오에서 프로젝트를 열어 둔 상태에서 동시에 MCP 클라이언트가 편집하면, 다음 자동 저장 시점에 마치 팀원이 편집한 것처럼 평소와 같은 "다른 곳에서 변경됨" 충돌 배너가 표시됩니다 — 새로고침해서 MCP가 만든 변경 사항을 반영하거나, 사본으로 저장해서 진행 중이던 편집을 유지하세요.

모든 MCP 편집은 프로젝트의 코파일럿 채팅 스레드에도 기록되며(스튜디오 패널이 아니라 MCP에서 온 것으로 태그됩니다), 그래서 스튜디오 내 AI 코파일럿 패널이 보여주는 것과 같은 기록에 나타납니다.

속도 제한 & 요금제 제공 범위

API 키당: 분당 60회 요청이며, 같은 계정의 다른 키와는 무관하게 적용됩니다.
계정당: 모든 도구 호출은 하나의 월간 카운터(plan.connectorCallsMonthly)에서 차감되며, 이는 스튜디오 내 AI 코파일럿 자체의 턴 허용량과는 별개입니다. MCP 호출은 MailInApp 자체적으로 AI 모델을 호출하지 않기 때문입니다. Free를 포함한 모든 요금제에서 실질적인 할당량과 함께 제공됩니다 — 정확한 수치는 요금제를 참고하거나, get_plan_usage를 호출해 계정의 이번 달 현재까지의 사용량을 확인하세요.
이 경로를 통한 실제 캠페인 발송은 confirm_send와 동일한 방식으로, 동일한 확인 절차와 발송량 상한을 적용받아 계측됩니다.