본문으로 건너뛰기

빠른 시작

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

1. API 키 발급받기#

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

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

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

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

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

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

팀으로 작업 중이신가요? 두 /plugin 명령어 모두에 --scope project를 추가하면 플러그인이 저장소의 .claude/settings.json에 커밋되어 팀원들도 자동으로 받게 됩니다.

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

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

구조는 클라이언트마다 조금씩 다릅니다(VS Code는 type: "http"과 함께 servers 아래에 중첩되고, Windsurf는 serverUrl를 사용하며, Zed는 context_servers를 사용합니다). mgv_xxxx를 여러분의 API 키로 바꾼 다음 클라이언트를 재시작하세요. 문서화된 24개 클라이언트 전체의 정확한 설정은 설치 가이드에 있습니다.

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

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

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

결과가 없거나 연결 오류가 나나요? 문제 해결로 가보세요 — 대부분의 실패 원인은 설정되지 않은 API 키, 누락된 npx, 또는 아직 인덱싱이 끝나지 않은 저장소입니다.

다음 단계#