AI 에이전트 연동 (MCP)

MCP란?

MCP(Model Context Protocol)는 AI 에이전트가 외부 서비스의 데이터를 직접 읽고 쓸 수 있게 해주는 표준 규약입니다. 메일리 MCP 서버를 연결하면 Claude, Cursor 같은 AI 에이전트가 화면을 오가며 복사해 붙이지 않고도 뉴스레터 데이터를 직접 다룰 수 있습니다.

예를 들어 “지난 3개월 중 반응이 좋았던 글을 분석하고, 비슷한 톤으로 다음 뉴스레터 초안을 잡아줘”라고 하면 에이전트가 발송 성과를 조회하고 지난 글 본문을 읽은 뒤 초안까지 만들어 둡니다.

할 수 있는 일과 할 수 없는 일

에이전트는 초안까지만 만들 수 있고, 발행과 발송은 할 수 없습니다. 잘못 나간 뉴스레터는 되돌릴 수 없고 발신 도메인 평판까지 떨어뜨리기 때문에, 마지막 발행 버튼은 언제나 사람이 메일리 웹에서 직접 누르도록 설계했습니다.

여기 없는 동작은 에이전트가 아예 시도할 수 없습니다. 도구 목록에 없는 기능은 존재하지 않기 때문입니다.

연결하기

메일리 웹의 설정 > 개발자 도구 > AI 에이전트 (MCP) 화면에서 연결 명령을 복사할 수 있습니다. 토큰이 이미 채워진 상태로 표시되므로 복사 버튼을 눌러 그대로 쓰면 됩니다.

▲ 설정 > 개발자 도구 > AI 에이전트 (MCP)

Claude Code

터미널에 아래 명령을 붙여넣습니다. YOUR_API_TOKEN 자리에는 화면에 표시된 토큰이 들어갑니다.

claude mcp add --transport http maily https://api.maily.so/api/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"

설정 파일에 직접 넣는 경우

Cursor 등 설정 파일로 MCP 서버를 등록하는 도구에서는 아래 형식을 사용합니다.

{
  "mcpServers": {
    "maily": {
      "type": "http",
      "url": "https://api.maily.so/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

연결하면 에이전트가 서버에 있는 기능 목록을 자동으로 읽어 갑니다. 따로 설정할 것은 없습니다.

에이전트가 쓸 수 있는 기능

연결한 에이전트가 쓸 수 있는 기능은 아래 아홉 가지가 전부입니다.

초안 만들기

에이전트가 만든 초안은 초안 상태로만 저장됩니다. 발행일이 잡히지도, 메일이 나가지도 않습니다. 초안을 만들면 편집 화면 링크를 함께 돌려주므로, 그 링크에서 내용을 확인하고 직접 발행하시면 됩니다.

본문은 마크다운으로 주고받습니다. 제목, 굵게·기울임, 링크, 목록(중첩 포함), 인용, 코드 블록, 구분선, 이미지, 표가 메일리 에디터 블록으로 변환되어 저장됩니다.

이미 있는 초안을 고칠 때는 에이전트가 get_post 로 본문을 읽고 고쳐서 update_draft 로 저장합니다. 이때 본문 전체가 교체되므로, 일부만 바꾸더라도 전체 본문을 다시 보내는 방식으로 동작합니다.

임베드·링크 카드가 있는 글

임베드, 링크 카드, 버튼처럼 마크다운으로 표현할 수 없는 블록은 본문에서 [[block:1]] 같은 참조 표시로 바뀝니다. 에이전트는 그 자리에 무엇이 있었는지 따로 전달받습니다.

본문에서는 아래처럼 보입니다.

본문 문단입니다.

[[block:1]]

이어지는 문단.

이 표시를 그대로 두고 저장하면 원래 블록이 그대로 복원됩니다. 반대로 표시를 지우면 그 블록도 함께 사라지니, 삭제할 의도가 아니라면 지우지 않도록 안내해 주세요.

구독자 정보는 어디까지 나가나요?

에이전트가 조회한 내용은 사용자가 쓰는 AI 서비스로 전송됩니다. 그래서 메일리는 구독자 개개인의 이메일과 이름을 아예 제공하지 않습니다. 구독자 관련 기능은 집계 수치만 돌려줍니다.

구독자 명단을 다뤄야 하는 작업은 메일리 웹 화면에서 직접 하시기 바랍니다.

안전장치

한도를 넘으면 잠시 후 다시 시도하라는 안내가 에이전트에게 전달되며, 잠깐 기다리면 자동으로 풀립니다.

자주 묻는 질문

토큰은 개발자 API 토큰과 같은 건가요?

네, 같은 토큰입니다. 두 화면 어느 쪽에서 리셋하더라도 개발자 API 연동과 AI 에이전트 연결이 함께 끊기니 주의해 주세요. 이 토큰은 계정 전체 권한을 가지므로 설정 파일에 넣기 전에 그 파일이 다른 사람과 공유되지 않는지 확인해 주세요. 노출이 의심되면 Authorization 토큰 리셋하기로 재발급하면 이전 토큰은 즉시 무효화됩니다.

여러 뉴스레터를 하나의 에이전트에 연결할 수 있나요?

토큰 하나는 뉴스레터 하나에 대응합니다. 여러 뉴스레터를 다루려면 각각의 토큰으로 MCP 서버를 따로 등록하고, 등록할 때 서로 다른 이름을 지정하시면 됩니다.

에이전트가 실수로 글을 발행하지는 않나요?

발행 기능 자체가 서버에 없습니다. 에이전트가 발행을 시도하더라도 호출할 수 있는 기능이 없어 아무 일도 일어나지 않습니다. 발송 예약, 구독자 삭제, 결제 변경도 마찬가지입니다.

연결한 뒤 무엇부터 시켜보면 좋을까요?

“내 뉴스레터 현황 알려줘”로 시작해 보세요. 구독자 수와 최근 발송 성과를 정리해 줍니다. 이어서 “최근 10편 중 반응이 좋았던 글을 분석해줘”, “그 톤으로 다음 글 초안 잡아줘”로 넘어가면 자연스럽습니다.

응답이 느리거나 한도에 걸렸다고 나옵니다.

짧은 시간에 너무 많이 호출하면 잠시 제한됩니다. 안내 문구에 다시 시도할 수 있는 시각이 함께 나오니 그만큼 기다린 뒤 이어서 요청하시면 됩니다. 구독자가 아주 많은 계정에서 집계 조회가 몇 초 걸릴 수 있습니다.