LMCP 시작하기 — 5분 안에 첫 번째 도구 호출
로컬 도구는 Mac 또는 Windows PC에서 실행되며 사용 가능한 연동은 플랫폼에 따라 다릅니다. 선택한 AI 제공업체와 선택적 클라우드 커넥터는 각자의 약관에 따라 요청에 필요한 내용을 받습니다. 데스크톱 AI 앱도 클라우드 모델을 사용할 수 있습니다. LMCP는 기기에서 로컬 도구를 실행합니다. 클라우드 AI 제공업체와 연결된 서비스는 요청된 데이터를 받을 수 있으며 해당 약관이 적용됩니다.
LMCP가 설정하는 AI 앱
Mac
설치 프로그램은 컴퓨터에서 찾은 LMCP 지원 AI 앱을 설정하며, LMCP 메뉴에서 각 앱과 아직 필요한 작업이 있는지 확인할 수 있습니다.
Windows
설치 프로그램은 컴퓨터에서 찾은 LMCP 지원 AI 앱을 설정하며, LMCP 메뉴에서 각 앱과 아직 필요한 작업이 있는지 확인할 수 있습니다.
완료까지 걸리는 시간: 약 5분
요구 사항: macOS 13 이상 (Apple Silicon 또는 Intel), Claude Desktop 또는 Cursor
1단계 — LMCP 설치하기
LMCP 다운로드 후 설치하세요:
- 다운로드 폴더에서 받은
LMCP-Installer.pkg파일을 엽니다 그런 다음 설치 프로그램의 안내를 따르세요. - macOS 설치 마법사의 안내를 따르고 요청이 표시되면 설치를 승인하세요.
- 응용 프로그램 폴더에서 Local MCP를 엽니다 — 메뉴 막대에 나타납니다
약 30초가 걸립니다. 설치 프로그램이 AI 클라이언트를 자동으로 구성하므로 파일을 끌거나 직접 설정할 필요가 없습니다.
Local MCP를 처음 열면 다음 작업을 수행합니다.
- 메뉴 막대에 나타나 로컬 MCP 서버를 시작합니다. 앱 자체가 서버이므로 별도의 daemon을 설치하지 않습니다
- 설치된 AI 클라이언트(Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed)를 자동 감지하고 구성합니다
- 자동으로 최신 상태를 유지합니다
LMCP는 기기에서 로컬 도구를 실행합니다. 클라우드 AI 제공업체와 연결된 서비스는 요청한 데이터를 받을 수 있으며 각 서비스의 약관이 적용됩니다.
터미널을 선호한다면 한 명령으로 같은 앱을 설치할 수 있습니다. curl -fsSL https://local-mcp.com/install | bash
2단계 — AI 클라이언트 연결하기
Claude Desktop (대부분의 사용자에게 권장)
설치 프로그램이 자동으로 LMCP를 Claude Desktop 설정에 추가합니다. 변경 사항을 적용하려면 Claude Desktop을 재시작하기만 하면 됩니다.
- Claude Desktop을 완전히 종료합니다 (Cmd+Q, 또는 Dock 아이콘 우클릭 → 종료)
- Claude Desktop을 다시 엽니다
- 새 대화를 시작합니다
이게 전부입니다. 수동으로 설정을 편집할 필요가 없습니다.
수동 설정 (자동 설정이 실행되지 않은 경우)
텍스트 편집기에서 ~/Library/Application Support/Claude/claude_desktop_config.json을 열고 다음을 추가합니다:
{
"mcpServers": {
"local-mcp": {
"command": "npx",
"args": ["-y", "local-mcp@latest"],
"env": { "LMCP_ORIGIN": "manual" }
}
}
}
그런 다음 Claude Desktop을 재시작합니다.
Cursor
Cursor에서 MCP 도구를 사용하려면 Agent 모드가 필요합니다. 표준 Chat 모드에서는 도구가 표시되지 않습니다.
- Cursor 설정 → MCP Servers를 엽니다
-
새 서버를 추가합니다:
- Name:
local-mcp - Command:
npx - Args:
-y local-mcp@latest
- Name:
- 저장하고 Cursor를 재시작합니다
- 대화를 시작할 때 Agent 모드로 전환합니다
Claude Code
터미널에서 npx -y local-mcp@latest setup을 실행하세요. Claude Code를 자동으로 감지하고 구성합니다. 그런 다음 Claude Code를 재시작합니다.
기타 클라이언트 (Windsurf, VS Code, Zed)
npx -y local-mcp@latest를 가리키는 MCP 서버 설정을 추가한 다음 클라이언트를 재시작합니다.
VS Code의 경우 Cline 또는 Continue 확장을 사용하세요.
전체 안내: VS Code, Windsurf, Zed.
3단계 — 첫 번째 도구 호출하기
연결 확인:
Run diagnostics on LMCP and tell me which tools are available.
이메일 읽기:
What are my 5 most recent unread emails?
캘린더 확인:
What is on my calendar today and tomorrow?
일일 브리핑 받기:
Give me a morning brief — my emails, calendar events, and reminders for today.
작동 확인하기
첫 번째 도구 호출 후, 어떤 도구가 호출되었는지 보여주는 도구 사용 블록이 나타납니다. Claude가 실제 이메일이나 캘린더 데이터로 응답한다면 LMCP가 올바르게 설정된 것입니다.
다음과 같이 요청할 수도 있습니다:
Run run_diagnostics and show me the full health report.
권한 부여하기
처음 사용할 때 macOS가 Contacts, Calendar, Reminders에 대한 접근 권한을 부여하라는 메시지를 표시합니다. 허용을 클릭하세요. 접근을 거부한 경우 시스템 설정 → 개인 정보 보호 및 보안으로 이동하여 다시 활성화하세요.
자주 발생하는 문제
“Claude Desktop에 LMCP 도구가 보이지 않습니다”
Claude Desktop을 완전히 종료한 후 (Cmd+Q) 다시 엽니다. 그런 다음 확인합니다:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
mcpServers에서 "local-mcp"이 보여야 합니다. 보이지 않으면 설치 프로그램을 다시 실행하세요.
“Cursor가 도구를 사용하지 않습니다”
Agent 모드로 전환하세요 — 표준 Chat 모드에서는 도구를 사용할 수 없습니다.
“Claude가 내 이메일에 접근할 수 없다고 말합니다”
Mail.app이 열려 있고, 계정이 거기에 구성되어 있으며, LMCP가 시스템 설정 → 개인 정보 보호 및 보안 → 자동화에서 필요한 권한을 가지고 있는지 확인하세요.
“설치 명령이 실패했습니다”
다음을 시도해 보세요:
npx -y local-mcp@latest setup
다음 단계
질문이 있으신가요? Claude에게 report_problem 도구를 사용하도록 요청하거나, LMCP 트레이 아이콘을 열고 Report Problem을 클릭하세요.
댓글
댓글은 게시 전에 검토됩니다.