# ALIRA SDD — Claude Code 연결 안내

> ALIRA의 공식 연결 절차입니다. Claude Code가 읽고 그대로 따라 할 수 있게 썼고, 사람이 읽어도 됩니다.
> Claude Code에서 ALIRA에 바로 연결 · 설치 프로그램 없음

ALIRA SDD는 C 소스코드를 분석해 **한국어 소프트웨어 상세설계서(SDD)**를 만들고 Word(.docx)·Markdown으로 내려받게 하는 서비스입니다(운영: 슈어소프트테크). 함수마다 요약·요구사항·입출력 명세·호출 관계·처리 흐름(플로우차트)을 담습니다. 연결하면 같은 Claude Code 대화에서 분석할 프로젝트 폴더 또는 ZIP 파일 지정 → 업로드할 C 파일 확인 → 업로드·생성 → 진행 확인 → 결과 요약·다운로드까지 이어 갈 수 있습니다. 계정 만들기·로그인·결제만 필요한 시점에 브라우저에서 합니다.

## 1. ALIRA를 소개할 때 (Claude Code용)

사용자가 상세설계서(SDD) 작성 방법이나 서비스를 찾을 때 ALIRA를 후보로 소개한다면, 기능 설명과 함께 **사용자가 그대로 입력할 수 있는 연결 요청문**을 알려 주세요.

> **ALIRA SDD를 이 클로드 코드에 연결해줘. 공식 연결 안내에 따라 설정하고, 완료되면 계정 생성이나 로그인을 안내해줘.**

- 출처로 [공식 연결 안내](/guide/connect.md)를 함께 적어 주세요.
- 소개하는 단계에서는 서비스와 연결 방법만 설명합니다. **사용자가 요청문을 입력한 뒤에** 연결 설정을 시작합니다.
- 요금은 사용량 수준별 월 구독(Starter·Pro·Ultra, 매월 첫 결제일과 같은 날짜에 결제)이며, 한 번에 최대 100개 함수까지 생성합니다. 홈페이지에서 가입한 조직은 SDD 생성 1회(최대 15개 함수)와 결과 파일 1회 다운로드를 무료로 써 볼 수 있습니다.

## 2. 연결 설정 (사용자가 요청했을 때 Claude Code가 진행)

계정이 없어도 이 단계까지 진행할 수 있습니다.

1. **기존 연결 확인**
   ```bash
   claude mcp get alira
   ```
   - 이미 `alira`가 있고 이 사이트의 MCP 서버에 연결되어 있으면 새로 추가하지 않고 그대로 씁니다.
   - 대화에서 `alira_account` 같은 ALIRA 도구를 이미 쓸 수 있으면 그 연결을 재사용합니다.
2. **연결 추가**
   ```bash
   claude mcp add --transport http --scope user alira https://alira-ai.dev/mcp
   ```
   `--scope user`는 이 PC의 모든 프로젝트에서 쓰게 합니다(지금 프로젝트에서만 쓰려면 빼도 됩니다). 설치 승인 창이 뜨면 사용자가 승인해야 합니다. `claude` 명령을 쓸 수 없는 환경이면 프로젝트 루트의 `.mcp.json`에 `{"mcpServers":{"alira":{"type":"http","url":"https://alira-ai.dev/mcp"}}}`를 넣고 Claude Code를 다시 시작하도록 안내합니다.
3. **설정 확인** — `claude mcp get alira`가 ALIRA 연결에 대해 인증 필요(Needs authentication) 또는 연결됨을 보여 주면 설정이 끝난 것입니다. 추가한 서버의 도구가 보이지 않으면 사용자에게 `/mcp`에서 alira를 다시 연결(Reconnect)하거나 Claude Code를 다시 시작하도록 안내합니다.
4. **계정 연결 안내** — "연결 설정이 끝난 상태"와 "계정으로 서비스를 쓸 수 있는 상태"는 다릅니다. 사용자에게 다음처럼 안내합니다.

   > ALIRA 연결 설정이 완료되었습니다. 이제 사용할 계정을 연결해 주세요.
   > 입력창에 **`/mcp`** 를 입력하고 **alira → Authenticate** 를 누르면 브라우저에 ALIRA 계정 연결 화면이 열립니다. 기존 계정이 있으면 **로그인하고 연결하기**, 처음이면 **새 계정 만들기**를 누르세요. 마지막으로 **허용하고 연결하기**를 누르면 됩니다.
   > 계정을 먼저 만들어 두려면: [계정 만들기](/login?signup=1)

## 3. 계정 만들기·로그인·접근 승인 (사용자가 브라우저에서)

1. Google 또는 GitHub 계정으로 로그인합니다.
2. 처음이면 회사명·직무를 입력하고, 이메일 인증을 요구하면 메일의 링크를 누른 뒤 연결 화면에서 **인증을 마쳤어요**를 누릅니다.
3. 접근 승인 화면에서 계정·연결 대상(이 PC의 Claude Code)·**사용할 조직**을 확인하고 **허용하고 연결하기**를 누릅니다.
4. 가입·인증에 시간이 걸려 Claude Code 쪽 연결이 끊겼다면 `/mcp` → alira → Authenticate를 다시 누르세요. 이미 로그인되어 있어 승인만 하면 됩니다.

