# 빠른 시작

Canonical source: https://maguyva.ai/ko/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

0에서 검증된 답변까지 가장 빠른 경로: 키를 발급받고, 이미 알고 있는 저장소 하나를 인덱싱하고, 클라이언트를 연결한 다음, 정답을 이미 알고 있는 질문 하나를 던져보세요.

## 1. API 키 발급받기

[무료로 시작하기](https://app.maguyva.ai) — 신용카드 필요 없음. API 키(`mgv_`로 시작합니다)는 [app.maguyva.ai](https://app.maguyva.ai)에 있습니다.

## 2. 이미 아는 저장소 인덱싱하기

포털에서 GitHub 저장소를 연결하고 인덱싱되도록 두세요. 빠르게 검증할 수 있는 작은 저장소를 선택하세요 — 첫날부터 회사 전체를 인덱싱하려 하기보다는, Maguyva가 모델을 실제로 근거 있게 만들어주는지 명확히 확인하는 편이 낫습니다.

## 3. 클라이언트 연결하기

Claude Code의 경우, 마켓플레이스에서 Maguyva 플러그인을 설치하세요 — 각 명령어를 Claude Code 안에서 실행합니다:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

플러그인은 `MAGUYVA_API_KEY` 환경 변수에 있는 키로 인증합니다. 셸에서 이를 설정하세요(키는 저장소 단위이므로, 프로젝트별 `direnv` 사용을 권장합니다):

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

팀으로 작업하나요? `/plugin install maguyva@maguyva`가 여는 패널에서 project 범위를 선택하세요. 그러면 플러그인이 저장소의 `.claude/settings.json`에 기록되며, 이 파일을 커밋합니다. 각 팀원도 설치를 한 번 실행해야 합니다. 세션 내 `/plugin` 명령어에는 `--scope` 플래그가 없으므로, 스크립트로 처리하려면 저장소 루트에서 셸 버전을 실행하세요:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

그 외 대부분의 클라이언트(Cursor, VS Code, Devin Desktop, Zed 등)는 원격 서버에 직접 연결합니다 — 브리지 없이 `Bearer` 헤더로 엔드포인트를 지정하면 됩니다. 예를 들어 Cursor의 `.cursor/mcp.json`은 다음과 같습니다:

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

구조는 클라이언트마다 조금씩 다릅니다(VS Code는 `type: "http"`과 함께 `servers` 아래에 중첩되고, Antigravity는 `serverUrl`를 사용하며, Zed는 `context_servers`를 사용합니다). 이 Cursor 예시는 위에 나온 `MAGUYVA_API_KEY` 환경 변수에서 키를 읽습니다. 클라이언트 설정에 대신 `mgv_xxxx` 플레이스홀더가 보인다면 이를 여러분의 API 키로 바꾸세요. 그런 다음 클라이언트를 재시작하세요. 설정 문서가 있는 23개 클라이언트 전체의 정확한 설정은 [설치 가이드](https://maguyva.ai/ko/docs/installation)에 있습니다.

## 4. 정답을 이미 아는 질문 하나 던져보기

먼저 **"제가 연결한 저장소는 무엇인가요?"**로 연결을 확인한 다음, 답을 이미 알고 있는 저장소에 관한 실제 질문을 하나 던져보세요 — 예를 들면 **"이 코드베이스에서 인증은 어떻게 처리되나요?"** 같은 질문이요

파일 경로와 줄 번호가 포함된 답변을 받게 될 것입니다. 인용된 파일을 열어서 그 답변이 실제 저장소와 맞아떨어지는지 확인하세요. 그렇게 검증한 답변 하나가 어떤 기능 목록보다도 많은 걸 말해줍니다 — 도구가 기본 워크플로에 들어오기 전에 신뢰를 얻게 하세요.

결과가 없거나 연결 오류가 있나요? [문제 해결](https://maguyva.ai/ko/docs/troubleshooting)에서 API 키, 클라이언트 설정, 저장소 인덱싱 상태를 확인하세요. 브리지를 사용하는 설정이라면 `npx`를 실행할 수 있는지도 확인하세요.

## 다음 단계

- 설치 가이드: 설정 문서가 있는 23개 클라이언트 전체의 클라이언트별 설정
- 작동 방식: 질문과 답변 사이에 일어나는 일
- MCP API 레퍼런스: 모든 도구를, 매개변수 단위로