​
전역 MCP 서버 포함 모드

MCP 서버를 활용하면 토큰 사용량이 증가합니다. Cline은 원하는 대로 MCP 서버 기능을 제한하거나 비활성화하는 기능을 제공합니다.
  1. Cline 확장 프로그램의 상단 탐색 모음에서 “MCP 서버” 아이콘을 클릭합니다.
  2. “설치됨” 탭을 선택한 다음 해당 창 하단에 있는 “고급 MCP 설정” 링크를 클릭합니다.
  3. Cline이 새 설정 창을 엽니다. Cline>Mcp:Mode를 찾아 드롭다운 메뉴에서 선택합니다.
MCP 설정 편집

​
개별 MCP 서버 관리

각 MCP 서버에는 설정을 수정하고, 도구를 관리하고, 작동을 제어할 수 있는 자체 구성 패널이 있습니다. 이러한 설정에 액세스하려면 다음을 수행합니다.
  1. Cline 확장 프로그램의 상단 탐색 모음에서 “MCP 서버” 아이콘을 클릭합니다.
  2. 목록에서 관리하려는 MCP 서버를 찾아 해당 이름을 클릭하여 엽니다.
개별 MCP 설정

​
서버 삭제

  1. 삭제하려는 MCP 서버 옆에 있는 휴지통 아이콘을 클릭하거나 MCP 서버 구성 상자 하단에 있는 빨간색 서버 삭제 버튼을 클릭합니다.
참고: 삭제 확인 대화 상자가 없습니다.

​
서버 다시 시작

  1. 다시 시작하려는 MCP 서버 옆에 있는 다시 시작 버튼을 클릭하거나 MCP 서버 구성 상자 하단에 있는 회색 서버 다시 시작 버튼을 클릭합니다.

​
서버 활성화 또는 비활성화

  1. MCP 서버 옆에 있는 토글 스위치를 클릭하여 개별적으로 서버를 활성화/비활성화합니다.

​
네트워크 시간 초과

MCP 서버에 대한 도구 호출 후 응답을 기다리는 최대 시간을 설정하려면 다음을 수행합니다.
  1. 개별 MCP 서버의 구성 상자 하단에 있는 네트워크 시간 초과 드롭다운을 클릭하고 시간을 변경합니다. 기본값은 1분이지만 30초에서 1시간 사이로 설정할 수 있습니다.

​
MCP 설정 파일 편집

설치된 모든 MCP 서버에 대한 설정은 cline_mcp_settings.json 파일에 있습니다.
  1. Cline 창의 상단 탐색 모음에서 MCP 서버 아이콘을 클릭합니다.
  2. “설치됨” 탭을 선택합니다.
  3. 창 하단에 있는 “MCP 서버 구성” 버튼을 클릭합니다.
파일은 명명된 서버 구성이 포함된 mcpServers 개체가 있는 JSON 형식을 사용합니다. 
{
	"mcpServers": {
		"server1": {
			"command": "python",
			"args": ["/path/to/server.py"],
			"env": {
				"API_KEY": "your_api_key"
			},
			"alwaysAllow": ["tool1", "tool2"],
			"disabled": false
		}
	}
}
Cline의 MCP 서버 구성 예시 (STDIO 전송)

​
전송 유형 이해

MCP는 서버 통신을 위해 두 가지 전송 유형을 지원합니다.

​
STDIO 전송

컴퓨터에서 실행되는 로컬 서버에 사용됩니다.
  • 표준 입력/출력 스트림을 통해 통신합니다.
  • 지연 시간이 짧습니다(네트워크 오버헤드 없음).
  • 보안이 향상됩니다(네트워크 노출 없음).
  • 설정이 간단합니다(HTTP 서버 필요 없음).
  • 컴퓨터에서 하위 프로세스로 실행됩니다.
STDIO 전송 작동 방식에 대한 자세한 내용은 MCP 전송 메커니즘을 참조하십시오. STDIO 구성 예시: 
{
	"mcpServers": {
		"local-server": {
			"command": "node",
			"args": ["/path/to/server.js"],
			"env": {
				"API_KEY": "your_api_key"
			},
			"alwaysAllow": ["tool1", "tool2"],
			"disabled": false
		}
	}
}

​
SSE 전송

HTTP/HTTPS를 통해 액세스하는 원격 서버에 사용됩니다.
  • Server-Sent Events 프로토콜을 통해 통신합니다.
  • 다른 컴퓨터에서 호스팅할 수 있습니다.
  • 여러 클라이언트 연결을 지원합니다.
  • 네트워크 액세스가 필요합니다.
  • 중앙 집중식 배포 및 관리가 가능합니다.
SSE 전송 작동 방식에 대한 자세한 내용은 MCP 전송 메커니즘을 참조하십시오. SSE 구성 예시: 
{
	"mcpServers": {
		"remote-server": {
			"url": "https://your-server-url.com/mcp",
			"headers": {
				"Authorization": "Bearer your-token"
			},
			"alwaysAllow": ["tool3"],
			"disabled": false
		}
	}
}

​
워크플로에서 MCP 도구 사용

MCP 서버를 구성하면 Cline이 사용 가능한 도구와 리소스를 자동으로 감지합니다. 이를 사용하려면 다음을 수행합니다.
  1. Cline의 대화 창에 요청을 입력합니다.
  2. Cline이 작업에 MCP 도구가 도움이 될 수 있는 시점을 식별합니다.
  3. 메시지가 표시되면 도구 사용을 승인합니다(또는 자동 승인 사용).
예: “API 성능 분석”은 API 엔드포인트를 테스트하는 MCP 도구를 사용할 수 있습니다.

​
MCP 서버 문제 해결

일반적인 문제 및 해결 방법:
  • 서버가 응답하지 않음: 서버 프로세스가 실행 중인지 확인하고 네트워크 연결을 확인합니다.
  • 권한 오류: mcp_settings.json 파일에 올바른 API 키와 자격 증명이 구성되어 있는지 확인합니다.
  • 도구를 사용할 수 없음: 서버가 도구를 올바르게 구현하고 있고 설정에서 비활성화되어 있지 않은지 확인합니다.
  • 성능 저하: 특정 MCP 서버의 네트워크 시간 초과 값을 조정해 봅니다.