Claude와 Brave Search Engine: Model Context Protocol(MCP)의 실제 적용 사례

최근 AI 산업에서 주목받고 있는 Model Context Protocol(MCP)은 AI 모델과 외부 서비스 간의 통합을 위한 표준화된 프로토콜입니다. 이 글에서는 Anthropic의 Claude(Desktop 설치버전)와 Brave Search Engine의 연결 사례를 통해 MCP가 실제로 어떻게 작동하는지 살펴보겠습니다.

Model Context Protocol(MCP)이란?

MCP는 AI 모델이 외부 도구나 서비스와 안전하고 효율적으로 상호작용할 수 있게 해주는 프로토콜입니다. 이를 통해 AI 모델은 자체적으로 가지고 있지 않은 최신 정보나 특정 기능에 접근할 수 있게 됩니다. MCP는 크게 MCP 서버와 MCP 클라이언트로 구성됩니다.

Claude와 Brave Search의 MCP 구현

Claude와 Brave Search Engine의 연결에서:

MCP 클라이언트: Claude AI 모델이 MCP 클라이언트 역할을 수행합니다.
MCP 서버: Brave Search Engine이 MCP 서버 역할을 담당합니다.

절차는 다음과 같습니다.

MCP 연결 및 작동 플로우

Claude와 Brave Search Engine이 MCP를 통해 연결되는 과정은 다음과 같습니다:

초기화 및 연결 설정: Claude(MCP 클라이언트)가 Brave Search(MCP 서버)에 연결 요청을 보냅니다.
인증 및 권한 확인: 보안 토큰 교환을 통해 Claude가 Brave Search에 접근할 권한이 있는지 확인합니다.
기능 탐색: Claude는 Brave Search가 제공하는 API 기능과 파라미터를 확인합니다.
사용자 쿼리 처리: 사용자가 Claude에게 최신 정보를 요청하면, Claude는 이 요청이 외부 검색이 필요하다고 판단합니다.
MCP 요청 생성: Claude는 MCP 프로토콜에 맞는 형식으로 검색 요청을 구성합니다.

// Claude가 Brave Search에 보내는 MCP 요청 예시
{
  "request_id": "query_12345",
  "action": "search",
  "parameters": {
    "query": "최신 인공지능 기술 동향",
    "count": 5,
    "language": "ko"
  }
}

MCP 서버 처리: Brave Search는 요청을 받아 처리하고 검색 결과를 반환합니다.
응답 통합: Claude는 받은 검색 결과를 자신의 지식과 통합하여 사용자에게 최신 정보가 포함된 응답을 제공합니다.

// Brave Search가 Claude에게 반환하는 MCP 응답 예시
{
  "request_id": "query_12345",
  "status": "success",
  "results": [
    {
      "title": "2023년 주목할 인공지능 기술 5가지",
      "url": "https://example.com/ai-trends-2023",
      "snippet": "올해 주목받는 AI 기술로는 생성형 AI, 멀티모달 학습...",
      "published_date": "2023-08-15"
    },
    // 추가 검색 결과들...
  ]
}

1. Brave Search API 키 얻기

먼저 Brave Search API에 접근하기 위한 API 키가 필요합니다:

Brave Search API 웹사이트를 방문합니다 https://brave.com/search/api/
계정에 가입하거나 로그인합니다
적절한 플랜을 선택합니다 (무료 티어는 월 2,000회 쿼리 지원), 추가 결제할 카드 정보를 등록해줘야 키를 생성할 수 있습니다.
API 키를 생성하고 안전하게 저장해둡니다

2. Claude 데스크톱 구성 파일 설정하기

Claude 데스크톱 앱의 구성 파일을 찾아 Brave Search MCP 서버 설정을 추가해야 합니다. 그전에 https://claude.ai/download 에서 내 로컬에 download하여 데스크톱 앱 어플리케이션을 설치 완료 합니다. (Mac은 11.0 +, 윈도우 버전은 Intel, AMD 지원)

구성 파일 위치

Claude 데스크톱 구성 파일은 다음 경로에 있습니다:

# Mac OS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
C:\Users\(username)\AppData\Roaming\Claud\claude_desktop_config.json

Brave Search MCP 서버 구성 추가하기

텍스트 에디터로 구성 파일을 엽니다:

code ~/Library/Application\\ Support/Claude/claude_desktop_config.json

다음 구성을 파일에 삽입하거나 병합합니다:


{
    "mcpServers": {
        "brave-search": {
            "command": "npx",
            "args": [
                     "-y",
                     "@modelcontextprotocol/server-brave-search"
            ],
            "env": {
                     "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
                    }
         }
    }
}

이 구성에서 YOUR_API_KEY_HERE 부분을 1단계에서 얻은 실제 API 키로 교체해야 합니다.

만약 다른 MCP 서버를 추가하려면, mcpServers: { } 의 안에 정보를 추가하면 됩니다.

처음부터 구성 파일 생성하기

구성 파일이 없거나 처음부터 새로 만들고 싶다면 다음 명령어를 사용할 수 있습니다:

