Gemini Spark에 DeepWiki 연결하기

2026.09.28 · 작성: moonlang

깃허브 레포를 "읽어주는 AI 위키"를 Spark 도구로 붙이는 초보자 튜토리얼

DeepWiki는 공개 깃허브 레포를 자동으로 분석해서 위키(구조 설명, 문서, 다이어그램)를 만들어 주는 서비스입니다. 이걸 Gemini Spark에 연결하면, 코드를 직접 열지 않고도 “이 레포 어떻게 돌아가?”라고 물어볼 수 있습니다.

난이도: 가장 쉬움 (로그인, 가입, 코드 없음). 걸리는 시간: 약 3분.

1. 완성하면 무엇이 달라지나

전에는

• 오래 안 건드린 레포를 다시 보려면 README를 읽고, 폴더를 뒤지고, 파일을 하나씩 열어야 했습니다.
• 남의 오픈소스를 쓰려면 문서가 부족할 때 코드를 직접 읽어야 했습니다.

이제는

• Spark에 “@DeepWiki 이 레포 구조 요약해줘”라고 물으면, DeepWiki가 미리 만들어 둔 위키를 근거로 답합니다.
• “이 기능은 어느 파일에서 처리해?” 같은 질문에도 코드 기반으로 답을 받습니다.
• Spark의 다른 앱(Docs, Gmail 등)과 묶어서 “레포 요약 문서 만들어줘” 같은 일도 맡길 수 있습니다.

2. 먼저 알아둘 개념

3. 준비물

• ☐ Gemini Spark를 쓸 수 있는 개인 구글 계정 (Google AI Pro/Ultra)
• ☐ Gemini 설정에서 Keep Activity(활동 기록 유지) 켜기
• ☐ 끝. DeepWiki 쪽 가입이나 키는 필요 없습니다.

4. 1단계: 주소 확인하기

DeepWiki MCP 주소는 이것입니다.

https://mcp.deepwiki.com/mcp

• 끝이 /mcp인 주소가 권장 방식(Streamable HTTP)입니다.
• /sse로 끝나는 옛 주소도 있지만 곧 없어질 방식이라 쓰지 않습니다.

5. 2단계: Spark에 추가하기

1. https://gemini.google.com/spark/apps 로 갑니다. (Gemini 왼쪽 메뉴 Spark → Connected Apps)
2. 아래쪽 Custom apps 섹션에서 Add a custom app을 누릅니다.
3. MCP Server URL 칸에 https://mcp.deepwiki.com/mcp를 붙여넣고 Next를 누릅니다.
4. “Connect this MCP server” 안내문이 나옵니다.
   • Gemini가 이 서버의 도구를 실행하고, 데이터를 주고받을 수 있다는 내용입니다.
   • 맨 아래 “I understand and accept…” 체크박스를 누르고 Connect를 누릅니다.
5. 잠시 로딩 후 “Save your custom app” 창이 뜹니다.
   • App name: DeepWiki (자동 입력)
   • Available actions: ask_wiki_question, read_wiki_contents, read_wiki_structure
6. Connect를 누르면 끝입니다.

6. 3단계: 연결 확인하기

Connected Apps 페이지의 Custom apps 목록에 이렇게 보이면 성공입니다.

DeepWiki   @DeepWiki   Last sync (연결한 날짜와 시간)   [켜짐]

More details를 누르면 도구 3개를 볼 수 있습니다.

레포 이름은 항상 소유자/레포 형식입니다. 예: Reasonofmoon/gov-scan-daily

7. 4단계: 내 레포를 DeepWiki에 등록(색인)하기

유명한 오픈소스(React, LangChain 등)는 이미 색인돼 있어서 바로 됩니다. 하지만 내 레포는 대부분 처음엔 색인이 안 돼 있습니다.

실제로 Reasonofmoon/gov-scan-daily를 조회해 보면 이런 답이 옵니다.

Repository not found. Visit https://deepwiki.com/Reasonofmoon/gov-scan-daily to index it.

색인하는 방법

1. 브라우저에서 https://deepwiki.com/소유자/레포로 갑니다.
   • 예: https://deepwiki.com/Reasonofmoon/gov-scan-daily
2. 색인(위키 생성) 요청 버튼이 나오면 누르고 안내를 따릅니다.
3. 생성이 끝날 때까지 기다립니다. 레포 크기에 따라 몇 분 이상 걸릴 수 있습니다.
4. 페이지에 위키가 보이면, 이제 Spark에서도 그 레포를 물어볼 수 있습니다.

8. 5단계: 실제로 써보기

