# Maguyva

클라이언트 설치, 편집 전 검색, 빈 결과 처리, 여러 저장소 작업 등 일반적인 Maguyva MCP 워크플로를 위한 짧은 레시피입니다.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/ko/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/ko/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/ko/changelog.json).

## 언어별 기능

아래는 구조적 검색, 심볼 조회, 그래프 인식 분석, 기본 인덱싱을 구동하는 기능별 지원 언어 수입니다.

이 표시는 현재 언어 설정에서 활성화된 기능을 나타내며, 종단 간 품질 점수가 아닙니다. 그래프를 사용하려면 파서, 심볼 추출, 그래프 추출이 모두 활성화되어 있어야 합니다. 지원하는 관계 유형과 추출 깊이는 언어마다 다릅니다.

- 인덱싱 범위: **284**. 나열된 모든 언어는 파일, 텍스트, 저장소 컨텍스트를 위해 인덱싱됩니다.
- AST 구조적 검색: **247**. AST 및 구조적 검색 워크플로우를 위한 파서 기반 구조를 갖춘 언어입니다.
- 심볼 추출: **282**. 정의와 조회에 사용할 심볼 메타데이터가 있는 언어입니다.
- 그래프 관계: **151**. 그래프 인식 검색에 사용할 수 있는 관계 추출 기능이 실제로 동작하는 언어입니다. 그래프 깊이는 언어와 관계 유형에 따라 다릅니다.

- `ast_structural=false`: 구조적 인식이 제한적인 텍스트 우선 인덱싱입니다.
- `symbol_extraction=false`: 심볼 추출이 제한적이어서 내비게이션은 파일 및 구조 컨텍스트에 더 의존합니다.
- `relationship_extraction=false`: 이 언어는 검색을 위해 인덱싱되지만, 현재 코드 그래프에는 영속화되지 않습니다.

[언어 찾기](/llms-full.txt)

## 실전 가이드

