Skip to main content

원격 서버에 연결

원격 MCP 서버 추가 및 관리​

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

Cline에서 MCP 서버 인터페이스에 액세스하려면:

  1. VSCode 사이드바에서 Caret 아이콘을 클릭합니다.
  2. Caret 패널의 오른쪽 상단 모서리에 있는 메뉴(⋮)를 엽니다.
  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(Model Context Protocol)를 지원하는 광범위한 타사 서버에 대한 액세스를 제공합니다. 이러한 서버는 GitHub, Notion, Slack 등과 같은 서비스에 대한 API를 노출합니다. 각 서버에는 구성 지침 및 내장 인증 지원(예: OAuth 또는 API 키)이 포함되어 있습니다. 연결하려면 마켓플레이스에서 원하는 서비스를 찾아 제공된 통합 단계를 따르십시오.

Smithery를 통한 연결​

Smithery는 사용자가 다양한 MCP(Model Context Protocol) 서버를 검색하고 연결할 수 있는 타사 MCP 서버 마켓플레이스입니다. MCP 호환 클라이언트(Cursor, Claude Desktop 또는 Caret 등)를 사용하는 경우 사용 가능한 서버를 탐색하고 워크플로에 직접 통합할 수 있습니다.

사용 가능한 옵션을 탐색하려면 Smithery 마켓플레이스를 방문하십시오: https://smithery.ai

참고: Smithery는 독립적으로 유지 관리되며 당사 프로젝트와 제휴하지 않습니다. 재량에 따라 사용하십시오.

설치된 MCP 서버 관리​

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

서버 상태 보기​

각 서버는 현재 상태를 표시합니다.

  • 녹색 점: 연결되어 사용할 준비가 됨
  • 노란색 점: 연결 중
  • 빨간색 점: 연결 끊김 또는 오류 발생

서버 설정 구성​

서버를 클릭하여 설정 패널을 확장합니다.

  1. 도구 및 리소스:
    • 서버에서 사용 가능한 모든 도구 및 리소스 보기
    • 도구에 대한 자동 승인 설정 구성(활성화된 경우)
  2. 요청 시간 초과:
    • Cline이 서버 응답을 기다릴 시간 설정
    • 옵션은 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에 결과를 반환합니다.