AX (AppsInToss eXperience)

AI 어시스턴트가 AppsInToss 미니앱 개발을 도울 수 있도록 설계된 MCP(Model Context Protocol) 서버입니다.

주요 기능

AX는 AI 어시스턴트에게 AppsInToss Developer Center의 문서를 제공하여, 토스 미니앱 개발에 대한 정확하고 컨텍스트 기반의 지원을 가능하게 합니다.

MCP Tools

도구	설명
search_docs	AppsInToss 문서 검색
get_doc	검색 결과의 문서 전체 내용 조회
search_tds_rn_docs	TDS React Native 문서 검색
get_tds_rn_doc	TDS React Native 문서 전체 내용 조회
search_tds_web_docs	TDS Web 문서 검색
get_tds_web_doc	TDS Web 문서 전체 내용 조회

지원 문서

• AppsInToss Developer Center - 미니앱 개발 가이드
• TDS React Native - 토스 디자인 시스템 (React Native)
• TDS Web - 토스 디자인 시스템 (WebView)

설치

Homebrew (macOS/Linux)

brew tap toss/tap
brew install ax

Scoop (Windows)

scoop bucket add toss https://github.com/toss/scoop-bucket
scoop install ax

npm

npm install -g @apps-in-toss/ax

사용법

MCP 서버 시작

ax mcp
ax mcp --disable-usage-stats

AX는 제품 개선과 안정적인 운영을 위해 명령 실행, MCP 도구 호출, 성공 여부, 실행 시간 같은 사용 통계를 수집합니다. 사용 통계 수집을 원하지 않으면 --disable-usage-stats 옵션을 추가하세요.

Cursor/Claude에서 사용

또는 .cursor/mcp.json / claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "apps-in-toss": {
      "command": "ax",
      "args": [
        "mcp"
      ]
    }
  }
}

프로젝트 구조

apps-in-toss-ax/
├── cmd/                    # CLI 명령어 정의
├── internal/               # 내부 패키지
│   ├── httputil/          # HTTP 유틸리티
│   └── utils/             # 공통 유틸리티
├── pkg/                    # 핵심 패키지
│   ├── app/               # 애플리케이션 진입점
│   ├── docs/              # 문서 관리
│   ├── docid/             # 문서 ID 생성
│   ├── features/          # 기능 구성
│   ├── fetcher/           # HTTP 클라이언트
│   ├── instrumentation/   # 사용 통계 수집
│   ├── llms/              # llms.txt 파서
│   ├── mcp/               # MCP 서버 구현
│   └── search/            # 문서 검색 엔진
├── tools/                  # 배포 도구
│   ├── publish/           # 패키지 매니저 배포
│   └── shared/            # 공유 유틸리티
├── scripts/                # 스크립트
├── main.go                # 메인 진입점
├── go.mod                 # Go 모듈 정의
├── Makefile               # 빌드 명령어
└── package.json           # npm 패키지 정의

개발

빌드

make build
# 또는
go build -o ax

테스트

go test ./...

로컬 실행

./ax mcp

AppsInToss란?

AppsInToss는 토스 앱 내에서 미니앱을 제공할 수 있는 플랫폼입니다. 3,000만 토스 사용자에게 서비스를 노출하고, SDK와 API를 활용해 빠르게 개발할 수 있습니다.

주요 개념

용어	설명
Granite	미니앱 개발 프레임워크 (구 Bedrock, v1.0+)
TDS	Toss Design System - 비게임 미니앱 필수

개발 방식

• React Native: 네이티브에 가까운 성능
• WebView: 웹 기술 활용

관련 링크

• AppsInToss Developer Center
• TDS React Native
• TDS Web