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