Cline 사용자를 위해

Cline은 행동하기 전에 계획합니다. 그 계획에 지도를 주세요.

Cline은 파일을 읽고, 명령을 실행하고, 무엇이든 바꾸기 전에 묻습니다. Maguyva는 저장소 전체를 인덱싱해 MCP로 돌려주므로, Plan 모드가 디렉터리 목록이 아니라 실제 호출 지점에서 시작합니다.

Free 등급: 저장소 3개, 인덱싱된 저장소 라인 최대 5만 줄, 카드 등록 불필요.

일하는 방식은 .clinerules에. 지금 코드가 말하는 것은 Maguyva에.

Cline에 대해 알아둘 것

Cline에만 해당하는 네 가지 사실.

// 설정 파일

cline_mcp_settings.json

Cline 패널의 MCP Servers 아이콘에서 엽니다. Configure 탭에 들어간 뒤 Configure MCP Servers를 누르세요. 서버는 mcpServers 아래에 둡니다.

// 전송 계층

URL로 원격 연결

Cline은 Streamable HTTP로 Maguyva 엔드포인트에 연결합니다. 로컬 프로세스도 Node.js도 필요 없습니다.

// 키

헤더에 그대로 기입

Cline 자체 예시처럼 키는 Authorization 헤더에 바로 넣습니다. 설정 파일은 저장소가 아니라 에디터의 사용자 저장 공간에 있습니다.

// 타입

SSE가 아니라 streamableHttp

항목에 "type": "streamableHttp"를 남겨 두세요. 타입이 없으면 Cline은 예전 SSE로 간주합니다. 믿을 수 있는 도구를 autoApprove에 적으면 승인 확인을 건너뜁니다.

Cline 규칙은 작업 합의입니다. 활용하세요.

# .clinerules/testing.md
- 작업을 완료로 표시하기 전에 테스트 스위트를 실행한다.
- 의존성을 추가하기 전에 물어본다.

워크스페이스 규칙은 .clinerules/ 또는 .cline/rules/에 두는 Markdown 파일입니다. Cline은 AGENTS.md, .cursorrules, .windsurfrules도 읽어 들입니다. 규칙에 적합한 것:

Cline이 실행해야 할 명령.
frontmatter glob으로 특정 경로에 한정한 가드레일.
반복해서 말하기 지친 팀 규칙.

규칙은 Cline에게 행동 방식을 알려줍니다. 지금 마이그레이션하려는 테이블을 어떤 서비스가 읽는지는 알려주지 않습니다.

규칙과 파일 읽기가 한계에 부딪히는 곳

Cline이 요청 한 번에 파일 하나씩 더 읽으며 메우는 세 가지 빈틈.

// 목록으로 세운 계획

Plan 모드는 Cline이 지금까지 읽은 것에서 추론합니다. 큰 저장소라면 그건 디렉터리 트리와 파일 몇 개에 불과하고, 계획은 그 빈틈을 그대로 물려받습니다.

// 읽을 때마다 왕복

Cline이 파악하려고 여는 파일마다 토큰과 모델 요청 한 번이 듭니다. 낯선 패키지를 탐색하다 보면 첫 편집 전에 컨텍스트 창의 상당 부분을 써버릴 수 있습니다.

// 텍스트 검색은 호출자가 아니라 문자열을 찾는다

“이걸 또 누가 호출하지?”는 그래프 질문입니다. 텍스트 검색은 문자열을 찾지만, 진짜 호출자와 주석, 목, 같은 이름의 메서드를 구분하지 못합니다.

Cline의 MCP 서버로서의 Maguyva

mcpServers 항목 하나로 Cline이 얻는 것:

인덱싱된 저장소에 대한 11개의 도구 시맨틱, 구조적(AST), 그래프, 텍스트 검색에 더해 심볼 조회, 의존 요소, 파일 검색까지.
파일 경로와 줄 번호가 포함된 답 285개 이상의 언어에서. 계획이 실제 파일을 인용합니다.
읽기만 하는 도구 Maguyva의 도구는 인덱스를 조회할 뿐, 어느 것도 여러분의 파일을 편집하지 않습니다.

Cline 규칙은 Cline에게 일하는 방법을 알려줍니다.
Maguyva는 Cline에게 계획의 바탕이 될 지도를 줍니다.

두 가지 워크플로

지도에 맞춰 계획하고, 그다음 실행하세요.

// workflow 01

실제 호출 지점에서 변경 계획하기

cline plan> 세션 갱신을 auth 패키지로 옮겨 줘

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Act 모드가 시작되기 전에 계획에 호출 지점 세 곳이 나열됩니다.
[exit 0]

계획이 건드릴 파일을 모두 밝히므로, 여러분은 감이 아니라 목록을 승인합니다.

// workflow 02

테스트 픽스처가 아니라 실제 구현 찾기

cline> 일할 계산은 어떻게 하나요?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← 구현
  test/billing/proration.spec.ts:7   ← 픽스처

→ Cline은 파일 여섯 개 대신 하나만 읽습니다.
[exit 0]

순위화된 결과는 이름이 같은 픽스처보다 구현을 위에 둡니다.

Cline에서 설정하기

세 단계로 끝. Free 등급: 저장소 3개, 인덱싱된 저장소 라인 최대 5만 줄, 카드 등록 불필요.

// step 01

maguyva.ai에서 저장소 인덱싱하기

답을 채점할 수 있도록 이미 잘 아는 저장소를 고르세요.

// step 02

Cline의 MCP 설정에 Maguyva 추가하기

cline_mcp_settings.json

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

// step 03

플레이스홀더를 바꾸고 질문 하나 해보기

mgv_xxxx를 여러분의 API 키로 바꾸고 파일을 저장하세요. 이미 답을 아는 질문 하나를 한 뒤, 인용된 파일을 열어 보세요.