Claude Code용 Exa MCP: 깨끗한 페이지 콘텐츠를 제공하는 AI 네이티브 웹 검색 (API 키 불필요)

Claude Code에게 지난달에 출시된 라이브러리에 대해 물어보면, 두 가지 중 하나가 발생합니다. 이미 오래된 학습 데이터로 답변하거나, 검색을 수행하여 링크 목록과 스니펫으로 돌아온 다음 이를 하나씩 가져와야 합니다. 어느 쪽이든 답이 있는 페이지로 유도하는 데 몇 차례의 대화 턴을 사용하게 됩니다.

Exa MCP는 Claude Code를 AI 에이전트를 위해 구축된 검색 엔진인 Exa에 연결합니다. web_search_exa는 열 개의 파란색 링크 대신 읽기 쉬운 깨끗한 페이지 콘텐츠를 반환하고, web_fetch_exa는 모든 URL을 Markdown으로 변환합니다. 이는 호스팅되는 서버이므로 설정은 한 번의 명령어로 끝나며, 시작할 때 API 키가 필요하지 않습니다.

이미 저희 Firecrawl MCP 가이드를 사용하고 계신가요? 이들은 잘 어울립니다. Exa는 올바른 페이지를 찾는 데 가장 적합하며, Firecrawl은 어디를 봐야 할지 알게 된 후 JavaScript가 많은 사이트를 스크래핑하는 데 적합합니다.

빠른 시작 (Quick Start)

키 없이 한 번의 명령어로 설정할 수 있습니다:

claude mcp add --transport http --scope user exa https://mcp.exa.ai/mcp

Claude Code를 재시작하고 claude mcp list를 실행합니다. 총 시간: 약 1분입니다. 키가 없어도 Exa의 호스팅 서버는 초당 약 2개의 요청과 IP당 하루 50개의 요청을 허용하므로, 한도에 도달하면 나중에 API 키를 추가할 수 있습니다.

⚡ 이 프롬프트를 복사하세요: Claude Code가 직접 설치하고 확인하도록 하세요

아래의 수동 단계를 건너뛰고 전체 작업을 에이전트에게 맡기세요:

You는 셸 접근 권한과 이 기계에서 `claude mcp` CLI를 가지고 있습니다. Exa MCP 서버를 Claude Code에 연결하고 보고해 주세요. 단계 4가 실제로 확인하지 않는 한, 완료되었다고 말하지 마십시오:

1. `claude mcp list`를 실행합니다. 만약 exa 항목이 이미 존재한다면, 두 번째 것을 추가하는 대신 그 URL을 보여주고 중단하십시오.
...

마지막 단계는 실제 검색 후 읽기 테스트이므로, 실제로 작업에 사용하기 전에 Exa의 출력을 확인할 수 있습니다.

필요한 것 (What You’ll Need)

단계별 설정 (Step-by-Step Setup)

에이전트에게 위임하는 것보다 직접 수동으로 처리하는 것을 선호하시나요? 여기 수동 버전이 있습니다.

1단계 — 호스팅 서버 추가

~30초

--scope user를 사용하면 Exa가 모든 프로젝트에서 사용할 수 있게 됩니다:

claude mcp add --transport http --scope user exa https://mcp.exa.ai/mcp

플러그인을 선호하시나요? Exa는 공식 Claude 플러그인 마켓플레이스에도 있으며, 여기서는 동일한 도구 위에 검색 스킬을 추가합니다:

claude plugin install exa@claude-plugins-official

실제 실행, 2026년 10월, API 키 불필요: Exa는 무료 티어에서 바로 연결됩니다.

2단계 — API 키 추가 (선택 사항)

~2분

dashboard.exa.ai/api-keys에서 키를 생성하고, claude mcp remove exa --scope user로 익명 항목을 제거한 다음, 헤더로 키를 지정하여 다시 추가합니다:

claude mcp add --transport http --scope user exa https://mcp.exa.ai/mcp \
  --header "x-api-key: <your-exa-api-key>"

Exa는 URL 매개변수로도 키를 받지만, 헤더로 지정하면 로그와 셸 기록에서 제외됩니다.

3단계 — 고급 검색 활성화 (선택 사항)

~30초

