​
원격 MCP 서버 추가 및 관리

​
MCP 서버 인터페이스 액세스

Cline에서 MCP 서버 인터페이스에 액세스하려면 다음을 수행합니다.
  1. VSCode 사이드바에서 Cline 아이콘을 클릭합니다.
  2. Cline 패널 오른쪽 상단에 있는 메뉴(⋮)를 엽니다.
  3. 드롭다운 메뉴에서 “MCP 서버”를 선택합니다.

​
MCP 서버 인터페이스 이해

MCP 서버 인터페이스는 세 가지 주요 탭으로 나뉩니다.
  • 마켓플레이스: 미리 구성된 MCP 서버를 검색하고 설치합니다(활성화된 경우).
  • 원격 서버: URL 엔드포인트를 통해 기존 MCP 서버에 연결합니다.
  • 설치됨: 연결된 MCP 서버를 관리합니다.

​
원격 MCP 서버 추가

“원격 서버” 탭을 사용하면 URL 엔드포인트를 통해 액세스할 수 있는 모든 MCP 서버에 연결할 수 있습니다.
  1. MCP 서버 인터페이스에서 “원격 서버” 탭을 클릭합니다.
  2. 필요한 정보를 입력합니다.
    • 서버 이름: 서버에 대한 고유하고 설명적인 이름을 제공합니다.
    • 서버 URL: MCP 서버의 전체 URL 엔드포인트(예: https://example.com/mcp-sse)를 입력합니다.
  3. “서버 추가”를 클릭하여 연결을 시작합니다.
  4. Cline이 서버에 연결을 시도하고 연결 상태를 표시합니다.
참고: 원격 서버에 연결할 때 MCP 서버가 환경에서 코드를 실행할 수 있으므로 소스를 신뢰하는지 확인하십시오.

​
원격 서버 검색

연결할 MCP 서버를 찾고 있다면 여러 타사 마켓플레이스에서 다양한 기능을 갖춘 사용 가능한 서버 디렉터리를 제공합니다.
경고: 다음 타사 마켓플레이스는 정보 제공 목적으로만 나열됩니다. Cline은 이러한 마켓플레이스에 나열된 서버를 보증, 확인 또는 책임지지 않습니다. 이러한 서버는 요청을 처리하고 사용자가 공유하는 데이터에 액세스할 수 있는 클라우드 호스팅 서비스입니다. 타사 서비스에 연결하기 전에 항상 개인 정보 보호 정책 및 사용 약관을 검토하십시오.

​
Composio MCP 통합

Composio의 MCP 마켓플레이스는 모델 컨텍스트 프로토콜(MCP)을 지원하는 광범위한 타사 서버에 대한 액세스를 제공합니다. 이러한 서버는 GitHub, Notion, Slack 등과 같은 서비스용 API를 노출합니다. 각 서버에는 구성 지침과 기본 제공 인증 지원(예: OAuth 또는 API 키)이 포함되어 있습니다. 연결하려면 마켓플레이스에서 원하는 서비스를 찾아 여기에 제공된 통합 단계를 따르십시오.

​
Smithery를 통한 연결

Smithery는 사용자가 다양한 모델 컨텍스트 프로토콜(MCP) 서버를 검색하고 연결할 수 있도록 하는 타사 MCP 서버 마켓플레이스입니다. MCP 호환 클라이언트(예: Cursor, Claude Desktop 또는 Cline)를 사용하는 경우 사용 가능한 서버를 검색하고 워크플로에 직접 통합할 수 있습니다. 사용 가능한 옵션을 탐색하려면 Smithery 마켓플레이스를 방문하십시오. https://smithery.ai 참고: Smithery는 독립적으로 유지 관리되며 당사 프로젝트와 관련이 없습니다. 재량에 따라 사용하십시오.

​
설치된 MCP 서버 관리

추가되면 MCP 서버가 “설치됨” 탭에 나타나며 여기에서 다음을 수행할 수 있습니다.

​
서버 상태 보기

각 서버는 현재 상태를 표시합니다.
  • 녹색 점: 연결되어 사용할 준비가 되었습니다.
  • 노란색 점: 연결 중입니다.
  • 빨간색 점: 연결이 끊어졌거나 오류가 발생했습니다.

​
서버 설정 구성

서버를 클릭하여 설정 패널을 확장합니다.
  1. 도구 및 리소스:
    • 서버에서 사용 가능한 모든 도구 및 리소스를 봅니다.
    • 도구에 대한 자동 승인 설정을 구성합니다(활성화된 경우).
  2. 요청 시간 초과:
    • 서버 응답을 기다리는 시간을 설정합니다.
    • 옵션은 30초에서 1시간까지 다양합니다.
  3. 서버 관리:
    • 서버 다시 시작: 서버가 응답하지 않으면 다시 연결합니다.
    • 서버 삭제: 구성에서 서버를 제거합니다.

​
서버 활성화/비활성화

각 서버 옆에 있는 토글 스위치를 전환하여 활성화하거나 비활성화합니다.
  • 활성화됨: Cline이 서버의 도구와 리소스를 사용할 수 있습니다.
  • 비활성화됨: 서버가 구성에 남아 있지만 활성 상태가 아닙니다.

​
연결 문제 해결

서버 연결에 실패하면 다음을 수행합니다.
  1. 실패에 대한 세부 정보가 포함된 오류 메시지가 표시됩니다.
  2. 서버 URL이 올바른지와 서버가 실행 중인지 확인합니다.
  3. “서버 다시 시작” 버튼을 사용하여 다시 연결을 시도합니다.
  4. 문제가 지속되면 서버를 삭제하고 다시 추가해 볼 수 있습니다.

​
고급 구성

고급 사용자의 경우 Cline은 수정할 수 있는 JSON 파일에 MCP 서버 구성을 저장합니다.
  1. “설치됨” 탭에서 “MCP 서버 구성”을 클릭하여 설정 파일에 액세스합니다.
  2. 각 서버의 구성은 다음 형식을 따릅니다.
{
	"mcpServers": {
		"exampleServer": {
			"url": "https://example.com/mcp-sse",
			"disabled": false,
			"autoApprove": ["tool1", "tool2"],
			"timeout": 30
		}
	}
}
주요 구성 옵션:
  • url: 엔드포인트 URL(원격 서버용)
  • disabled: 서버가 현재 활성화되어 있는지 여부(true/false)
  • autoApprove: 확인이 필요 없는 도구 이름 목록
  • timeout: 서버 응답을 기다리는 최대 시간(초)
추가 MCP 설정을 보려면 “고급 MCP 설정” 링크를 클릭하여 VSCode 설정에 액세스하십시오.

​
MCP 서버 도구 사용

연결되면 Cline은 MCP 서버에서 제공하는 도구와 리소스를 사용할 수 있습니다. Cline이 MCP 도구 사용을 제안하면 다음을 수행합니다.
  1. 도구 승인 프롬프트가 나타납니다(자동 승인되지 않은 경우).
  2. 승인하기 전에 도구 세부 정보와 매개변수를 검토합니다.
  3. 도구가 실행되고 결과가 Cline으로 반환됩니다.