초보자도 따라하는 Windsurf AI Editor 실시간 웹 검색 기능 추가하기 (Perplexity 연동)
HandlerOne
2025. 6. 20. 18:05
728x90
Windsurf AI Editor의 잠재력을 200% 끌어올리고 싶으신가요? 이 글에서는 강력한 실시간 검색 AI인 Perplexity를 Windsurf AI Editor에 직접 연동하는 구체적인 방법을 단계별로 안내합니다. 이 가이드를 마치면 여러분의 에디터는 단순한 코딩 툴을 넘어, 최신 정보를 즉시 검색하고 적용하는 강력한 인사이트 엔진으로 거듭날 것입니다.
안녕하세요! Windsurf AI Editor를 사용하면서 '아, 여기서 바로 최신 웹 정보를 검색해서 코드에 적용할 수 있으면 얼마나 좋을까?' 하는 생각, 다들 한 번쯤 해보셨을 거예요. 프로그래밍을 AI가 대신해주는 건 참 좋아졌는데, 실제 개발 해본 분들은 다 아시겠지만, 보통 개발할 때, 브라우저에 google search를 띄워 놓고 필요하거나 모르는 내용은 검색해가면서 개발을 하게되거든요, 그래서 AI로 코딩을 해도 역시 개발 문서를 찾거나 최신 API 사용법을 확인하려면 perplexity 같은 AI 검색 서비스를 띄워놓고 브라우저 또는 앱을 로딩한 상태에서 windsurf 에디터를 수시로 오가는 게 번거로웠거든요. 그러다 Windsurf AI Editor에 Perplexity의 강력한 AI 검색 기능을 연동할 수 있다는 사실을 알게 되었고, 제 개발 생산성은 완전히 달라졌습니다.
처음엔 조금 복잡하게 들릴 수 있지만, 제가 직접 겪은 과정을 그대로 따라오시면 누구든 쉽게 설정하실 수 있습니다. 지금부터 저와 함께 여러분의 Windsurf AI Editor를 한 단계 업그레이드해 보시죠!
1단계: 연동 준비하기 (MCP Plug-in 프로젝트 다운로드 및 빌드) 👨💻
가장 먼저, Windsurf와 Perplexity를 이어주는 다리 역할을 할 Node.js 프로젝트를 우리 컴퓨터에 설치해야 해요. 이 프로젝트는 둘 사이의 통신을 원활하게 해주는 필수 요소입니다. 아래 명령어를 차례대로 터미널(PowerShell 또는 cmd)에서 입력하고 '엔터'를 쳐서 실행시켜 연동을 위한 MCP프로젝트를 빌드해주세요.
💡 알아두세요! 위 명령어를 실행하려면 컴퓨터에 Git과 Node.js(npm 포함)가 미리 설치되어 있어야 합니다. 설치되어 있지 않다면 공식 홈페이지에서 먼저 설치를 진행해주세요.
2단계: Perplexity API 키 발급받기 🔑
이제 Perplexity AI의 검색 기능을 외부(Windsurf AI Editor)에서 사용할 수 있도록 허락해주는 '열쇠', 즉 API 키를 발급받을 차례입니다. 이 키는 개인마다 고유하게 발급되므로 안전하게 보관해야 합니다.
Perplexity 사이트 접속 및 로그인:perplexity.ai로 이동하여 본인 계정으로 로그인합니다.
설정(Setting) 메뉴 진입: 로그인 후, 화면 우측 상단의 프로필 아이콘을 클릭하여 '설정(Setting)' 메뉴로 들어갑니다.
API 탭 선택: 설정 화면에서 '</> API' 탭을 선택합니다.
API 키 생성: “+ Generate” 버튼을 클릭해 새로운 API 키를 만듭니다.
API 키 복사 및 보관: 생성된 API 키(ex: pplx-...)를 복사해서 안전한 곳에 보관하세요. 이 키는 절대로 외부에 공개되어서는 안 됩니다.
⚠️ 주의하세요! Perplexity API 키를 발급받고 사용하려면 Perplexity Pro(유료) 구독이 필요합니다. API 키 생성 페이지에서 결제 수단(신용카드 등) 등록을 요구할 수 있습니다. 키(Key)생성 자체만으로는 비용이 청구되지 않지만, API를 실제로 사용하려면 Pro 플랜이 활성화되어 있어야 합니다.
3단계: Windsurf에서 연동 설정하기 ⚙️
마지막 단계입니다! 방금 발급받은 Perplexity API 키를 Windsurf AI Editor에 등록하여 모든 것을 하나로 연결할 시간입니다. 과정은 매우 간단합니다.
Windsurf AI Editor를 실행하고 설정 메뉴로 이동합니다. (보통 단축키 `Ctrl` + `,` 또는 메뉴 바 에서 맨 오른쪽 끝에 로그인 한 사용자의 대표 이미지 아이콘을 클릭 > `Settings`)
위의 그림처럼 'Windsurf Setting' 이란 내용이 펼쳐지고, 그안에 검색 입력란에다 'plugin' 이라고 입력하고 검색합니다.
그럼 위와 같이 보여지는데 저기서 'Open Plugin Store'를 클릭하면 windsurf 오른쪽 부분에 설치할 수 있는 여러가지 Plugin 목록이 보여지는 화면이 열리게 됩니다.
plugin 목록위에 검색 영역에 'Perplexity' 라고 입력하고 검색하면 아래 그림처럼 설치할 수 있는 Perplexity 의 MCP 가 보여집니다. Perplexity 가 찾아졌으면 오른쪽 끝에 'install(ed)' 를 클릭해서 설치합니다. 저는 이미 설치가 되어 있어서 'installed'라고 표시가 되지만 처음 설치하는 분들은 'install' 이라고 뜰겁니다. 그걸 클릭해서 설치하시면 되요, 그리고 'API Key'라고 표시된 입력란에 2단계에서 복사해 둔 Perplexity API 키를 붙여넣기 하고 'Save' 버튼을 클릭해서 저장합니다. 저장까지 되었으면, 그 담엔 같은 화면에 있는 'Tools'라는 메뉴를 클릭하고, 'Perplexity_ask' 라는 기능을 토글 버튼을 클릭해서 활성화 시켜줍니다.
이제 모든 작업은 끝이 났습니다. 이제 Perplexity가 Windsurf 에서 잘 작동하는지 시험해 볼 차례 입니다. 'Plugin Store' 위에 있는 'Back to Cascade' 를 클릭해서 명령어를 입력하는 화면으로 돌아갑니다.
Cascade 에 있는 명령어 입력하는 부분 밑에 망치 모양의 아이콘이 보일 겁니다. Windsurf에 설치된 MCP의 기능을 호출하는 아이콘입니다. 그 망치 모양 아이콘을 클릭해서 그 아이콘 밑에 'perplexity-ask' 라는 perplexicty의 MCP 가 보이고 초록색 불이 들어와 있다면 명령을 입력 받아서 수행할 준비가 다 되었다는 뜻 입니다. 이 상태에서 초록색 박스로 지정된 영역, 즉 명령어를 입력하는 입력난에 ' search for 오늘 서울 날씨 ' 라고 입력하고 엔터 키를 쳐 봅니다.
정상적으로 perplexcity가 연결되었다면, 아래 그림의 초록색 라인으로 박스를 친 영역에 보여지는 콘텐츠와 같이 windsurf 안에서 사용자가 입력한 주제에 대해 온라인에서 관련정보를 심도있게 검색하고 그 결과를 요약해줍니다. 이제 부턴 windsuref 로 코딩을 하면서 그때 그때 필요한 자료나 정보를 조회하기 위해 따로 브라우저를 열어 구글 검색을 하거나 Perplexcity 앱을 띄워서 왔다 갔다하면서 작업할 필요가 없습니다.
이제 모든 설정이 끝났습니다! Windsurf AI Editor 내에서 Perplexity의 강력한 AI 검색 기능을 마음껏 활용하여 개발의 질을 높여보세요. 아마 이전과는 차원이 다른 편리함과 효율성을 경험하게 되실 겁니다.
Windsurf A.I Editor에 Perplexity A.I 검색을 연계할 때 예상되는 질문❓
Q: `npm install` 명령어 실행 중 오류가 발생합니다. 어떻게 해야 하나요?
A: 먼저 Node.js와 npm이 제대로 설치되었는지 버전을 확인해보세요 (`node -v`, `npm -v`). 그리고 명령어를 실행하는 위치가 `cd perplexity-insight-MCP` 명령을 통해 이동한 프로젝트 폴더 내부가 맞는지 다시 한번 확인해주세요.
Q: Perplexity API 키를 발급받으면 바로 요금이 청구되나요?
A: 아니요, API 키를 생성하는 것만으로는 요금이 청구되지 않습니다. 하지만 해당 키를 통해 API를 호출(즉, Windsurf에서 검색 기능을 사용)하려면 Perplexity Pro 요금제에 가입되어 있어야 합니다. Pro 요금제는 월 단위 또는 연 단위로 구독료가 발생합니다.
Q: API 키를 Windsurf에 등록했는데 작동하지 않는 것 같습니다.
A: 몇 가지를 확인해보세요. 첫째, API 키를 복사/붙여넣기 할 때 앞뒤에 공백이 포함되지 않았는지 확인하세요. 둘째, Perplexity 계정이 Pro 플랜에 가입되어 있는지 확인이 필요합니다. 마지막으로, 1단계의 프로젝트 빌드가 성공적으로 완료되었는지 다시 한번 점검해보시는 것을 추천합니다.
※ 주의사항 ※
본 아티클은 제작자의 창작물이며, 지적 재산권에 의해 보호됩니다. 저작자의 허락 없이 다른 저작물에 도용하거나, 저작자 허락 없이 상업적인 목적에 이용하거나 유출하는 경우, 민형사상의 불이익과 처벌을 받게 되니 주의하시기 바랍니다.