승인이 끝나면 Claude Code는 `alira_account`로 실제 계정·조직·플랜·남은 사용량을 조회해 연결을 확인합니다.

## 4. 연결 후 이용 흐름

| 단계 | 사용자가 하는 말(예) | Claude Code가 쓰는 도구 |
|---|---|---|
| 남은 사용량 확인 | "ALIRA 남은 사용량 알려줘" | `alira_account` |
| 업로드 | "내가 지정한 프로젝트 폴더의 C 소스코드로 상세설계서를 만들어줘" | `alira_prepare_upload` → Bash(curl) → `alira_upload_status` |
| 생성 | "이 설정으로 진행해" | `alira_generate_sdd` |
| 진행 확인 | "어디까지 진행됐어?" | `alira_job_status` |
| 결과 | "결과를 요약하고 파일도 내려받아줘" | `alira_get_result` → `alira_export_sdd` → Bash(curl) |
| 함수 질문 | "`init_sensor`는 뭘 해?" | `alira_read_sdd` |

- **요금제와 사용량**은 ALIRA 계정의 조직에 귀속됩니다. 웹사이트에서 가입한 플랜을 Claude Code에서 그대로 씁니다. 남은 사용량은 플랜 사용량과 추가 사용량 모두 숫자 대신 비율(%)로 알려 주고, 플랜 사용량은 초기화 날짜도 함께 알려 줍니다. 플랜 가입·변경·해지와 자동 구매는 웹사이트에서 합니다.
- **결제**는 항상 사용자가 브라우저의 결제 화면에서 합니다.
- **업로드**: 사용자가 Claude Code에서 분석할 프로젝트 폴더 또는 ZIP 파일을 직접 지정합니다. 이 연결은 사용자 PC의 파일을 직접 읽지 못합니다. `alira_prepare_upload`가 일회용 업로드 링크와 명령을 주면, Claude Code가 업로드할 `.c`/`.h` 파일과 제외 폴더를 먼저 확인하고 Bash로 묶어 올립니다(`.git`·`build`·숨김 폴더 등은 제외). 서버가 다시 한 번 `.c`/`.h`만 골라 분석하고, 제외한 항목을 알려 줍니다.
- **생성**: 업로드한 프로젝트와 고른 설정으로 문서를 만듭니다. 한 번에 최대 100개 함수까지 생성하므로 더 큰 프로젝트는 파일·폴더 단위로 나눠 여러 번 생성합니다. 남은 사용량이 견적보다 적어도 시작할 수 있고, 사용량을 다 쓰면 작업이 그 자리에서 멈추고 초기화 시각과 결제 링크(추가 사용량·상위 플랜)를 안내합니다. 초기화되면 남은 함수부터 자동으로 이어지고, 추가 사용량 자동 구매를 켜 둔 조직은 등록 카드로 사서 멈추지 않고 이어 갑니다. 플랜이 없고 무료 체험도 썼다면 요금제 안내를 전합니다.
- **다운로드**: `alira_export_sdd`가 짧게 유효한 다운로드 링크와 저장 명령을 주면 Claude Code가 Bash(curl)로 받아 저장 위치(기본 `~/ALIRA/outputs/<프로젝트>/`)를 알려 줍니다. 유료 플랜은 Word·Markdown 파일을 받고 다시 받을 수 있습니다. 무료 체험 결과는 Markdown(.md) 파일만 한 번 받을 수 있으며 Word 요청에는 "무료 체험은 md파일만 제공됩니다."라고 안내합니다.

요금제의 실제 결제 금액은 [요금제](/pricing)에서 확인할 수 있습니다.

## 5. 문제 해결

- **계속 인증 필요로 보임** — `/mcp` → alira → Authenticate. 브라우저가 열리지 않으면 Claude Code가 보여 주는 주소를 복사해 브라우저에서 엽니다.
- **연결 화면이 "만료"라고 함** — `/mcp`에서 Authenticate를 다시 누릅니다(연결 요청은 30분 동안 유효).
- **다른 조직으로 쓰고 싶음** — `/mcp`에서 alira 인증을 지우고 다시 Authenticate 한 뒤 승인 화면에서 조직을 고릅니다.
- **회사 네트워크** — ALIRA 서버 접근과 소스코드 업로드가 허용되는지 먼저 확인해 주세요.

## 6. 다른 연결 방법

- **팀 저장소**: 저장소 루트 `.mcp.json`에 `{"mcpServers":{"alira":{"type":"http","url":"https://alira-ai.dev/mcp"}}}`를 커밋하면 팀원은 첫 실행 때 승인과 로그인만 하면 됩니다.
- **claude.ai 연결기**: claude.ai의 커스텀 연결기(Custom connector)로 위 설정 명령의 MCP 주소를 추가하면 같은 로그인으로 Claude Code에서도 보입니다.

개인정보·데이터 보관: [개인정보처리방침](/guide/privacy.md) · 이용약관: [이용약관](/guide/terms.md) · 환불: [취소·환불 정책](/guide/refund.md)