​
MCP 서버란 무엇인가요?

MCP 서버는 Cline의 기능을 향상시키는 특수 확장 프로그램입니다. 이를 통해 Cline은 웹 페이지 가져오기, 이미지 처리, API 액세스 등과 같은 추가 작업을 수행할 수 있습니다.

​
MCP 마켓플레이스 둘러보기

MCP 마켓플레이스는 다양한 범주의 수백 가지 MCP 서버에 대한 원클릭 설치 환경을 제공합니다.

​
1. 마켓플레이스 액세스

  • Cline에서 상단 도구 모음의 “확장 프로그램” 버튼(사각형 아이콘)을 클릭합니다.
  • MCP 마켓플레이스가 열리고 범주별로 사용 가능한 서버가 표시됩니다.

​
2. 서버 찾아보기 및 선택

  • 범주별로 서버를 찾아봅니다(검색, 파일 시스템, 브라우저 자동화, 연구 데이터 등).
  • 서버를 클릭하여 해당 기능 및 요구 사항에 대한 세부 정보를 확인합니다.

​
3. 설치 및 구성

  • 선택한 서버의 설치 버튼을 클릭합니다.
  • 서버에 API 키가 필요한 경우(대부분 필요함) Cline이 다음을 안내합니다.
    • API 키를 가져오는 위치
    • 안전하게 입력하는 방법
  • 서버가 MCP 설정에 자동으로 추가됩니다.

​
4. 설치 확인

  • 설치가 완료되면 Cline에 확인 메시지가 표시됩니다.
  • Cline의 MCP 설정 UI에서 서버 상태를 확인합니다.

​
5. 새 서버 사용

  • 설치가 성공적으로 완료되면 Cline이 서버 기능을 자동으로 통합합니다.
  • Cline의 시스템 프롬프트에서 사용 가능한 새 도구와 리소스를 볼 수 있습니다.
  • 새 서버의 기능을 사용하도록 Cline에게 간단히 요청합니다.
  • 예: “Perplexity를 사용하여 최근 React 업데이트를 웹에서 검색해 줘”
기업 사용자: 기업 환경에서 Cline을 사용하는 경우 조직의 보안 정책에 따라 타사 MCP 서버를 설치할 수 있는 권한이 있는지 확인하십시오.

​
내부 작동 방식

MCP 서버를 설치하면 여러 가지 작업이 자동으로 수행됩니다.

​
1. 설치 프로세스

  • 서버 코드가 /Users/<사용자 이름>/Documents/Cline/MCP/에 복제/설치됩니다.
  • 종속성이 설치됩니다.
  • 서버가 빌드됩니다(TypeScript/JavaScript 컴파일 또는 Python 패키지 설치).

​
2. 구성

  • MCP 설정 파일이 서버 구성으로 업데이트됩니다.
  • 이 파일은 다음 위치에 있습니다. /Users/<사용자 이름>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • 환경 변수(예: API 키)가 안전하게 저장됩니다.
  • 서버 경로가 등록됩니다.

​
3. 서버 시작

  • Cline이 구성 변경을 감지합니다.
  • Cline이 서버를 별도의 프로세스로 시작합니다.
  • stdio 또는 HTTP를 통해 통신이 설정됩니다.

​
4. Cline과의 통합

  • 서버 기능이 Cline의 시스템 프롬프트에 추가됩니다.
  • use_mcp_tool 명령을 통해 도구를 사용할 수 있게 됩니다.
  • access_mcp_resource 명령을 통해 리소스를 사용할 수 있게 됩니다.
  • 이제 Cline은 사용자가 메시지를 표시하면 이러한 기능을 사용할 수 있습니다.

​
문제 해결

​
시스템 요구 사항

시스템이 다음 요구 사항을 충족하는지 확인하십시오.
  • Node.js 18.x 이상
    • node --version을 실행하여 확인합니다.
    • https://nodejs.org/에서 설치합니다.
    • JavaScript/TypeScript 구현에 필요합니다.
  • Python 3.10 이상
    • python --version을 실행하여 확인합니다.
    • https://python.org/에서 설치합니다.
    • 참고: 일부 특수 구현에는 Python 3.11 이상이 필요할 수 있습니다.
  • UV 패키지 관리자
    • 종속성 격리를 위한 최신 Python 패키지 관리자입니다.
    • 다음을 사용하여 설치합니다. 
      curl -LsSf https://astral.sh/uv/install.sh | sh
      또는: pip install uv
    • uv --version으로 확인합니다.
이러한 명령 중 하나라도 실패하거나 이전 버전이 표시되면 계속하기 전에 설치/업데이트하십시오!

​
일반적인 설치 문제

  • 인터넷 연결이 안정적인지 확인합니다.
  • 새 소프트웨어를 설치하는 데 필요한 권한이 있는지 확인합니다.
  • API 키가 올바르게 입력되었는지 확인합니다(필요한 경우).
  • MCP 설정 UI에서 서버 상태를 확인하여 오류 메시지가 있는지 확인합니다.

