Apidog

올인원 협업 API 개발 플랫폼

API 설계

API 문서

API 디버깅

API 모킹

API 자동화 테스트

윈드서핑 AI에서 MCP 서버 사용 방법 (10배 개발자 되기)

Young-jae

Young-jae

Updated on April 12, 2025

만약 Windsurf AI의 분위기를 느끼고 있다면, 당신은 이미 AI 기반 개발의 최전선에 서 있습니다. 하지만 MCP 서버의 마법을 제대로 활용해본 적이 있나요? 이 작은 파워하우스들은 당신의 Windsurf 경험을 “꽤 멋진” 수준에서 “정말 놀라운” 수준으로 변화시킬 수 있습니다. 당신의 AI助 devance를 데이터베이스, 브라우저, 또는 심지어 GitHub의 키를 데려다 준다고 상상해보세요—모두 편집기를 떠나지 않고 말이죠. 이것이 바로 모델 컨텍스트 프로토콜(MCP)이 제공하는 것입니다. 오늘은 Windsurf에서 이를 연결하는 방법을 안내해드리겠습니다. 준비가 되셨나요? 이제 시작해봅시다!

💡
먼저 Windsurf AI에서 MCP 서버를 사용하기 전에, API 애호가들에게 완벽한 생명줄인 Apidog에 대해 잠깐 언급해볼까요! 이 매끄러운 도구는 인터페이스가 너무 직관적이어서 초보자도 쉽게 API를 설계하고, 테스트하며, 문서화할 수 있습니다. Windsurf를 탐험하면서 앱을 만들고 있다면, apidog.com에서 한 번 시도해보세요—개발자에게는 꿈과 같은 경험이 될 것입니다!
button
Apidog Ui 이미지

이제 MCP 마법을 시작해볼까요…

MCP 서버란 무엇이며 Windsurf에서 왜 사용해야 할까요?

그렇다면 MCP는 어떤 매력이 있을까요? 모델 컨텍스트 프로토콜의 약자로, AI 도구인 Windsurf가 외부 시스템과 대화를 나눌 수 있게 해주는 오픈 표준입니다—데이터베이스, API 또는 심지어 로컬 파일을 생각해보세요. MCP 서버는 AI에게 도구와 데이터를 노출하여 더 똑똑하고 연결된 존재가 될 수 있도록 도와주는 믿음직한 조수와 같습니다. Windsurf에서 이는 당신의 Cascade(그 멋진 AI 어시스턴트)가 단순히 코드를 제안하는 것 이상의 일을 수행할 수 있음을 의미합니다—실시간으로 데이터를 가져오거나 명령을 실행할 수도 있습니다.

왜 이걸 신경써야 할까요? WindsurfMCP는 당신의 코딩 뇌에 터보 부스트를 주는 것과 같습니다. PostgreSQL 데이터베이스를 쿼리해야 하나요? 이를 위한 MCP 서버가 있습니다(postgresql-mcp-server를 확인해보세요). 브라우저 작업을 자동화하고 싶나요? 그것을 위한 서버도 있습니다. 흐름을 유지하는 것이 중요합니다—더 이상 앱 전환이나 수동 작업이 필요하지 않습니다. 설정해봅시다!

Windsurf에서 MCP 서버 설정하기: 단계별 가이드

MCP 서버를 Windsurf에서 설정하는 것은 생각보다 쉽습니다. 초보자든 경험 많은 개발자든, 실행 방법은 다음과 같습니다.

1단계: Windsurf AI 설치하기

가장 먼저 할 일—아직 Windsurf를 다운로드하지 않았다면 지금 다운로드하세요. windsurf 웹사이트에 가서 Mac, Windows 또는 Linux용으로 다운로드하고 설치하세요. VS Code의 뼈대를 기반으로 한 강화된 IDE이므로 익숙하면서도 훨씬 더 마법 같은 느낌을 받을 수 있습니다. 이미 설치했나요? 최신 버전으로 업데이트되었는지 확인하세요—MCP 지원은 최신 버전에서 빛을 발합니다.

windsurf 다운로드

2단계: 설정 열고 MCP 활성화하기

이제 MCP 스위치를 켜봅시다:

  1. Windsurf를 실행합니다.
  2. “Windsurf - Settings” 버튼(오른쪽 하단)을 클릭하거나 Cmd+Shift+P(Mac) / Ctrl+Shift+P(Windows/Linux)를 눌러 “Open Windsurf Settings”를 입력합니다.
  3. 고급 설정에서 “Cascade” 섹션으로 스크롤합니다.
  4. “모델 컨텍스트 프로토콜”과 같은 라벨이 붙은 MCP 옵션을 찾고 활성화합니다!

이것은 Windsurf에게 MCP 서버를 듣기 시작하라는 신호입니다. 여기에서 AI 모델을 선택할 수도 있습니다—Claude 3.5 Sonnet은 코딩 작업에 훌륭한 선택입니다.

Cascade 설정

3단계: MCP 서버 추가하기

