AI용 검색엔진 Exa를 Spark 도구로 붙이는 초보자 튜토리얼
Exa는 AI가 쓰기 좋게 만든 웹 검색엔진입니다. 검색 결과를 링크 목록이 아니라 바로 읽을 수 있는 깔끔한 본문으로 돌려줍니다. Gemini Spark에 연결하면 조사, 트렌드 추적, 경쟁 분석 같은 일을 더 깊고 정확하게 맡길 수 있습니다.
난이도: 쉬움 (코드 없음, Exa 가입 1회). 걸리는 시간: 약 5분.
1. 완성하면 무엇이 달라지나
전에는
- Spark가 웹을 찾아볼 수는 있지만, 검색 결과의 질이나 깊이를 조절하기 어려웠습니다.
- 여러 사이트를 비교하는 조사는 검색 → 링크 열기 → 읽기 → 정리를 사람이 반복해야 했습니다.
이제는
@Exa로 AI용 검색을 직접 시킬 수 있습니다. 결과가 본문 형태로 와서 Spark가 바로 읽고 정리합니다.- 특정 URL 여러 개를 한 번에 읽혀서 비교하게 할 수 있습니다.
- 로그인 방식으로 연결했기 때문에 **여러 단계 조사를 알아서 해 주는
agent_run**까지 쓸 수 있습니다.
2. 먼저 알아둘 개념
| 용어 | 쉬운 설명 |
|---|---|
| Exa | AI를 위한 검색엔진. 키워드가 아니라 “이런 페이지를 찾아줘”처럼 설명으로 검색하는 데 강합니다. |
| Exa MCP | Exa 검색을 AI 도구로 쓸 수 있게 열어 둔 창구. 주소는 https://mcp.exa.ai/mcp |
| OAuth(로그인 연결) | 비밀번호를 넘기지 않고 “이 앱이 내 계정을 써도 된다”고 허락하는 방식. 우리가 흔히 보는 “Google로 로그인”이 이 방식입니다. |
| 크레딧 | Exa 사용량을 계산하는 단위. 새 계정에는 무료 크레딧이 들어 있습니다. |
3. 준비물
- ☐ Gemini Spark를 쓸 수 있는 개인 구글 계정 (Google AI Pro/Ultra)
- ☐ Gemini 설정에서 Keep Activity(활동 기록 유지) 켜기
- ☐ Exa 계정 (없으면 연결 과정에서 Google 계정으로 바로 가입할 수 있습니다)
4. 연결 방식 3가지 이해하기
Exa MCP는 3가지 방식으로 쓸 수 있습니다.
| 방식 | 특징 | 쓸 수 있는 도구 |
|---|---|---|
| 키 없이(Keyless) | 가입 없이 무료. 대신 사용량 제한이 있음 | web_search_exa, web_fetch_exa |
| 로그인(OAuth) | Exa 계정으로 로그인. 사용량은 내 Exa 계정에 기록 | 위 2개 + agent_run |
| API 키 | 로그인 연결을 지원하지 않는 프로그램용 | 위와 같음 |
Spark에서는 로그인(OAuth) 방식으로 연결됩니다. 주소만 넣어도 Spark가 Exa의 로그인 절차를 자동으로 시작합니다. 결과적으로 가장 기능이 많은 형태로 연결됩니다.
5. 1단계: Spark에 주소 넣기
- https://gemini.google.com/spark/apps 로 갑니다. (Gemini 왼쪽 메뉴 Spark → Connected Apps)
- Custom apps 섹션에서 Add a custom app을 누릅니다.
- MCP Server URL에 아래 주소를 넣고 Next를 누릅니다.
https://mcp.exa.ai/mcp - “Connect this MCP server” 안내문을 읽고 “I understand and accept…” 체크 → Connect
6. 2단계: 구글 계정 연결 동의
Connect를 누르면 한국어로 이런 창이 뜹니다.
Google 계정과 [Custom] Exa 계정 연결하기 Google에서 다음 작업을 할 수 있습니다.
- 모델 컨텍스트 프로토콜(MCP) 서버 도구 실행
- [Custom] Exa에서 데이터 검색 및 관리
- [Custom] Exa에 데이터 공유
내용을 확인하고 동의 및 계속을 누릅니다.
이 창은 “Gemini(Google)가 Exa 계정을 대신 써도 되는가”를 묻는 것입니다. Exa에 구글 비밀번호가 넘어가지 않습니다.
7. 3단계: Exa 로그인(가입)
페이지가 **Exa 로그인 화면(“Get started with Exa”)**으로 바뀝니다.
- Continue with Google을 누릅니다. (이메일로 가입해도 됩니다)
- 구글 계정 선택 화면에서 Spark와 같은 계정을 고릅니다.
- “Google will allow Exa to access this info about you”(이름, 프로필 사진, 이메일) 화면에서 Continue를 누릅니다.
- Exa 계정이 없었다면 이 과정에서 자동으로 가입되고 무료 크레딧이 들어갑니다.
로그인이 끝나면 자동으로 Gemini Spark 페이지로 돌아옵니다. 주소창에 custom_mcp_action=auth_complete가 보이면 인증이 끝난 것입니다.
8. 4단계: 저장하고 확인하기
- “Save your custom app” 창이 뜹니다.
- App name:
Exa - Available actions:
web_search_exa,web_fetch_exa,agent_run
- App name:
- Connect를 누릅니다.
- Custom apps 목록에
Exa가 켜진 상태로 보이면 성공입니다.
| 도구 | 하는 일 | 주로 쓰는 입력 |
|---|---|---|
web_search_exa |
웹 검색 후 결과 본문을 깔끔한 텍스트로 가져옴 | 검색어(설명형), 결과 수 |
web_fetch_exa |
알고 있는 URL(여러 개 가능)의 본문을 마크다운으로 읽음 | URL 목록 |
agent_run |
여러 번 검색하고 확인하는 다단계 조사를 알아서 수행. 목록 만들기, 조건 검증, 표 형태 결과에 강함 | 조사 요청 |
9. 5단계: 실제로 써보기
Spark 대화창에서 @Exa를 붙여 물어봅니다.
검색 요령: 키워드보다 “원하는 페이지를 설명”하세요.
- 약함:
AI 에이전트 교육 - 강함:
@Exa 초등 영어 교사가 수업에 AI 에이전트를 쓴 실제 사례를 소개한 블로그 글
조사
@Exa 이번 주에 공개된 오픈소스 AI 코딩 에이전트 출시 소식 찾아서 5줄 요약@Exa Teachers Pay Teachers에서 잘 팔리는 novel study 상품의 공통 특징을 다룬 글 찾아줘
URL 읽기
@Exa 이 3개 페이지 읽고 가격과 기능 비교표 만들어줘: (URL1) (URL2) (URL3)
다단계 조사 (agent_run)
@Exa 한국 학원용 AI 도입 컨설팅 서비스를 하는 회사 10곳을 찾아서 이름, 사이트, 가격 공개 여부를 표로 정리해줘
다른 앱과 섞어 쓰기
@Exa 로 오늘 AI 뉴스 3개 찾아서 요약한 뒤 구글 문서로 저장해줘매일 오후 12시에 @Exa 로 새 AI 모델 출시 소식을 찾아서 내 Gmail로 보내줘(Spark 예약 작업)
10. 이걸로 무엇을 할 수 있게 되었나
10-1. 더 정확한 조사
설명형 검색이라 “딱 이런 글”을 찾는 데 강합니다. 결과를 본문으로 받아서 Spark가 출처를 읽고 정리하므로, 링크만 나열하는 답보다 쓸모 있습니다.
10-2. 트렌드와 신규 출시 추적
AI 도구, 모델 출시처럼 빠르게 바뀌는 주제를 Spark 예약 작업과 묶으면 매일 자동 브리핑이 됩니다. SNS에 올릴 인사이트 글의 재료 모으기에도 좋습니다.
10-3. 시장과 경쟁 조사
TPT 같은 마켓의 경쟁 상품, 비슷한 서비스의 가격 정책, 사례 수집을 agent_run으로 표 형태까지 한 번에 받을 수 있습니다.
10-4. 여러 페이지 비교
web_fetch_exa로 URL 여러 개를 한 번에 읽혀 비교표를 만들 수 있습니다. 도구 카탈로그 정리, 서비스 비교 글 작성에 유용합니다.
10-5. 다른 앱과 조합
| 조합 | 할 수 있는 일 |
|---|---|
| Exa + Moonlight Ops | 내 시트의 시리즈 목록과 웹의 경쟁 상품을 비교 |
| Exa + Hugging Face | 뉴스로 새 모델을 찾고, HF에서 모델 카드 확인 |
| Exa + DeepWiki | 뉴스에 나온 오픈소스 레포의 실제 구조 확인 |
| Exa + Google Docs/Gmail | 조사 결과를 문서로 저장하거나 메일로 발송 |
11. 실제로 겪은 문제와 해결법
문제 1. “로그인 없이 된다더니 로그인 화면이 떠요”
- 이유: Exa 서버는 키 없이도 동작하지만, 로그인 방식도 함께 알려 줍니다. Spark는 이걸 보고 자동으로 로그인 절차를 진행합니다.
- 정리: Spark에서는 Exa 가입(또는 로그인)이 필요하다고 생각하면 됩니다. 대신
agent_run까지 쓸 수 있게 됩니다.
문제 2. 연결 도중 엉뚱한 확인창(“Google Workspace를 Gemini에서 연결 해제하시겠어요?”)이 떴어요
- 상황: 저희 작업 중 한 번 Exa 연결 창과 겹쳐서 이 확인창이 떴습니다.
- 해결: **Cancel(취소)**을 눌렀고, Google Workspace 연결은 그대로 유지됐습니다.
- 교훈: 연결 중에 예상하지 못한 “연결 해제”, “Disconnect” 창이 뜨면 무조건 취소하세요.
문제 3. 로그인 후 원래 화면으로 안 돌아온 것 같아요
- 확인: 주소창에
custom_mcp_action=auth_complete가 있으면 인증은 끝난 상태입니다. 잠시 기다리면 “Save your custom app” 창이 뜹니다. - 해결: 창이 안 뜨면 Connected Apps 페이지를 새로고침해서 Exa가 목록에 있는지 확인하세요. 없으면 5단계부터 다시 합니다.
그 밖에
| 증상 | 해결 |
|---|---|
| Custom apps 메뉴가 없음 | 개인 계정인지, Spark 권한과 Keep Activity가 켜져 있는지 확인 |
agent_run이 안 보임 |
로그인 없이 연결된 경우입니다. 앱을 지우고 다시 연결해서 Exa 로그인까지 마치세요 |
| 결과가 엉뚱함 | 키워드 대신 “원하는 페이지를 설명”하는 문장으로 검색 |
12. 비용과 주의할 점
- 무료 크레딧: 새 Exa 계정에는 무료 크레딧이 들어 있습니다. 로그인 방식에서는 사용량이 내 Exa 계정에 기록됩니다.
agent_run은 사용량 기반 과금입니다. 여러 번 검색하는 만큼 크레딧을 더 씁니다. 큰 조사를 자주 맡긴다면 https://dashboard.exa.ai 에서 남은 크레딧을 가끔 확인하세요.- 예약 작업 주의: 매일 도는 Spark 예약 작업에
agent_run을 넣으면 크레딧이 꾸준히 나갑니다. 일상 브리핑은web_search_exa위주로 요청하는 것이 경제적입니다. - 보내는 검색어는 외부 서버로 갑니다. Google은 맞춤 앱으로 연결한 외부 서버를 검토하거나 보호하지 않는다고 안내합니다. 개인정보나 내부 기밀을 검색어에 넣지 마세요.
- 연결 해제: Connected Apps → Exa → More details → Disconnect 또는 Remove app
13. 더 나아가기: 고급 검색 도구 켜기
Exa에는 기본으로 꺼져 있는 **web_search_advanced_exa**가 있습니다. 도메인 지정, 날짜 범위, 카테고리, 지역 같은 세밀한 필터를 쓸 수 있습니다.
주소 뒤에 tools 값을 붙여서 켤 수 있습니다.
https://mcp.exa.ai/mcp?tools=web_search_exa,web_fetch_exa,web_search_advanced_exa,agent_run
tools를 적으면 기본 목록을 대체하므로, 쓰고 싶은 도구를 전부 적어야 합니다.- 적용하려면 Spark에서 기존 Exa 앱을 지우고 이 주소로 다시 연결합니다.
- 참고: 이 확장 주소로 Spark에 연결하는 과정은 이번 작업에서 직접 테스트하지 않았습니다. 기본 연결이 잘 되고 있다면 필요할 때만 시도하세요.
14. 자주 묻는 질문
Q. Gemini에도 검색 기능이 있는데 왜 Exa를 붙이나요?
Exa는 “설명형 검색”과 “본문 그대로 받기”에 특화돼 있어서, 깊은 조사나 여러 페이지 비교에서 차이가 납니다. 두 가지를 같이 두고 목적에 따라 @Exa를 지정해 쓰면 됩니다.
Q. Claude나 Cursor에서도 쓸 수 있나요?
네. 같은 주소 https://mcp.exa.ai/mcp를 각 도구의 MCP 설정에 넣으면 됩니다. 로그인을 원하면 https://mcp.exa.ai/mcp?login 주소를 씁니다.
Q. 가입한 Exa 계정은 어디서 관리하나요? https://dashboard.exa.ai 에서 사용량, 크레딧, API 키를 관리합니다.
작성: 2026-09-28. 실제 Spark 연결 과정(구글 계정 연결 동의, Exa Google 로그인)과 Exa 공식 문서 기준.
Gemini Spark 맞춤 앱 연결 시리즈