MCP 사용 방법 — AI 어시스턴트로 문자 읽고 보내기

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 서비스의 기능을 "도구"로 불러 쓰게 해주는 연결 규격입니다. TwoPhone을 MCP로 연결하면 Claude나 ChatGPT에게 말로 부탁하는 것만으로 내 휴대폰의 문자 대화를 확인하고, 요약하고, 답장을 보낼 수 있습니다.

실제 발송과 조회는 로그인된 내 휴대폰에서 이뤄집니다. 문자는 내 번호로, 내 통신사 요금으로 나갑니다. AI가 할 수 있는 일은 문자 발송·예약 발송·발송 결과 확인과, 내가 앱에서 허용한 경우의 문자 대화 조회·읽음 처리, 그리고 별도로 허용한 경우의 연락처 검색(이름·번호 찾기)뿐입니다. 연락처를 고치거나 지우는 것, 통화기록 열람, 계정 설정 변경은 할 수 없습니다.

1. 연결 방법은 두 가지

어디서 AI를 쓰느냐에 따라 필요한 값이 다릅니다. 둘 다 PC 웹 프로필 화면에서 받을 수 있고, 서로 별개의 값이라 하나를 재발급해도 다른 하나는 영향받지 않습니다.

잘 모르겠다면 방법 A부터 시작하세요. 설치할 것이 없습니다.

2. 사전 준비 (공통)

① 구독 확인

MCP는 구독 전용입니다. 휴대폰 TwoPhone 앱의 설정 › 구독에서 구독 중인지 확인하세요. 구독이 없으면 PC 웹 프로필에 "구독 전용입니다"라는 안내만 보이고 URL·키가 나오지 않습니다.

② 휴대폰 앱에서 PC 웹 계정 로그인

AI의 요청은 중개 서버를 거쳐 내 휴대폰으로 전달됩니다. 휴대폰 앱의 설정 › PC 웹에서 계정(이메일)으로 로그인돼 있어야 합니다. 계정이 없다면 같은 화면에서 가입할 수 있습니다. 휴대폰은 인터넷(모바일 데이터나 Wi-Fi)에 연결돼 있어야 합니다.

③ PC 웹 프로필에서 URL·키 받기

1. PC 브라우저에서 twophone.co.kr/app에 같은 계정으로 로그인합니다.
2. 화면 왼쪽 아래의 프로필 버튼(사람 모양 아이콘)을 누릅니다.
3. 처음이라면 발송 API·MCP 이용 고지가 나옵니다. 내용을 읽고 「위 내용을 확인했으며, 발송하는 문자의 법적 책임이 저에게 있음에 동의합니다.」에 체크한 뒤 동의하고 API 키 발급을 누릅니다. (광고성 문자 규제 책임이 발송자에게 있다는 고지입니다.)
4. 프로필 화면에 두 칸이 나타납니다.
   • 발송 API 키 — 방법 B용. tp_로 시작합니다.
   • AI 연동 (MCP) — 방법 A용. https://twophone.co.kr/mcp/… 형태의 전체 주소입니다.
   값은 가려져 있습니다. 보기로 확인하고 복사로 복사하세요. 재발급은 기존 값을 즉시 무효화하니, 유출이 의심될 때만 누르세요.

④ 휴대폰 앱에서 「AI 연동」 스위치 켜기

휴대폰 앱의 설정 › AI 연동으로 들어가면 허용 범위 아래에 스위치 4개가 있습니다. 네 개 모두 처음에는 꺼져 있고, 켜기 전에는 대화 내용도 연락처도 휴대폰 밖으로 한 글자도 나가지 않습니다.

웹 채팅에서 대화를 읽고 답장하는 용도라면 첫 번째 스위치만 켜면 충분합니다. 가운데 두 개는 자동화(웹훅) 시스템을 직접 만드는 경우에 필요하고, 마지막 하나는 "김사장님한테 보내줘"처럼 이름으로 번호를 찾게 하고 싶을 때만 켜면 됩니다. 문자 보내기(send_sms)·예약(schedule_sms)·발송 결과 확인·회선·연결 확인은 스위치와 상관없이 동작합니다.

3. 방법 A — 웹 채팅에서 쓰기

A-1. Claude (claude.ai · Claude 데스크톱 앱)

Anthropic 도움말 기준 커스텀 커넥터는 무료·Pro·Max·Team·Enterprise 요금제에서 쓸 수 있고, 무료 요금제는 커스텀 커넥터를 1개까지만 추가할 수 있습니다. Team·Enterprise는 조직 소유자가 먼저 커넥터를 등록해야 합니다.