기본적으로 web_search_exa와 web_fetch_exa가 제공됩니다. 도메인, 날짜, 하이라이트 필터를 위해 web_search_advanced_exa를 추가합니다. tools 매개변수는 기본값을 대체하므로 원하는 모든 도구를 나열해야 합니다:

claude mcp add --transport http --scope user exa \
  "https://mcp.exa.ai/mcp?tools=web_search_exa,web_fetch_exa,web_search_advanced_exa"

Exa는 검색 결과를 Claude Code가 실제로 사용할 수 있는 깨끗한 페이지 텍스트로 변환합니다.

각 부분이 하는 역할

실제로 작동하는지 확인하기

claude mcp list

✔ exa    https://mcp.exa.ai/mcp (HTTP) – 연결됨

! exa    rate limit errors  → API 키 추가하기 (2단계)

✘ exa    Failed to connect  → URL이 /mcp로 끝나는지 확인하고, ?tools=가 있는 경우 따옴표로 감싸주세요.

그다음 Claude에게 학습 데이터로는 답변할 수 없는 질문을 던져보세요:

Use Exa to find what changed in the latest release of the framework this repo uses, and tell me if any of it affects our code

Claude가 web_search_exa를 호출하고, 결과를 읽고, 최근 몇 주간의 URL을 인용한다면 작동하는 것입니다.

피해야 할 일반적인 실수들

• 고급 도구만 추가하기. ?tools=web_search_advanced_exa는 기본값을 _대체_하므로, 기본적인 검색 및 가져오기 기능이 사라집니다. 원하는 모든 도구를 쉼표로 구분된 값으로 나열하세요.
• URL을 따옴표로 감싸지 않기. URL의 ?나 & 기호는 셸에서 인식되지 않을 수 있습니다. 매개변수가 있는 경우 항상 URL을 따옴표로 감싸주세요.
• API 키를 URL에 넣기. 작동은 하지만, 키가 Claude Code 설정과 셸 기록에 평문으로 노출됩니다. x-api-key 헤더를 사용하세요.
• 두 번 등록하기. 플러그인을 설치하고 claude mcp add를 실행하면 Claude에게 모든 Exa 도구의 두 복사본이 주어집니다. 하나만 선택하세요.
• 검색 결과를 맹신하기. 웹 페이지에는 프롬프트 인젝션(prompt-injection) 텍스트가 포함될 수 있습니다. Claude에게 출처를 인용하도록 요청하고, 읽은 내용을 기반으로 실행하려는 모든 것을 검토하세요.

Q&A

무료인가요?

키 없이 연결하여 검색할 수 있으며, 초당 약 2회, 하루 50회로 제한됩니다. 사용자 자신의 키를 사용하면 이 제한이 해제됩니다. 더 많은 사용량이나 Exa Agent의 경우, Exa 대시보드에서 키를 생성하고 최신 가격 정보를 확인하세요.

Claude Code에 이미 웹 검색 기능이 있지 않나요?

그렇습니다. Exa는 검색 결과와 함께 정리된 페이지 콘텐츠를 반환하고 필터 및 리서치 에이전트를 추가하는 대안입니다. 많은 사람들이 둘 다 사용하며 Claude에게 언제 Exa를 사용할지 알려줍니다.

Exa vs Firecrawl?

Exa는 페이지를 찾고 텍스트로 읽어오는 데 적합합니다. Firecrawl은 JavaScript 렌더링이 필요한 사이트를 스크래핑하거나 전체 사이트를 크롤링하는 데 적합합니다. 둘은 충돌하지 않습니다.

키 대신 로그인할 수 있나요?

네. Exa는 OAuth를 지원합니다. URL에 ?login을 추가하면 로그인 흐름이 강제되며, 이는 Claude Code에서 /mcp로 완료할 수 있습니다.

어떻게 제거하나요?

claude mcp remove exa --scope user를 사용하세요. 만약 API 키를 생성했다면 Exa 대시보드에서 이를 취소(revoke)하세요.

공식 자료

• exa-labs/exa-mcp-server on GitHub — 도구, 매개변수 및 인증 옵션
• Exa MCP 문서 — 공식 참고 자료
• Exa API 키 — 더 높은 한도를 위해 키 생성
• Claude Code MCP 문서 — claude mcp add 옵션 및 헤더

원래 quickpromptco.com에 게시되었으며, 가이드는 해당 페이지에서 최신 상태로 유지됩니다.