cat > ~/Library/Application\\ Support/Claude/claude_desktop_config.json << ‘EOL’ { “mcpServers”: { “brave-search”: { “command”: “npx”, “args”: [ “-y”, “@modelcontextprotocol/server-brave-search” ], “env”: { “BRAVE_API_KEY”: “YOUR_API_KEY_HERE” } } } }

이 명령어는 Unix/Linux의 cat 명령어와 “here document”(heredoc) 구문을 사용하여 한 번에 구성 파일을 생성합니다. 명령어를 실행하기 전에 YOUR_API_KEY_HERE를 실제 API 키로 교체하세요.

3. Claude 데스크톱 재시작하기

구성 파일을 저장한 후에는 Claude 데스크톱 앱을 완전히 재시작해야 합니다:

Claude 데스크톱 앱을 종료합니다 (macOS에서는 ⌘+Q)
앱을 다시 실행하여 새 구성을 로드합니다

단순히 창을 닫는 것이 아니라 완전히 종료한 후 다시 실행해야 변경 사항이 적용됩니다.

이때, 반드시 사전에 체크해야 할것은 앞서 설정한 서버를 실행하기 위해 node.js의 설치가 반드시 필요합니다.
npx 실행을 통해서 서버에 필요한 코드를 받아서 반영되므로, 반드시 node 설치 여부를 확인하고, 미설치 시, https://nodejs.org/ 방문을 통해서 설치 되도록 해주세요.

연동 테스트하기

이제 Claude와 Brave Search의 연동이 제대로 작동하는지 테스트해 볼 수 있습니다.

주식 시세를 검색하여 결과를 불러옵니다.

기본 명령어 예시

웹 검색: “생성형 AI의 최근 트렌드를 검색해줄래?”

지역 검색: “[당신의 위치] 근처 레스토랑을 찾아줘.”

Claude가 관련 검색 결과를 가져오는지 확인하세요. 제대로 작동한다면 Claude는 Brave Search를 통해 검색한 정보를 기반으로 답변을 제공할 것입니다.

MCP 사용의 의미와 장점

Claude와 Brave Search Engine의 MCP 연결은 다음과 같은 중요한 의미를 갖습니다:

1. 최신 정보 접근성 향상

Claude는 학습 데이터의 시간적 제약을 넘어 Brave Search를 통해 최신 정보에 접근할 수 있게 됩니다. 이는 “AI 할루시네이션” 문제를 줄이고 더 정확한 정보를 제공하는 데 도움이 됩니다.

2. 프라이버시 중심 설계

Brave는 프라이버시 중심 브라우저로 알려져 있으며, MCP 연결을 통해 Claude 사용자들은 개인정보 보호에 중점을 둔 검색 결과를 얻을 수 있습니다.

3. 표준화된 인터페이스

MCP는 표준화된 프로토콜을 제공하여 Claude가 Brave Search 외에도 다른 서비스와 쉽게 연결될 수 있는 기반을 마련합니다.

4. 확장성과 유연성

MCP는 Claude가 단순 검색을 넘어 다양한 기능(이미지 검색, 뉴스 필터링 등)을 활용할 수 있게 해줍니다.

MCP의 기술적 구현 세부사항

Claude와 Brave Search의 MCP 구현에는 다음과 같은 기술적 요소들이 포함됩니다:

API 게이트웨이: 요청과 응답을 관리하고 보안을 유지합니다.
JSON 기반 통신: 구조화된 데이터 교환을 위해 JSON 형식을 사용합니다.
비동기 처리: 사용자 경험을 방해하지 않도록 비동기적으로 요청을 처리합니다.
오류 처리 메커니즘: 연결 실패나 검색 오류 시 적절한 대응을 제공합니다.

// MCP 오류 처리 예시
try {
  const searchResults = await braveSearchClient.query(userQuery);
  return processResults(searchResults);
} catch (error) {
  if (error.type === 'CONNECTION_ERROR') {
    return "죄송합니다. 현재 검색 서비스에 연결할 수 없습니다. 잠시 후 다시 시도해주세요.";
  } else if (error.type === 'NO_RESULTS') {
    return "검색 결과가 없습니다. 다른 키워드로 시도해보시겠어요?";
  }
  // 기타 오류 처리
}

결론: MCP의 미래와 가능성

Claude와 Brave Search Engine의 MCP 연결 사례는 AI 모델이 외부 서비스와 안전하게 상호작용하는 방식의 중요한 이정표입니다. 이러한 통합은 AI의 유용성과 정확성을 크게 향상시키며, 사용자에게 더 풍부한 경험을 제공합니다.

앞으로 MCP는 더 많은 서비스와 도구로 확장되어 AI 모델의 기능을 확장하고, 사용자의 다양한 요구를 충족시키는 데 중요한 역할을 할 것으로 기대됩니다. 이는 단순한 기술적 연결을 넘어, AI 시스템이 더 개방적이고 유용한 방향으로 발전하는 패러다임의 변화를 의미합니다.

게시됨

2025년 04월 03일

카테고리

작성자

choonzang

태그:

AI, brave search engine, claude, MCP, MCP Server, node.js, 미친프로토콜, 엠씨피