1. claude.ai에 로그인하고 사용자 지정 › 커넥터로 들어갑니다 (주소 claude.ai/customize). 예전 메뉴인 설정 › 커넥터로 들어가면 "커넥터가 맞춤 설정으로 이동했습니다"라는 안내만 나오니, 안내 속 맞춤 설정 링크를 누르면 같은 화면으로 옮겨 갑니다.
2. 커넥터 화면 오른쪽 위의 추가 버튼을 누르면 커스텀 커넥터 추가 창이 바로 열립니다.
3. 이름 칸에는 TwoPhone처럼 알아보기 쉽게 적고, MCP 서버 URL 칸에 프로필에서 복사한 AI 연동 URL(https://twophone.co.kr/mcp/…)을 붙여넣습니다. OAuth 관련 칸(클라이언트 ID 등)이 보이더라도 모두 비워 둡니다.
4. 계속을 누릅니다(옆의 취소가 아닙니다). 커넥터 목록의 내 커넥터 탭에 TwoPhone이 보이면 등록 완료입니다.
5. 새 채팅을 열고 입력창 왼쪽 아래 + → 커넥터(Connectors)에서 TwoPhone 스위치가 켜져 있는지 확인합니다.
6. "TwoPhone 휴대폰 연결돼 있는지 확인해줘"라고 보내 봅니다. 휴대폰이 연결돼 있다는 답이 오면 성공입니다.

claude.ai에서 등록한 커넥터는 같은 계정으로 로그인한 Claude 데스크톱 앱에서도 쓸 수 있습니다.

등록한 커넥터를 확인하거나 지울 때는 같은 사용자 지정 › 커넥터 화면에서 내 커넥터 탭을 고르고(탐색 탭은 공개 커넥터 목록입니다), 전체 / 연결됨 / 연결되지 않음 필터로 TwoPhone을 찾으면 됩니다. 위 메뉴 이름은 2026년 9월 한국어 화면 기준이며, Anthropic이 화면을 바꾸면 이름이나 위치가 조금 달라질 수 있습니다.

도구 사용 승인 팝업

Claude가 TwoPhone 도구를 처음 쓰려고 하면 허용할지 묻는 창이 뜹니다. 한 번만 허용하거나 항상 허용할 수 있습니다. 창에는 도구의 한글 이름(「문자 보내기」, 「대화 내용 보기」처럼)이 표시됩니다.

• 조회 도구(list_conversations 「대화 목록」, check_new_messages 「새 메시지 확인」, list_lines 「발신 회선 목록」, check_device 「휴대폰 연결 확인」)는 "항상 허용"해도 무방합니다. 읽음 상태를 바꾸지 않습니다. (「휴대폰 연결 확인」은 휴대폰이 잠들어 있으면 깨우기 알림을 보냅니다. 문자는 보내지 않습니다.)
• get_conversation 「대화 내용 보기」는 "항상 허용"하지 않기를 권합니다. 기본으로는 읽음 상태를 바꾸지 않지만, mark_read: true와 함께 호출하면 그 대화방을 읽음 처리합니다. 승인 창의 ›를 펼쳐 mark_read가 true로 되어 있지 않은지 확인하세요.
• 문자 보내기(send_sms 「문자 보내기」)는 "항상 허용"하지 않기를 권합니다. 승인 창의 ›를 펼쳐 수신 번호(to)와 내용(body)을 매번 눈으로 확인한 뒤 허용하세요. 보낸 문자는 취소할 수 없습니다.

대화 중간의 도구 사용 기록(타임라인)에도 같은 한글 이름이 남습니다. 어떤 도구가 어떤 한글 이름인지는 아래 5항 표에 정리했습니다.

A-2. ChatGPT (웹)

OpenAI 문서 기준 개발자 모드는 Plus·Pro·Business·Enterprise·Education 계정의 웹에서만 쓸 수 있습니다. 무료 계정은 커스텀 연결을 지원하지 않습니다. 워크스페이스(Business 등)는 관리자가 기능을 막아 두었을 수 있습니다. ChatGPT는 최근 커넥터 → 앱 → 플러그인으로 이름을 여러 번 바꿨으니, 아래 메뉴 이름이 조금 달라도 같은 위치를 찾으시면 됩니다.

1. chatgpt.com에서 설정을 열고, 앱(Apps) 또는 보안(Security) 쪽의 고급 설정에서 개발자 모드(Developer mode)를 켭니다. "위험할 수 있다"는 안내가 나오면 읽고 동의합니다.
2. 같은 설정의 앱(플러그인) 화면에서 만들기(Create) 또는 +를 누릅니다. (개발자 모드를 켜야 이 버튼이 나타납니다.)
3. 이름에 TwoPhone, MCP 서버 URL에 프로필에서 복사한 AI 연동 URL을 붙여넣습니다.
4. 인증(Authentication)은 인증 없음(No authentication)을 고릅니다. 개인 토큰이 URL 안에 들어 있어 따로 로그인할 필요가 없습니다.
5. "이 애플리케이션을 신뢰합니다" 같은 확인란에 체크하고 만들기를 누릅니다. 도구 목록에 7개가 보이면 성공입니다.
6. 새 대화에서 입력창의 + → 개발자 모드(Developer mode)를 고르고 TwoPhone을 선택합니다.
7. "TwoPhone 앱으로 휴대폰 연결 상태를 확인해줘"처럼 앱 이름을 넣어 부탁하면 더 정확히 도구를 고릅니다.

ChatGPT는 문자 보내기·읽음 처리처럼 무언가를 바꾸는 도구를 부를 때 기본적으로 확인을 받습니다. 확인 창에 표시되는 입력값(수신 번호·내용)을 꼭 확인하고 승인하세요. 같은 대화 안에서는 승인을 기억하게 할 수 있지만, 새 대화에서는 다시 묻습니다.

Gemini 웹은?

이 글을 쓰는 시점에 구글은 Gemini 앱의 커스텀 MCP 연결을 미국 거주·만 18세 이상·개인 구글 계정·영어 인터페이스로 제한하고 있어, 한국에서는 사실상 연결할 수 없습니다. Gemini를 쓰려면 아래 Gemini CLI를 이용하세요.

4. 방법 B — 프로그램에서 쓰기

아래 예시의 tp_xxxxxxxx는 프로필에서 복사한 발송 API 키로 바꿔 넣으세요. 이 방법에는 AI 연동 URL(개인 토큰)이 아니라 API 키를 씁니다.

Claude Code

터미널에서 한 줄이면 됩니다.

claude mcp add --transport http twophone https://twophone.co.kr/mcp \
  --header "Authorization: Bearer tp_xxxxxxxx"

모든 프로젝트에서 쓰고 싶다면 --scope user를 덧붙이세요(기본값은 현재 폴더에서만 사용). 연결 확인은 Claude Code 안에서 /mcp를 입력해 twophone이 connected로 보이는지 보거나, 터미널에서 claude mcp list를 실행하면 됩니다.

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "twophone": {
      "url": "https://twophone.co.kr/mcp",
      "headers": { "Authorization": "Bearer tp_xxxxxxxx" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json에 추가합니다. 실행 후 /mcp로 연결 상태를 볼 수 있습니다.

{
  "mcpServers": {
    "twophone": {
      "httpUrl": "https://twophone.co.kr/mcp",
      "headers": { "Authorization": "Bearer tp_xxxxxxxx" }
    }
  }
}

Claude 데스크톱 앱

가장 쉬운 방법은 방법 A처럼 커넥터 화면에 AI 연동 URL을 등록하는 것입니다. 설정 파일(claude_desktop_config.json)로 직접 연결하고 싶다면, 이 파일은 로컬 프로그램(stdio) 방식만 받으므로 원격 주소를 이어주는 공개 도구 mcp-remote를 거칩니다(Node.js 18 이상 필요).

{
  "mcpServers": {
    "twophone": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://twophone.co.kr/mcp",
               "--header", "Authorization:${TWOPHONE_AUTH}"],
      "env": { "TWOPHONE_AUTH": "Bearer tp_xxxxxxxx" }
    }
  }
}

mcp-remote는 TwoPhone이 만든 도구가 아닌 오픈소스 프로젝트입니다. 같은 역할을 하는 TwoPhone 전용 연결 도구 (@twophone/mcp)는 공개 준비 중입니다.

n8n · 직접 만든 에이전트

MCP 클라이언트 노드(또는 라이브러리)에서 전송 방식을 Streamable HTTP로, 주소를 https://twophone.co.kr/mcp로, 인증을 헤더 Authorization: Bearer tp_…로 설정하세요. 기술 세부사항(세션, 실시간 알림 스트림)은 API 문서 8항에 있습니다. AI 없이 HTTP로 직접 조회·발송하려면 같은 문서의 발송 API·대화 조회 API를 쓰면 됩니다.

연결됐는지 확인하기

어느 방법이든 연결 후 AI에게 이렇게 물어보세요.

• "TwoPhone 휴대폰 연결 확인해줘" → check_device가 "휴대폰이 연결돼 있습니다"라고 답하면 정상입니다.
• "TwoPhone에서 보낼 수 있는 번호 목록 보여줘" → list_lines가 켜져 있는 회선과 내가 붙인 이름을 알려줍니다.
• "최근 문자 대화 5개 보여줘" → 대화 목록이 나오면 AI 연동 스위치까지 제대로 켜진 것입니다.

5. AI가 쓸 수 있는 도구 13개

도구 이름을 외울 필요는 없습니다. 평소 말투로 부탁하면 AI가 알맞은 도구를 고릅니다. 다만 승인 창과 대화 기록에는 한글 표시 이름(「문자 보내기」 등)만 나오므로, 어느 도구가 어느 이름인지 아래 첫 칸에 나란히 적었습니다.

승인 창에서 「항상 허용」을 눌러도 되는 도구는 조회 전용인 「대화 목록」·「새 메시지 확인」·「발신 회선 목록」·「발송 전 확인」·「발송 결과 확인」·「연락처 검색」·「예약 목록」입니다. 「문자 예약 발송」은 매번 확인하세요 — 취소할 수는 있지만 결국 요금이 나가는 문자입니다. 「문자 보내기」와 「대화 내용 보기」는 매번 확인하기를 권합니다(3항 「도구 사용 승인 팝업」) — 「대화 내용 보기」는 읽음 처리 옵션을 함께 가지고 있어서, 항상 허용으로 두면 확인 없이 읽음 표시가 사라질 수 있습니다. 「휴대폰 연결 확인」은 내용을 읽지는 않지만 꺼져 있는 휴대폰을 깨우므로(푸시) 판단해서 고르세요.

6. 이렇게 말해 보세요

최근 문자 확인

특정 사람과의 대화 요약

답장 보내기 — 발송 전 확인

AI는 보내기 전에 받는 번호와 내용을 먼저 보여주고 확인을 받도록 지시받습니다. 확인 없이 보내려 하면 승인 창에서 거절하세요. 번호는 AI가 추측하지 않도록, 대화 목록에서 찾았거나 내가 직접 알려준 번호만 쓰게 되어 있습니다.

보내도 되는지 먼저 확인

이 확인은 문자를 보내지 않습니다 — 요금도 들지 않고 발송 한도도 쓰지 않습니다. 보내기 전에 마음 편히 물어보세요.

밤에 광고 문자를 보내달라고 했을 때

TwoPhone은 시간대를 이유로 막지 않습니다. "그냥 지금 보내"라고 하면 밤에도 그대로 나가고, 대신 법 규정과 책임 소재를 알리는 안내가 함께 표시됩니다 — 보낼지 말지는 보내는 사람이 정합니다. 광고성 예약은 08:00~20:30 사이를 권합니다. 21시가 아니라 20시 30분까지인 이유는, 휴대폰의 절전 기능 때문에 예약이 몇 분 늦게 나갈 수 있어 그 여유를 둔 것입니다.

이름으로 보내기

그 밖에

• "아까 보낸 문자들 잘 갔는지 한 번에 확인해줘."
• "예약해 둔 문자 목록 보여주고, 필요 없는 건 취소해줘."
• "새로 온 문자 있어? 있으면 누가 뭐라고 했는지 한 줄씩 알려줘."
• "'택배' 들어간 문자 대화 찾아줘."
• "방금 본 대화방들 전부 읽음 처리해 줘."
• "내일 오전 9시 이후에 보낼 할인 안내 문자 문안 만들어 줘. 광고 규정 맞춰서."

7. 안전 수칙

TwoPhone 서버는 AI가 주고받는 문자 내용을 저장하지 않습니다. 다만 대화 조회를 허용하면 그 내용은 내가 연결한 AI 서비스(Anthropic, OpenAI 등)로 전달되며, 그 이후의 보관은 해당 서비스의 정책을 따릅니다 (개인정보처리방침 5항).

8. 문제 해결

9. 연결 끊기

• 대화 조회만 멈추기: 휴대폰 앱 설정 › AI 연동의 스위치를 끕니다. 즉시 적용됩니다.
• AI 연결 자체를 끊기: PC 웹 프로필에서 AI 연동 (MCP)(웹 채팅용) 또는 발송 API 키(프로그램용)를 재발급합니다. 이전 값으로는 더 이상 접속할 수 없습니다.
• AI 서비스 쪽 정리: Claude는 사용자 지정 › 커넥터 › 내 커넥터, ChatGPT는 앱 목록, 프로그램은 각 설정 파일에서 TwoPhone을 삭제합니다.