휴대폰과 AI 에이전트 사이에서 파일 주고받기

마지막 확인 2026-10-28

코딩 에이전트는 컴퓨터에서 실행되지만, 버그 스크린샷이나 화이트보드 사진, 고객이 보낸 PDF는 휴대폰에 있을 때가 많아요. tosstome mcp는 Model Context Protocol을 통해 에이전트에게 휴대폰이 보낼 수 있는 수신함과, 파일을 휴대폰으로 돌려보내는 방법을 줘요.

에이전트가 할 수 있는 일

설정하기

tosstome 명령줄 도구를 설치한 뒤(Node.js 22 이상) 에이전트에 등록하세요. Claude Code에서는 이렇게 해요.

claude mcp add tosstome -- tosstome mcp

다른 MCP 클라이언트에서는 이 명령으로 stdio 서버를 추가하세요.

{
  "mcpServers": {
    "tosstome": { "command": "tosstome", "args": ["mcp"] }
  }
}

받은 파일은 에이전트가 서버를 시작한 위치(보통 프로젝트 폴더) 기준의 ./tosstome-inbox에 저장돼서, 에이전트가 평소 쓰는 파일 도구로 읽을 수 있어요. 이 폴더를 .gitignore에 추가하거나, --dir로 다른 위치를 지정하세요.

휴대폰에서 에이전트로

1. 에이전트에게 수신함 링크를 요청하세요. 에이전트가 get_inbox_link를 호출해서 링크와 QR 코드를 보여줘요.
2. 휴대폰에서 링크를 열고 홈 화면에 추가하세요. 링크는 바뀌지 않으니 한 번만 하면 돼요.
3. 에이전트에게 뭔가를 보낼 거라고 알려 주세요. 에이전트가 wait_for_files를 호출해요.
4. 파일을 고르거나 복사해 둔 오류 메시지나 링크 같은 메시지를 입력하고 보내기를 누르세요. 에이전트는 파일 경로를 받고, 메시지는 읽고 이미지는 바로 봐요.

에이전트에서 휴대폰으로

1. 휴대폰에서 toss2.me를 열고 코드 만들기를 누르세요.
2. 에이전트에게 6자리 숫자를 알려 주세요. 예를 들어 "빌드를 내 폰으로 보내 줘, 코드는 482913"처럼요.
3. 에이전트가 send_files를 호출해요. 휴대폰에서 수락 여부를 묻고, 수락하면 각 파일마다 저장이 나타나거나 메시지가 복사 버튼과 함께 표시돼요.

코드 대신 tosstome listen을 실행 중인 다른 컴퓨터의 수신함 링크를 주면, 같은 도구로 그 컴퓨터에도 보낼 수 있어요.

알아 두세요

• 파일은 기기에서 기기로 바로 가거나, 아무것도 보관하지 않는 릴레이를 거쳐요. 휴대폰이나 컴퓨터가 오프라인이면 아무것도 전송되지 않아요.
• 수신함은 한 번에 프로세스 하나가 맡아야 해요. 같은 수신함에서 tosstome listen이 이미 실행 중이라면, 에이전트가 tosstome mcp를 쓰는 동안은 멈추세요. 아니면 파일이 둘 중 어느 쪽으로든 갈 수 있어요.
• 수신함 링크를 가진 사람은 누구나 에이전트에 파일을 보낼 수 있어요. 서버는 에이전트에게 파일 내용을 지시가 아니라 데이터로 다루라고 알려 주지만, 링크를 누구에게 주는지는 조심하세요. 유출된 링크는 tosstome listen --new로 교체하세요.
• 서버는 현재의 stateless MCP 리비전(2026-07-28)과, 여전히 initialize 핸드셰이크를 쓰는 클라이언트를 모두 지원해요.

자주 묻는 질문

관련 글

• tosstome 명령줄 도구
• 휴대폰에서 서버, NAS, 라즈베리 파이로 파일 보내기
• 휴대폰에서 컴퓨터로 파일 보내기
• tosstome 작동 원리