​
MCP 서버 제거 방법

결함이 있는 MCP 서버를 완전히 제거하려면 다음을 수행합니다.
  1. MCP 설정 파일을 엽니다. /Users/<사용자 이름>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  2. mcpServers 개체에서 서버에 대한 전체 항목을 삭제합니다.
  3. 파일을 저장합니다.
  4. Cline을 다시 시작합니다.

​
여전히 오류가 발생합니다.

MCP 서버를 사용할 때 오류가 발생하는 경우 다음을 시도해 볼 수 있습니다.
  • MCP 설정 파일에 오류가 있는지 확인합니다.
  • 설치에 Claude Sonnet 모델을 사용합니다.
  • 서버 파일 경로가 올바른지 확인합니다.
  • 필요한 모든 환경 변수가 설정되어 있는지 확인합니다.
  • 다른 프로세스가 동일한 포트를 사용하고 있는지 확인합니다(HTTP 기반 서버의 경우).
  • 서버를 제거했다가 다시 설치해 봅니다(cline_mcp_settings.json 파일과 /Users/<사용자 이름>/Documents/Cline/MCP/ 디렉터리 모두에서 제거).
  • 터미널을 사용하고 해당 인수를 사용하여 명령을 직접 실행합니다. 이렇게 하면 Cline이 보고 있는 것과 동일한 오류를 볼 수 있습니다.

​
MCP 서버 규칙

Cline은 이미 활성 MCP 서버와 해당 용도를 알고 있지만 MCP 서버를 많이 활성화한 경우 각 서버를 언제 사용할지 정의하는 것이 유용할 수 있습니다. 키워드 기반 트리거를 통해 지능형 MCP 서버 활성화를 지원하도록 .clinerules 파일 또는 사용자 지정 지침을 활용하여 Cline의 도구 선택을 더욱 직관적이고 상황에 맞게 만듭니다.

​
MCP 규칙 작동 방식

MCP 규칙은 연결된 MCP 서버를 기능 범주로 그룹화하고 Cline과의 대화에서 감지되면 자동으로 활성화하는 트리거 키워드를 정의합니다. 
{
	"mcpRules": {
		"webInteraction": {
			"servers": ["firecrawl-mcp-server", "fetch-mcp"],
			"triggers": ["web", "scrape", "browse", "website"],
			"description": "웹 브라우징 및 스크래핑용 도구"
		}
	}
}

​
구성 구조

  1. 범주: 관련 서버 그룹화(예: “webInteraction”, “mediaAndDesign”)
  2. 서버: 각 범주의 서버 이름 나열
  3. 트리거: 이러한 서버를 활성화하는 키워드
  4. 설명: 사람이 읽을 수 있는 범주 설명

​
MCP 규칙의 이점

  • 상황별 도구 선택: Cline은 대화 컨텍스트를 기반으로 적절한 도구를 선택합니다.
  • 마찰 감소: 사용할 도구를 수동으로 지정할 필요가 없습니다.
  • 체계적인 기능: 관련 도구 및 서버를 논리적으로 그룹화합니다.
  • 우선 순위 지정: 명시적인 우선 순위 지정을 통해 모호한 경우를 처리합니다.

​
사용 예시

“이 웹사이트를 스크랩해 줄 수 있나요?”라고 작성하면 Cline은 “스크랩” 및 “웹사이트”를 트리거로 감지하여 웹 관련 MCP 서버를 자동으로 선택합니다. “Apple 주가가 얼마인가요?”와 같은 금융 작업의 경우 “주식” 및 “가격”과 같은 키워드가 금융 관련 서버를 트리거합니다.

​
빠른 시작 템플릿

{
	"mcpRules": {
		"category1": {
			"servers": ["server-name-1", "server-name-2"],
			"triggers": ["keyword1", "keyword2", "phrase1", "phrase2"],
			"description": "이러한 도구가 수행하는 작업에 대한 설명"
		},
		"category2": {
			"servers": ["server-name-3"],
			"triggers": ["keyword3", "keyword4", "phrase3"],
			"description": "이러한 도구가 수행하는 작업에 대한 설명"
		},
		"category3": {
			"servers": ["server-name-4", "server-name-5"],
			"triggers": ["keyword5", "keyword6", "phrase4"],
			"description": "이러한 도구가 수행하는 작업에 대한 설명"
		}
	},
	"defaultBehavior": {
		"priorityOrder": ["category1", "category2", "category3"],
		"fallbackBehavior": "사용자에게 가장 적합한 도구를 문의합니다."
	}
}
.clinerules 파일이나 사용자 지정 지침에 이것을 추가하여 Cline의 MCP 서버 선택을 더욱 직관적이고 상황에 맞게 만듭니다.