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에 주소 넣기

  1. https://gemini.google.com/spark/apps 로 갑니다. (Gemini 왼쪽 메뉴 Spark → Connected Apps)
  2. Custom apps 섹션에서 Add a custom app을 누릅니다.
  3. MCP Server URL에 아래 주소를 넣고 Next를 누릅니다.
    https://mcp.exa.ai/mcp
  4. “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”)**으로 바뀝니다.

  1. Continue with Google을 누릅니다. (이메일로 가입해도 됩니다)
  2. 구글 계정 선택 화면에서 Spark와 같은 계정을 고릅니다.
  3. “Google will allow Exa to access this info about you”(이름, 프로필 사진, 이메일) 화면에서 Continue를 누릅니다.
  4. Exa 계정이 없었다면 이 과정에서 자동으로 가입되고 무료 크레딧이 들어갑니다.

로그인이 끝나면 자동으로 Gemini Spark 페이지로 돌아옵니다. 주소창에 custom_mcp_action=auth_complete가 보이면 인증이 끝난 것입니다.

8. 4단계: 저장하고 확인하기

  1. “Save your custom app” 창이 뜹니다.
    • App name: Exa
    • Available actions: web_search_exa, web_fetch_exa, agent_run
  2. Connect를 누릅니다.
  3. 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 공식 문서 기준.