​
개요

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

MCP 알아보기

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

​
CLI 명령어

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

​
구성된 서버 목록

구성된 모든 MCP 서버와 현재 상태를 확인해: 
cursor-agent mcp list
다음이 표시돼:
  • 서버 이름과 식별자
  • 연결 상태(connected/disconnected)
  • 구성 소스(project 또는 global)
  • 전송 방식(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는 에디터와 동일한 설정 우선순위를 따르고(프로젝트 → 전역 → 중첩), 상위 디렉터리에서 설정을 자동으로 찾아.

MCP Overview

MCP 가이드 전체: 설정, 구성, 인증

Available MCP Tools

바로 사용할 수 있는 MCP 서버 둘러보기