이제 MCP 서버를 연결해봅시다. Windsurf는 두 가지 유형을 지원합니다: stdio(로컬 명령줄 작업)와 sse(HTTP를 통한 원격 서버). 이 튜토리얼에서는 GitHub의 PostgreSQL MCP Server를 사용할 것입니다—데이터베이스 애호가에게 완벽한 선택입니다.

  1. 서버 다운로드: postgresql-mcp-server로 가서 클론합니다(git clone https://github.com/HenkDz/postgresql-mcp-server.git), 그리고 폴더로 이동합니다(cd postgresql-mcp-server).
  2. 설치하기: Node.js 18+가 필요합니다. 다음 명령을 실행합니다:
npm install
npm run build

3. 구성하기: Windsurf 설정을 다시 열고, Cascade 아래의 “Add Server”를 클릭한 후 mcp_config.json 파일(위치: ~/.codeium/windsurf/mcp_config.json)에 다음 내용을 붙여넣습니다:

  • 또는 windsurf 설정에서 직접 접근할 수 있습니다:
MCP 서버 추가
  • 그런 다음 "Add custom server"를 선택합니다:
커스텀 MCP 서버
{
  "mcpServers": {
    "postgresql-mcp": {
      "command": "node",
      "args": ["/path/to/postgresql-mcp-server/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

/path/to/를 실제 폴더 경로로 바꿉니다(예: /home/user/postgresql-mcp-server).

  • 또는 Windurf를 사용할 때 MCP 구성과 설치를 쉽게 해주는 사용 가능한 MCP 서버 템플릿 목록을 탐색할 수도 있습니다.
MCP 서버 템플릿

4. 새로고침: 설정에서 새로고침 버튼을 눌러 로드합니다.

Windsurf의 사용 가능한 도구 보기

5단계: 연결 테스트하기

서버를 로컬에서 시작하려면:

npm run dev

그런 다음 Windsurf에서 Cascade 패널(채팅 인터페이스)을 열고 “postgresql://user:password@localhost:5432/mydb에서 내 PostgreSQL 데이터베이스를 분석하라”고 입력해보세요. 작동한다면, Cascade가 성능 통계나 스키마 세부정보로 응답합니다—멋지죠?

Cascade MCP 서버 도구

Windsurf에서 MCP 서버 사용하기: 실제 재미

이제 MCP 서버가 잘 작동하기 시작했습니다. Windsurf에서 그것을 가지고 놀아봅시다. PostgreSQL MCP 서버는 다양한 트릭으로 가득 차 있습니다—다음은 몇 가지 사용 방법입니다.

데이터베이스 쿼리하기

Cascade에서 다음을 시도해보세요:

>> postgresql://user:password@localhost:5432/mydb에 대한 스키마 정보를 가져옵니다.

MCP 서버는 테이블 이름, 열 및 제약 조건을 가져오고, Windsurf의 AI는 이를 보기 좋게 포맷합니다. 구체적인 세부사항이 필요하다면 “users 테이블에 대해”라고 추가하여 더 자세히 알아보세요.

테이블 생성하기

Cascade에 다음을 말해보세요:

>> postgresql://user:password@localhost:5432/mydb에 id (SERIAL), name (VARCHAR), done (BOOLEAN)이라는 열이 있는 'tasks'라는 테이블을 생성합니다.

MCP 서버가 이를 실행하고, Windsurf가 결과를 보여줍니다. 수동 SQL이 필요하지 않습니다!

느린 쿼리 디버깅하기

앱이 느리다면 물어보세요:

>> postgresql://user:password@localhost:5432/mydb에서 성능 문제를 디버그합니다.

서버는 병목 현상을 찾아내고—아마도 누락된 인덱스일 수 있습니다—Windsurf는 해결 방안을 제안합니다. DBA를 빠르게 연결한 것과 같습니다!

Windsurf에서 더 많은 MCP 서버 탐색하기

PostgreSQL MCP 서버는 시작에 불과합니다. Windsurf 사용자들은 windsurf.run으로 가서 더 많은 MCP 서버, Windsurf 규칙, 튜토리얼, 그리고 다양한 정보를 발견할 수 있습니다. GitHub를 자동화하고 싶나요? 이를 위한 서버가 있습니다. 브라우저 제어가 필요하신가요? Browserbase의 MCP 제공을 확인해보세요.

windsurf.run 웹 페이지

Windsurf Docs 페이지는 당신의 보물지도입니다—파고들어 당신의 프로젝트에 적합한 것을 찾아보세요!

windsurf.run 학습

Windsurf에서 MCP 마스터하기 위한 팁

여기 Windsurf에서 MCP를 전문가처럼 잘 다루는 방법이 있습니다:

  • 관련성 유지하기: 필요한 MCP 서버만 활성화하세요—너무 많이 활성화하면 Cascade가 혼란스러워질 수 있습니다.
  • @ 멘션 사용하기: Cascade에서 @postgresql-mcp를 입력하여 서버를 직접 지정하세요.
  • 로그 확인하기: 문제가 있을 경우 ~/.codeium/windsurf/logs를 확인하여 단서를 찾아보세요.
  • 실험하기: “내 데이터베이스 모니터링”이나 “테이블 데이터 내보내기”와 같은 프롬프트를 시도해보세요—PostgreSQL MCP 서버에는 숨겨진 힘이 많이 있습니다.

왜 MCP 서버가 Windsurf를 빛나게 하는가

결론적으로 말하자면: MCPWindsurf를 단순한 편집기가 아닌 커맨드 센터로 변모시킵니다. X에 게시된 글에서는 MCP 서버(예: Neon의 데이터베이스 통합)를 통해 “SQL을 작성하지 않고도 프로젝트를 관리할 수 있다”고 찬사를 보냅니다. 이런 분위기입니다—수동 작업이 적고 흐름이 많습니다. Cursor와 같은 도구와 비교할 때 WindsurfMCP를 통해 더 깊은 맥락 인식과 매끄러운 도구 통합을 제공하여 여러분을 설정된 작업에 몰두하게 만듭니다.

결론: 여러분의 Windsurf MCP 모험이 기다립니다

이제 여러분은 WindsurfMCP 명인입니다! PostgreSQL MCP Server를 연결하는 것부터 몇 마디로 데이터베이스를 쿼리하는 것까지, 여러분은 코딩 능력을 한 단계 끌어올렸습니다. windsurf.run로 가서 더 많은 MCP 서버, Windsurf 팁, 그리고 튜토리얼을 찾아 모멘텀을 이어가세요.

button