인공지능(AI)의 세계에서 AI 모델에 실시간으로 최신 정보를 제공하는 것은 매우 중요합니다. 이를 가능하게 하기 위해 Claude와 같은 AI 비서는 외부 도구와 API에 접근할 수 있도록 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 서버를 사용할 수 있으며, 이를 통해 실시간으로 웹을 검색하고 구조화된 결과를 가져올 수 있습니다. 이 글에서는 Claude Desktop을 Exa의 강력한 AI 검색 API에 연결하는 Exa MCP 서버의 설치 및 사용법을 안내합니다. 이를 통해 AI 비서는 복잡한 웹 검색을 쉽게 수행할 수 있습니다.
모델 컨텍스트 프로토콜(MCP)이란?
모델 컨텍스트 프로토콜(MCP)은 AI 애플리케이션이 외부 데이터 소스 또는 서비스와 상호작용할 수 있도록 설계된 프레임워크입니다. Claude와 같은 AI 비서가 로컬 서비스나 API와 통신할 수 있도록 하여, 이러한 모델이 사용하는 정보가 최신이고 정확하다는 것을 보장합니다. MCP는 맥락을 전달하는 안전하고 표준화된 방법을 제공하여 AI 모델이 개인 정보나 보안을 손상시키지 않고 여러 소스에서 데이터를 검색할 수 있도록 합니다.
MCP 프로토콜은 Claude와 같은 AI 모델이 웹 검색, 데이터 스크래핑, 특정 서비스 요청 등을 표준화된 방식으로 수행할 수 있는 도구와 통합할 수 있도록 합니다. 예를 들어, MCP 서버는 Claude를 Exa와 같은 API에 연결하도록 구성될 수 있으며, 이는 웹 검색, 데이터 스크래핑 등을 가능하게 합니다. 실시간 웹 검색 기능을 통해 Claude는 사용자에게 웹에서 직접 최신 정보를 제공할 수 있습니다.
Exa MCP 서버는 무엇을 하나요?
Exa MCP 서버는 AI 비서(예: Claude)와 Exa의 AI 기반 웹 검색 기능 간의 다리 역할을 합니다. Exa MCP 서버를 설정함으로써 AI 비서가 다음을 수행할 수 있도록 합니다:
- 실시간 웹 검색 수행: Claude는 Exa의 강력한 검색 API에 쿼리를 보내 실시간으로 최신 정보를 검색할 수 있습니다.
- 구조화된 검색 결과 제공: 서버는 내용 조각, 제목 및 URL과 함께 검색 결과를 반환하여 제공되는 정보가 관련성 있고 실행 가능하도록 합니다.
- 최근 검색 결과 캐싱: 서버는 최근 검색 결과를 캐싱하여 향후 쿼리에 사용할 수 있어 시간을 절약하고 성능을 향상시킵니다.
- 비율 제한 처리: 서버는 비율 제한 및 오류 사례를 처리할 수 있는 메커니즘을 갖추어 검색이 차단되지 않고 오류가 원활하게 처리되도록 합니다.
- 실시간 크롤링 지원: 최신 콘텐츠를 위해 서버는 실시간으로 웹을 크롤링하여 최신 정보를 제공합니다.
이 서버를 구성함으로써 AI 비서에 새로운 가능성을 열어주어 사용자의 쿼리에 답변하거나 연구 및 분석을 수행하는 데 사용할 수 있는 실시간 데이터에 접근할 수 있게 됩니다.
필수 조건
시작하기 전에 몇 가지 준비 사항을 확인해야 합니다. 이러한 필수 조건은 설치 및 설정 중 잠재적인 문제를 피하는 데 도움이 됩니다:
Node.js (v18 이상): 귀하의 기계에 Node.js가 설치되어 있는지 확인하세요. 다음 명령어를 실행하여 버전을 확인할 수 있습니다:
node --version
Node.js가 설치되어 있지 않으면 Node.js 공식 웹사이트를 방문하여 최신 버전을 다운로드하세요.
Claude Desktop 설치 완료: Claude Desktop가 설치되어 있고 준비가 완료되어 있는지 확인하세요. Claude는 웹 검색을 포함하여 다양한 작업에 사용할 수 있는 AI 비서입니다.
Exa API 키: 요청을 인증하기 위해 Exa의 API 키가 필요합니다. API 키가 없는 경우 Exa의 대시보드에 가입하여 키를 받으세요.
Git 설치 완료: Git은 수동 설치 과정 중에 저장소를 클론하는 데 필요합니다. Git이 설치되어 있는지 다음 명령어를 실행하여 확인할 수 있습니다:
git --version
설치
필수 조건이 충족되면 Exa MCP 서버 설치를 시작할 수 있습니다. 서버를 설치하는 두 가지 주요 방법이 있습니다: NPM을 사용하거나 Smithery를 사용하는 방법입니다. 두 가지 방법을 살펴보겠습니다.
1. NPM 설치
빠르고 쉽게 설정하려면 NPM을 사용하여 Exa MCP 서버를 전역적으로 설치할 수 있습니다. 다음 명령어를 실행하세요:
npm install -g exa-mcp-server
이 명령은 Exa MCP 서버를 시스템에 전역적으로 설치하여 어떤 디렉터리에서든 실행할 수 있게 합니다.
2. Smithery 사용
Smithery는 Exa MCP 서버의 설치를 자동화하여 설정을 더욱 쉽게 만들어주는 도구입니다. Smithery를 사용하여 서버를 설치하려면 다음 명령어를 실행하세요:
npx -y @smithery/cli install exa --client claude
이 명령은 필요한 종속성을 자동으로 설치하고 서버를 Claude와 함께 사용할 수 있도록 구성합니다.
3. 수동 설치
서버를 수동으로 설치하거나 설치 프로세스에 대해 더 많은 제어가 필요한 경우 다음 단계를 따르세요:
저장소를 클론합니다:
git clone https://github.com/exa-labs/exa-mcp-server.git
프로젝트 디렉터리로 이동합니다:
cd exa-mcp-server
종속성을 설치합니다:
npm install
프로젝트를 빌드합니다:
npm run build
서버를 어디에서나 실행할 수 있도록 전역 링크를 생성합니다:
npm link
구성
Exa MCP 서버 설치가 완료되면 Claude Desktop이 서버를 인식하고 사용을 시작하도록 구성해야 합니다. 구성 방법은 다음과 같습니다:
1. Claude Desktop 구성
먼저, Claude Desktop에서 개발자 모드를 활성화합니다:
- Claude Desktop을 엽니다.
- 왼쪽 상단 메뉴 바에서 개발자 모드를 활성화합니다.
- 설정으로 이동한 다음, 개발자 옵션으로 이동하여 구성 편집을 클릭합니다. 이렇게 하면
claude_desktop_config.json파일이 열립니다.
또는 터미널을 통해 구성 파일을 직접 열 수 있습니다.
macOS의 경우:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows의 경우:
code %APPDATA%\Claude\claude_desktop_config.json
2. Exa 서버 구성 추가
claude_desktop_config.json 파일에 Exa MCP 서버를 사용하도록 Claude Desktop에 지시하는 다음 구성을 추가합니다:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["/path/to/exa-mcp-server/build/index.js"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
여기서 your-api-key-here를 Exa 대시보드에서 받은 실제 Exa API 키로 교체해야 합니다.
3. 활성화할 도구 선택
Exa MCP 서버에는 필요에 따라 활성화할 수 있는 여러 도구가 포함되어 있습니다. 예를 들어, 웹 검색, 연구 논문 검색, Twitter 검색 및 기업 연구 도구를 사용하려면 구성을 다음과 같이 수정하면 됩니다:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"/path/to/exa-mcp-server/build/index.js",
"--tools=web_search,research_paper_search,twitter_search,company_research,crawling,competitor_finder"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
이 설정은 서버에 사용할 수 있는 모든 도구를 활성화합니다.
4. Claude Desktop 재시작
변경 사항이 적용되려면 Claude Desktop을 재시작해야 합니다:
- Claude Desktop을 완전히 종료하십시오(단순히 창을 닫지 마세요).
- 다시 엽니다.
- Exa 서버가 연결되었다는 것을 나타내는 🔌 아이콘이 보일 것입니다.
Exa MCP 서버가 구성되고 연결되면 웹 검색을 위해 사용할 수 있습니다. 아래는 Claude와 함께 사용할 수 있는 몇 가지 예제 프롬프트입니다:
- “AI 기반 헬스케어 기술의 최신 동향을 검색해 줄 수 있나요?”
- “재생 가능 에너지 솔루션의 최근 혁신을 찾아 요약해 주세요.”
- “블록체인 기술에 관한 최신 연구 논문을 검색하고 분석해 주세요.”
- “자동차 산업에서 전기차 발전에 대한 최근 뉴스를 찾아 주세요.”
- “개발도상국의 디지털 전환이 경제에 미치는 영향을 조사해 주세요.”
- “Tesla 회사를 조사하고 최신 제품 및 개발 사항에 대한 업데이트를 제공해 주세요.”
- “이 연구 논문의 내용 추출: https://arxiv.org/pdf/1706.03762”
- “exa.ai를 제외하고 웹 검색 API를 제공하는 회사의 경쟁사를 찾아 주세요.”
MCP 검사기를 통한 테스트
MCP 검사기를 사용하여 서버의 기능을 테스트할 수 있습니다. 이 도구는 서버를 탐색하고 검색 쿼리를 실행할 수 있게 해줍니다.
MCP 검사기를 시작하려면 다음 명령어를 실행하세요:
npx @modelcontextprotocol/inspector node ./build/index.js
이 명령은 다양한 검색 쿼리를 테스트하고 결과를 검사하며 사용 가능한 도구를 탐색할 수 있는 대화형 인터페이스를 엽니다.
Apidog MCP 서버 통합으로 AI 자동화 강화하기
당신의 AI 기반 워크플로를 한층 더 발전시키려면 Apidog MCP 서버와 통합하세요.
이 강력한 연결은 AI 비서가 Apidog 프로젝트의 API 사양과 직접 상호작용할 수 있도록 하여 API 탐색, 코드 생성 및 구조화된 모델 생성을 원활하게 해줍니다.
문제 해결
Exa MCP 서버 설치는 일반적으로 간단하지만 몇 가지 일반적인 문제에 직면할 수 있습니다. 다음은 이러한 문제를 해결하기 위한 몇 가지 팁입니다:
1. 서버를 찾을 수 없음
서버를 찾을 수 없는 경우, npm 링크가 올바르게 설정되었는지 및 Claude Desktop의 구성이 올바른지 확인하세요. 구성 파일의 경로를 다시 확인하세요.
2. API 키 문제
Exa API 키에 문제가 있는 경우, 키가 유효하고 claude_desktop_config.json 파일에 올바르게 설정되었는지 확인하세요. API 키 주위에 불필요한 공백이나 따옴표가 없는지 확인하세요.
3. 연결 문제
연결 문제를 겪고 있다면 Claude Desktop을 완전히 재시작하세요. 오류가 있는지 로그를 확인하세요:
macOS의 경우:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Windows의 경우:
type "%APPDATA%\Claude\logs\mcp*.log"
결론
Exa MCP 서버를 설정하면 AI 비서가 Exa의 검색 API를 사용하여 실시간 웹 검색을 수행할 수 있는 강력한 새로운 가능성을 열어줍니다. 따라하기 쉬운 설치 과정, 명확한 구성 단계 및 견고한 기능을 갖춘 Exa MCP 서버는 Claude와 같은 AI 모델이 최신 정보에 접근하고 사용자에게 관련성 있고 최신의 결과를 제공하는 것을 더욱 간단하게 만듭니다. 학술 논문 조사, 기업 분석 수행 또는 최신 뉴스 파악 등 어떤 작업을 하더라도 Exa MCP 서버는 AI 비서가 항상 신선하고 실행 가능한 데이터를 사용할 수 있도록 보장합니다.