> For the complete documentation index, see [llms.txt](https://docs.axid.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.axid.app/ko/getting-started/quickstart.md).

# 빠른 시작

Axid는 B2B 팀 메시징 플랫폼입니다. Axid의 봇은 REST API 또는 AI 편집기를 통해 Linear 이슈 카드, GitHub PR 카드, 알림 배너, 콜아웃 같은 풍부한 블록 메시지를 전송합니다.

이 페이지는 **진입점**입니다. 아래에서 경로를 하나 선택하세요. 각 경로의 끝에는 동작하는 봇이 있습니다.

***

## 두 가지 경로

| 경로                                             | 시간    | 추천 대상                                                                           |
| ---------------------------------------------- | ----- | ------------------------------------------------------------------------------- |
| [**AI 우선**](/ko/getting-started/ai-first.md)   | \~5분  | Claude Desktop / Cursor를 사용하며, AI가 프로젝트를 스캐폴딩하고 블록 JSON을 검증하고 첫 메시지를 보내기를 원합니다. |
| [**코드 우선**](/ko/getting-started/code-first.md) | \~10분 | REST API를 직접 호출하고 싶습니다 `curl` 또는 `fetch`가 필요합니다. AI 도구는 필요하지 않습니다.              |

두 경로는 동일한 API와 동일한 인증을 공유합니다. 프로젝트 도중에 서로 전환할 수 있습니다.

### AI 우선

우리는 `@axid-dev/mcp-server`를 제공합니다. 이는 [MCP 서버](https://modelcontextprotocol.io) 로, Claude Desktop, Cursor 또는 모든 MCP 클라이언트에 5개의 고수준 도구를 제공합니다. AI는 사용자를 대신해 이 도구들을 호출합니다. 즉, 봇을 생성하고, 프로젝트를 스캐폴딩하고, 서버가 사용하는 동일한 Zod 스키마에 대해 블록 JSON을 검증하고, 테스트 메시지를 보냅니다.

아이디어에서 채널의 메시지까지의 왕복: 5개의 프롬프트.

→ [**AI 우선 가이드 열기**](/ko/getting-started/ai-first.md)

### 코드 우선

전송 `Authorization: Bearer axid_live_<key>` 와 `POST` 를 `/api/v1/channels/{id}/messages`에 보내세요. 이것이 "메시지 보내기"를 위한 전체 API 범위입니다. 코드 우선 가이드는 다음을 안내합니다:

* API 키 얻기
* 일반 텍스트 메시지 보내기
* 블록 메시지 보내기(`content_json` 과 11개의 안정적인 블록 사용)
* 검증 함정(https 전용 URL, 카드 호스트 일치, 멘션 UUID, 더 이상 사용되지 않는 블록 거부)
* 수신 이벤트 받기(SSE 또는 웹훅)

→ [**코드 우선 가이드 열기**](/ko/getting-started/code-first.md)

***

## 만들 수 있는 것

axid의 블록 프리미티브에 자연스럽게 들어맞는 봇들의 비포괄적 목록:

* **배포 알림 봇.** GitHub Actions / CI가 웹훅을 발생시키면 → 봇이 `alert_banner` (상태별 변형) + `github_pr_card` 를 병합된 PR에 대해 게시합니다. 클릭 → 배포 로그를 엽니다.
* **Linear / GitHub 미러.** Linear 또는 GitHub 웹훅이 발생하면 → 봇이 `linear_issue_card` 또는 `github_pr_card` 요약을 게시합니다. 상태 업데이트는 [블록 패치 프로토콜](/ko/api/reference.md).
* **일일 요약.** 예약 작업이 오전 9시에 실행되면 → 봇이 `heading` + `link_unfurl` 항목 목록을 어제의 PR / Linear 업데이트 / 문서 변경 사항에 대해 게시합니다.
* **온콜 알림 봇.** Pager / 모니터링 웹훅 → 봇이 치명적 변형의 `alert_banner` 을 게시합니다. `actionLabel: "Acknowledge"` 와 `url` 을 사용하여 인시던트 런북을 가리킵니다. 오늘날 버튼은 `url`전용이며, 봇 정의 `actionId` 핸들러는 스키마상 예약되어 있지만 현재는 비활성화된 상태로 렌더링됩니다. 활성화는 [`POST /interactions/actions`](/ko/api/reference.md) 를 추적하세요.

모든 블록 스키마는 [API Reference](/ko/api/reference.md) 에 있으며, 검증기가 사용하는 동일한 Zod 소스에서 자동 생성되므로 보이는 것이 곧 서버가 강제하는 내용입니다.

***

## 다음 단계

* [**AI 우선 가이드**](/ko/getting-started/ai-first.md) — Claude / Cursor가 봇을 대신 만들어 주게 하세요.
* [**코드 우선 가이드**](/ko/getting-started/code-first.md) — REST API를 직접 호출하세요.
* [**핵심 개념**](/ko/guides/concepts.md) — 에이전트 = 사용자, 채널 멤버십, 스레드, 메타데이터, FL 버전 관리.
* [**API Reference**](/ko/api/reference.md) — 모든 엔드포인트, 모든 블록 스키마, 모든 오류 코드.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.axid.app/ko/getting-started/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.