Spark 대화창에서 @DeepWiki를 붙여 물어봅니다. 처음 도구를 쓸 때 Spark가 사용 허락을 물으면 허용합니다.

구조 파악

• @DeepWiki facebook/react 위키 목차 보여줘
• @DeepWiki Reasonofmoon/gov-scan-daily 전체 구조를 초보자 눈높이로 요약해줘

특정 질문

• @DeepWiki langchain-ai/langchain 에서 retriever는 어떤 흐름으로 동작해?
• @DeepWiki 이 레포에서 스케줄 실행은 어느 파일이 담당해? (Reasonofmoon/gov-scan-daily)

다른 앱과 섞어 쓰기

• @DeepWiki 로 Reasonofmoon/gov-scan-daily 구조를 정리해서 구글 문서로 만들어줘
• @DeepWiki 로 레포 3개(A, B, C)를 비교해서 표로 정리해줘

9. 이걸로 무엇을 할 수 있게 되었나

9-1. 오래된 레포 빠르게 복습

레포가 많을수록 “이거 뭐였지?”가 자주 생깁니다. 색인만 해 두면 README보다 자세한 구조 설명을 바로 받을 수 있습니다. 공개 레포 정리(아카이브 후보 고르기, 재활용할 코드 찾기)에 특히 좋습니다.

9-2. 오픈소스 도입 전 조사

새 라이브러리나 AI 도구를 쓰기 전에 “핵심 구조”, “설정 방법”, “확장 포인트”를 먼저 물어보면 문서만 볼 때보다 빠르게 판단할 수 있습니다. AI 도구 카탈로그에 새 도구를 소개할 때 근거 자료로도 쓸 수 있습니다.

9-3. 트렌드 레포 해설

깃허브 급상승 레포를 볼 때, 이름만 보고 넘기지 않고 “이 레포가 실제로 뭘 하는지 3줄 요약”을 받을 수 있습니다. (색인된 레포 기준)

9-4. 다른 도구와 역할 나누기

같은 질문도 목적에 따라 알맞은 도구를 지정(@)하면 답이 더 정확해집니다.

10. 실제로 겪은 문제와 해결법

문제 1. 첫 연결에서 “We had trouble connecting to this server”

• 증상: 주소를 넣고 Connect까지 눌렀는데 오류가 나며 입력 화면으로 돌아왔습니다.
• 확인: 서버에 직접 요청을 보내 보니 DeepWiki는 정상 응답하고 있었습니다.
• 해결: 같은 주소로 한 번 더 시도하니 바로 연결됐습니다. 일시적인 문제였습니다.
• 교훈: 이 오류가 한 번 나왔다고 바로 포기하지 말고, 잠시 후 다시 시도해 보세요.

문제 2. 내 레포를 물어보면 “Repository not found”

• 원인: DeepWiki에 아직 색인되지 않은 레포입니다.
• 해결: 7장 방법으로 deepwiki.com에서 먼저 색인합니다.

그 밖에

11. 한계와 주의할 점

• 공개 레포만 됩니다. 비공개 레포까지 쓰려면 Devin 계정을 만들고 API 키로 연결하는 별도의 Devin MCP가 필요합니다. 비공개 레포는 Github Personal Bridge 같은 다른 도구로 보는 편이 현실적입니다.
• 위키는 색인 시점 기준입니다. 레포를 크게 바꿨다면 deepwiki.com에서 위키를 새로 만들게 해야 최신 내용이 반영됩니다.
• AI가 만든 설명입니다. 중요한 결정(보안, 배포 설정 등)은 답에 나온 파일을 직접 열어 확인하세요.
• 보내는 질문은 외부 서버로 갑니다. Google은 맞춤 앱으로 연결한 외부 서버를 검토하거나 보호하지 않는다고 안내합니다. 민감한 내부 정보를 질문에 넣지 마세요.

12. 자주 묻는 질문

Q. 돈이 드나요? 공개 레포용 DeepWiki와 DeepWiki MCP는 무료입니다.

Q. 연결을 끊고 싶어요. Connected Apps → DeepWiki의 More details → Disconnect 또는 Remove app을 누릅니다. 잠깐만 끄고 싶으면 목록의 스위치만 끄면 됩니다.

Q. Claude나 Cursor에서도 쓸 수 있나요? 네. 같은 주소 https://mcp.deepwiki.com/mcp를 각 도구의 MCP 설정에 넣으면 됩니다. 예: Claude Code는 claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

작성: 2026-09-28. 실제 연결 과정과 도구 목록 확인 결과 기준.