일상적인 Maguyva MCP 작업을 위한 실용적인 레시피입니다. 각 레시피는 도구와 순서를 설명하지만 전체 매개변수 참조는 아닙니다. 도구 매개변수는 [MCP API 참조](https://maguyva.ai/ko/docs/mcp-api), 최초 설정은 [빠른 시작](https://maguyva.ai/ko/docs/quickstart)를 참고하세요.

### 알맞은 도구 선택

대부분의 질문은 한 번의 호출로 시작합니다. 첫 답변이 너무 넓거나 빈약할 때만 다음 단계로 넘어가세요.

- `intelligent_search` — 코드베이스에 관해 자연어로 질문할 때 여기서 시작하세요. 기본 auto/balanced는 의도를 높은 확신으로 판별할 수 있는 정의 질문을 구조적 검색으로, 참조 또는 영향 질문을 그래프로, 정확히 일치하는 항목을 찾는 질문을 텍스트로 라우팅합니다. 그 외 질문에는 의미 기반 검색과 인덱싱된 텍스트를 사용합니다. 네 가지 검색 방식을 모두 요청하려면 mode=hybrid 또는 auto와 quality=thorough를 사용하세요. 명시적으로 지정한 mode가 quality보다 우선합니다.
- `find_symbol` — 함수, 클래스 또는 변수 이름을 이미 알고 있을 때 사용합니다.
- `dependency_search` — 편집 전후의 영향 범위, 즉 호출자, 종속 항목 및 영향을 확인합니다.
- `get_task_context` — 낯선 영역에서 작업 설명과 관련된 파일, 심볼, 종속성을 하나의 제한된 묶음으로 가져옵니다.
- `repository_context` — 접근 가능한 저장소를 나열하거나 저장소 이름이 어떻게 해석되는지 확인합니다.
- `operation="guidance"`와 함께 쓰는 `ask_maguyva` — 저장소를 변경하지 않고 도구 선택과 Maguyva 사용법을 로컬에서 안내합니다.

## Tools -- Search

- [intelligent_search](https://maguyva.ai/ko/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/ko/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/ko/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/ko/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/ko/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/ko/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/ko/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/ko/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/ko/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/ko/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/ko/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## 다음 단계

- [빠른 시작](https://maguyva.ai/ko/docs/quickstart)
- [설치 가이드](https://maguyva.ai/ko/docs/installation)
- [MCP API 참조](https://maguyva.ai/ko/docs/mcp-api)
- [문제 해결](https://maguyva.ai/ko/docs/troubleshooting)
- [작동 방식](https://maguyva.ai/ko/docs/how-it-works)
- [호환성 및 기술 사양](https://maguyva.ai/ko/docs/compatibility)

## Agent integrations

- [Cursor용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-cursor): Cursor는 열려 있는 파일을 편집합니다. Maguyva는 모노레포 전체를 인덱싱해 MCP를 통해 되돌려줍니다 — file:line이 포함된 시맨틱, AST, 그래프, 텍스트 검색으로, 에이전트가 여러분이 고정하지 않은 파일까지 찾아냅니다.
- [Windsurf용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-windsurf): Windsurf와 Cascade는 열려 있는 파일을 편집합니다. Maguyva는 모노레포 전체를 인덱싱해 MCP로 제공합니다 — file:line이 포함된 시맨틱, AST, 그래프, 텍스트 검색으로, Cascade가 여러분이 언급하지 않은 파일까지 찾아냅니다.
- [Antigravity용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-antigravity): Antigravity는 에디터, 터미널, 브라우저 전반에서 자율 에이전트를 실행합니다. Maguyva는 MCP를 통해 모노레포의 조회 가능한 지도를 제공합니다 — CI가 실패한 뒤가 아니라 미리 영향 범위를 알려줍니다.
- [Codex용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-codex): AGENTS.md는 작업 합의서입니다. Maguyva는 Codex CLI에 저장소의 조회 가능한 지도를 제공하는 MCP 서버로, 첫 편집이 추측이 되지 않도록 합니다.
- [모든 MCP 클라이언트를 위한 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-anything): MCP는 개방형 프로토콜입니다. Maguyva는 표준 MCP 서버이므로, Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity 같은 MCP 지원 클라이언트라면 모두 동일하게 근거 있는 코드베이스 컨텍스트를 얻습니다.
- [Gemini CLI용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-gemini): GEMINI.md는 작업 컨텍스트를 설정하고, MCP는 그 통로입니다. Maguyva는 Gemini CLI에게 리포지토리의 조회 가능한 지도를 제공하는 MCP 서버입니다 — 시맨틱, AST, 그래프 검색으로 첫 편집이 추측이 되지 않도록 합니다.
- [Claude Code용 Maguyva: MCP를 통한 코드베이스 컨텍스트](https://maguyva.ai/ko/for-claude-code): CLAUDE.md는 Claude에게 어떻게 행동해야 하는지 알려줍니다. Maguyva는 저장소를 인덱싱하고 MCP를 통해 제공하여, Claude Code가 조회 가능한 지도를 바탕으로 편집하도록 합니다.
- [GitHub Copilot CLI를 위한 Maguyva: MCP를 통한 코드 컨텍스트](https://maguyva.ai/ko/for-copilot): 사용자 지정 지침은 Copilot에게 어떻게 행동해야 하는지 알려줍니다. Maguyva는 저장소를 인덱싱하고 MCP를 통해 제공하여, GitHub Copilot CLI가 지도를 바탕으로 편집하도록 합니다.

## Company

- [Maguyva 소개: MCP 기반 코드 인텔리전스](https://maguyva.ai/ko/about): 코딩 에이전트를 위한 코드 인텔리전스: 시맨틱, AST, 그래프, 전체 텍스트 검색, 심볼 조회, 의존성 분석, 그리고 284개 이상 언어에 걸친 단일 호출 작업 컨텍스트.
- [팀 소개: 인간 2명 + AI 에이전트 무리](https://maguyva.ai/ko/team)
- [저희가 일하는 방식: VC 없음, 좌석당 과금 없음, 기능별 유료 잠금 없음](https://maguyva.ai/ko/how): 외부 자본 없음. 좌석당 과금 없음. 여러분의 데이터는 상품이 아닙니다. Maguyva가 어떻게 만들어졌고 왜 이런 가격 정책을 택했는지 설명합니다.
- [기술 스택: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/ko/stack): Maguyva를 구동하는 기술 스택입니다. PostgreSQL, Voyage AI 임베딩, 양자화된 벡터 검색, tree-sitter AST, MCP 프로토콜.
- [변경 이력](https://maguyva.ai/ko/changelog): Maguyva에 출시된 내용: 제품 변경 사항, 인덱스 및 MCP 도구 업데이트, 빌드 관련 노트. 최신순.
- [라이브: Maguyva가 실시간으로 스스로를 만드는 중](https://maguyva.ai/ko/live): 짜여진 데모가 아닙니다. 이건 실제 디스패치 로그입니다 — Maguyva를 만드는 AI 에이전트 팀의 모든 도구 호출, 오류, 커밋을 실시간으로 보여줍니다.

## Guides

- [트렌치코트를 입은 풀텍스트 검색이 아닙니다. 다섯 가지 검색 방식을 융합했습니다.](https://maguyva.ai/ko/beyond-rag): 코드에는 시맨틱 청크 이상의 것이 필요합니다. Maguyva는 다섯 가지 검색 방식을 융합해서 284개 언어에 걸쳐 MCP를 통해 실제 저장소에 근거한 하나의 순위화된 답변으로 만듭니다. Free 등급, 카드 등록 불필요.
- [지침 파일은 코드의 지도가 아닙니다. Maguyva가 그 지도입니다.](https://maguyva.ai/ko/beyond-rules-files): CLAUDE.md와 AGENTS.md는 에이전트에게 어떻게 행동할지 알려줍니다. 코드베이스에 무엇이 있는지는 알려주지 않습니다. Maguyva는 284개 언어에 걸쳐 MCP를 통해 제공되는 코드베이스 컨텍스트 레이어입니다. Free 등급, 카드 등록 불필요.
- [수정은 쉽습니다. 무엇이 깨질지 아는 게 어렵습니다. Maguyva가 그걸 지도로 보여줍니다.](https://maguyva.ai/ko/know-what-breaks): 리팩터링 전에, 에이전트는 모든 호출자, import하는 곳, 해당 코드에 의존하는 코드를 알아야 합니다. Maguyva는 grep이 아니라 실제 호출 그래프에서 MCP를 통해 그 답을 제공합니다. Free 등급, 카드 등록 불필요.
- [무료로 시작하기: AI 코딩 에이전트를 위한 코드베이스 컨텍스트 레이어](https://maguyva.ai/ko/map-then-change): 먼저 지도를 그리고, 그다음에 바꾸세요. Maguyva는 첫 수정 전에 AI 코딩 에이전트에게 MCP를 통해 조회 가능한 코드베이스 지도를 제공합니다. 284개 언어에 걸친 11개 도구. Free 등급, 카드 등록 불필요.
- [에이전트는 여러분의 저장소에서 아무것도 모른 채 시작합니다. Maguyva가 지도를 건네줍니다.](https://maguyva.ai/ko/stop-flying-blind): 코딩 에이전트는 엉뚱한 파일을 훑어보고 코드를 이해하기도 전에 수정합니다. Maguyva는 284개 언어에 걸쳐 MCP를 통해 에이전트에게 조회 가능한 코드베이스 지도를 제공합니다. Free 등급, 카드 등록 불필요.