클로드 코드에 앱인토스 MCP 등록하는 방법 (2분 완성)

by

클로드 코드에 앱인토스 MCP 등록하는 방법 (2분 완성)

토스 미니앱(Apps in Toss)을 운영하다 보면 DAU 확인, 푸시 통계 조회, 번들 롤백처럼 반복적으로 콘솔에 접속해야 하는 작업이 많습니다. 매번 브라우저를 열어 로그인하고 메뉴를 찾아 들어가는 과정이 번거롭게 느껴진 적이 있다면, 결론부터 말씀드리면 명령어 한 줄로 클로드 코드(Claude Code)에 앱인토스 콘솔 MCP를 연결하면 터미널 안에서 자연어로 콘솔 작업을 처리할 수 있습니다. 이 글에서는 등록 절차부터 실제 활용 예시까지 순서대로 정리했습니다.

MCP란 무엇이고 왜 필요한가

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 서비스의 기능을 도구처럼 호출할 수 있도록 연결해주는 프로토콜입니다. 클로드 코드에 특정 서비스의 MCP 서버를 등록해두면, 그 서비스의 웹 콘솔에 직접 들어가지 않아도 AI에게 자연어로 지시해 데이터 조회나 설정 변경 같은 작업을 대신 처리하게 할 수 있습니다.

앱인토스 콘솔 MCP도 같은 원리로 동작합니다. 워크스페이스 관리, 미니앱 설정, 프로모션 운영, 앱 푸시 발송 같은 업무를 웹 UI 클릭 없이 터미널 명령 한 줄로 시작할 수 있다는 점이 가장 큰 장점입니다.

사전에 확인할 것

MCP를 등록하기 전에 아래 두 가지만 확인하면 됩니다.

  • 클로드 코드(Claude Code) CLI가 로컬 또는 원격 서버에 설치되어 있어야 합니다.
  • 앱인토스 콘솔에 접근할 수 있는 계정(운영자 권한)이 있어야 합니다. 등록 과정에서 계정 인증을 거치기 때문입니다.

별도의 API 키를 미리 발급받아 둘 필요는 없습니다. 인증은 등록 명령어 실행 이후 안내되는 절차를 따라가면 됩니다.

클로드 코드에 앱인토스 MCP 등록하는 3단계

1단계 — 콘솔 MCP 추가 명령어 실행

터미널을 열고 아래 명령어를 그대로 입력합니다.

claude mcp add apps-in-toss-console --transport http https://mcp.toss.im/adapters/apps-in-toss-console/mcp --client-id mcp-gateway

이 명령어는 앱인토스 콘솔 서버를 클로드 코드의 MCP 목록에 등록하는 역할을 합니다. 별도의 설정 파일을 수정할 필요 없이 이 한 줄로 연결 준비가 끝납니다.

2단계 — 계정 인증 완료

명령어 실행 후 MCP 연결이 시도되면 로그인 화면 또는 인증 프롬프트가 나타납니다. 화면 안내에 따라 토스 앱인토스 계정으로 인증을 진행하면 권한 연동이 완료됩니다. 이 과정을 마쳐야 실제 콘솔 데이터에 접근할 수 있는 권한이 부여됩니다.

3단계 — 연결 확인 및 프롬프트 테스트

인증이 끝나면 AI에게 정상적으로 연결되었는지 먼저 확인해보는 것이 좋습니다. 특히 비용이 발생하거나 되돌리기 어려운 작업(발송, 롤백 등)은 실행 전에 반드시 결과를 재확인하는 습관을 들이는 것을 권장합니다.

연결이 확인되면 아래처럼 자연어로 콘솔 작업을 바로 지시할 수 있습니다.

  • 통계 조회: “최근 7일 DAU 알려줘”, “푸시 통계 확인해줘”
  • 리소스 생성: “새 푸시 템플릿 만들어줘”
  • 운영 관리: “직전 번들 버전으로 롤백해줘”

등록 후 실제로 어떻게 달라지나

기존에는 통계 하나를 확인하려 해도 콘솔에 로그인해서 메뉴를 몇 단계 거쳐야 했다면, MCP 등록 이후에는 터미널에서 질문 한 줄로 같은 정보를 받아볼 수 있습니다. 특히 개발 작업을 하던 중간에 잠깐 통계나 상태를 확인하고 다시 코드 작업으로 돌아가야 하는 경우, 컨텍스트 전환 비용이 크게 줄어드는 것을 체감할 수 있습니다.

번들 롤백이나 푸시 템플릿 생성처럼 여러 단계를 거쳐야 했던 운영 작업도 자연어 한 문장으로 트리거할 수 있다는 점에서, 반복적인 콘솔 작업이 많은 운영자일수록 체감 효과가 큽니다.

순수 개발 보조가 목적이라면 함께 고려할 것

콘솔 조작이 아니라 코드 작성 자체를 도와받는 것이 주 목적이라면, 콘솔 MCP만으로는 부족할 수 있습니다. 이런 경우 아래 두 가지를 함께 활용하는 방식을 고려할 수 있습니다.

  • 앱인토스 공식 문서를 @docs 형태로 URL 등록해 AI가 최신 문서를 참조하도록 하는 방식
  • apps-in-toss-ax 개발 툴킷 등을 함께 활용해 코드 작성 시 발생할 수 있는 에러를 줄이는 방식

콘솔 MCP가 “운영 작업 자동화”에 초점이 맞춰져 있다면, 이 두 가지는 “코드 품질과 개발 생산성”에 초점이 맞춰져 있다는 점에서 역할이 다릅니다. 필요에 따라 병행하는 것이 좋습니다.

자주 묻는 질문 (FAQ)

Q. MCP를 등록하면 콘솔 로그인 없이 완전히 대체할 수 있나요?
A. 통계 조회나 반복적인 운영 작업 상당수는 자연어 명령으로 대체할 수 있지만, 복잡한 설정 변경이나 최초 설정 단계는 여전히 웹 콘솔이 더 직관적일 수 있습니다. 두 방식을 상황에 맞게 병행하는 것을 권장합니다.

Q. 인증은 한 번만 하면 계속 유지되나요?
A. 최초 등록 시 계정 인증을 완료하면 이후에는 별도 로그인 없이 연동된 상태로 사용할 수 있습니다. 다만 인증 세션 만료 등 환경에 따라 재인증이 필요할 수 있습니다.

Q. 비용이 발생하는 작업(푸시 발송 등)도 AI가 바로 실행하나요?
A. 명령을 내리면 실행 자체는 가능하지만, 되돌리기 어렵거나 비용이 발생하는 작업은 실행 전에 내용을 다시 한번 확인하는 습관을 들이는 것이 안전합니다.

마무리

앱인토스 콘솔 MCP 등록은 명령어 한 줄, 계정 인증 한 번이면 끝나는 간단한 작업입니다. 하지만 그 이후로는 통계 확인, 푸시 템플릿 생성, 번들 롤백 같은 반복 운영 업무를 터미널 안에서 자연어로 처리할 수 있게 되어, 콘솔과 터미널을 오가는 시간을 크게 줄일 수 있습니다. 순수 코드 작성 보조가 필요하다면 공식 문서 등록이나 개발 툴킷을 함께 활용하는 것도 고려해볼 만합니다.

Leave a Comment