왜 문서가 중요할까
- 최신 API와 파라미터
- 모범 사례
- 조직 내 관례
- 도메인 용어
모델 지식 컷오프
- 최근 라이브러리 업데이트가 반영되지 않았을 수 있음
- 새로운 프레임워크나 도구를 모를 수 있음
- 컷오프 이후의 API 변경 사항을 놓칠 수 있음
- 학습 이후 모범 사례가 달라졌을 수 있음
어떤 도구를 써야 할까?
멘탈 모델
Tool | 멘탈 모델 |
---|---|
@Docs | 공식 문서를 둘러보고 읽는 느낌 |
@Web | 인터넷에서 해결책을 찾아보는 느낌 |
MCP | 내부 문서에 접근하는 느낌 |
Public documentation
@Docs 사용하기
@Docs
는 Cursor를 인기 있는 도구와 프레임워크의 공식 문서에 연결해줘. 최신의 신뢰할 수 있는 정보가 필요할 때 써봐:
- API 레퍼런스: 함수 시그니처, 매개변수, 반환 타입
- 빠른 시작 가이드: 설치, 설정, 기본 사용법
- 모범 사례: 원문에서 권장하는 패턴
- 프레임워크별 디버깅: 공식 문제 해결 가이드
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
∞
Agent⌘I
Auto
@Web 사용하기
@Web
은 최신 정보, 블로그 글, 커뮤니티 토론을 실시간으로 찾아줘. 이런 게 필요할 때 써봐:
- 최신 튜토리얼: 커뮤니티가 만든 콘텐츠와 예제
- 비교 자료: 서로 다른 접근 방식을 비교한 글
- 최근 업데이트: 막 올라온 업데이트나 공지
- 여러 관점: 문제에 대한 다양한 접근 방식
@
@Web latest performance optimizations for React 19
∞
Agent⌘I
Auto
내부 문서
- 내부 API: 커스텀 서비스와 마이크로서비스
- 회사 표준: 코딩 컨벤션, 아키텍처 패턴
- 독점 시스템: 커스텀 도구, 데이터베이스, 워크플로
- 도메인 지식: 비즈니스 로직, 규정 준수 요구사항
MCP로 내부 문서에 접근하기
- 모델은 네 조직의 내부 컨벤션을 추측할 수 없어
- 커스텀 서비스의 API 문서는 공개되어 있지 않아
- 비즈니스 로직과 도메인 지식은 조직마다 고유해
- 컴플라이언스와 보안 요구 사항은 회사마다 달라
일반적인 MCP 연동
Integration | Access | Examples |
---|---|---|
Confluence | 회사 Confluence 스페이스 | 아키텍처 문서, 내부 서비스용 API 스펙, 코딩 표준과 가이드라인, 프로세스 문서 |
Google Drive | 공유 문서와 폴더 | 스펙 문서, 미팅 노트와 의사결정 기록, 설계 문서와 요구사항, 팀 지식베이스 |
Notion | 워크스페이스 데이터베이스와 페이지 | 프로젝트 문서, 팀 위키, 지식베이스, 제품 요구사항, 기술 스펙 |
Custom | 내부 시스템과 데이터베이스 | 사내 전용 API, 레거시 문서 시스템, 커스텀 지식베이스, 특화된 도구와 워크플로 |
커스텀 솔루션
- 내부 웹사이트나 포털 스크레이핑
- 전용 데이터베이스에 연결
- 커스텀 문서 시스템에 접근
- 내부 위키나 지식베이스에서 가져오기
커스텀 MCP 서버를 만들면, Cursor가 문서를 업데이트할 수 있는 툴도 노출할 수 있어
문서를 최신 상태로 유지하기
기존 코드에서
@
이 Express 라우터의 API 문서를 생성해. 모든 엔드포인트, 매개변수, 응답 형식을 포함해
∞
Agent⌘I
Auto
채팅 세션에서
복잡한 문제를 해결한 뒤:
@
팀 위키에 올릴 인증 설정 단계별 가이드를 우리 대화 내용으로 요약해 줘
∞
Agent⌘I
Auto
핵심 정리
- 문서를 컨텍스트로 쓰면 Cursor의 정확도와 최신성이 더 좋아져
- 공식 문서는
@Docs
, 커뮤니티 지식은@Web
을 써 - MCP는 Cursor와 내부 시스템을 이어주는 다리야
- 지식을 최신으로 유지하려면 코드와 대화에서 문서를 생성해
- 폭넓게 이해하려면 외부와 내부 문서 소스를 함께 활용해