메인 콘텐츠로 건너뛰기

개요

Cursor CLI는 Model Context Protocol(MCP) 서버를 지원해서 외부 도구와 데이터 소스를 cursor-agent에 연결할 수 있어. CLI에서 MCP는 에디터와 동일한 설정을 써—설정해 둔 MCP 서버는 둘 다에서 매끄럽게 그대로 동작해.

MCP 알아보기

MCP가 처음이야? 구성, 인증, 사용 가능한 서버에 대한 전체 가이드를 읽어봐

CLI 명령어

cursor-agent mcp 명령어로 MCP 서버를 관리해:

구성된 서버 목록

구성된 모든 MCP 서버와 현재 상태를 확인해:
cursor-agent mcp list
다음이 표시돼:
  • 서버 이름과 식별자
  • 연결 상태(연결됨/연결 끊김)
  • 구성 소스(프로젝트 또는 전역)
  • 전송 방식(stdio, HTTP, SSE)

사용 가능한 도구 목록

특정 MCP 서버에서 제공하는 도구 보기:
cursor-agent mcp list-tools <identifier>
이건 다음을 보여줘:
  • 도구 이름과 설명
  • 필수 및 선택 매개변수
  • 매개변수 타입과 제약 조건

MCP 서버에 로그인

mcp.json에 설정된 MCP 서버에 인증해:
cursor-agent mcp login <identifier>

MCP 서버 비활성화

로컬 승인 목록에서 MCP 서버를 제거:
cursor-agent mcp disable <identifier>

Agent와 함께 MCP 사용하기

MCP 서버를 구성한 뒤(메인 MCP 가이드 참고), cursor-agent는 너의 요청과 관련 있을 때 사용 가능한 도구를 자동으로 찾아서 사용해.
# 사용 가능한 MCP 서버 확인
cursor-agent mcp list

# 특정 서버가 제공하는 도구 확인
cursor-agent mcp list-tools playwright

# cursor-agent 사용 - 필요할 때 MCP 도구를 자동으로 사용함
cursor-agent --prompt "google.com으로 이동해서 검색 페이지 스크린샷 찍기"
CLI는 에디터와 같은 구성 우선순위(프로젝트 → 전역 → 중첩)를 따르고, 상위 디렉터리에서 구성을 자동으로 찾아.
I