Claude Code와 Codex MCP — 터미널 AI를 Mac 앱에 연결하세요

Claude Code와 Codex는 코드를 읽고 쓰는 데는 뛰어나지만, 기본 상태에서는 받은편지함, 캘린더, 프로젝트 폴더 밖의 파일을 볼 수 없습니다. LMCP는 데스크톱 어시스턴트와 같은 로컬 접근 권한을 터미널 AI에 제공합니다. 메일, 캘린더, Teams, Slack, Finder를 무료 네이티브 macOS MCP 서버인 LMCP를 통해 사용할 수 있습니다. 클라우드 릴레이도, API 키도 필요 없습니다. CLI 에이전트의 경우 LMCP는 로컬 stdio로 연결되므로 도구 호출은 에이전트와 Mac 사이에서만 오갑니다.

작동 방식

한 줄 설치 프로그램이 인식하는 클라이언트를 자동으로 감지하고 설정합니다:

npx -y local-mcp@latest setup

그런 다음 터미널 세션을 다시 시작하세요. Claude Code나 Codex를 다시 열었을 때 LMCP 도구가 보이지 않으면 직접 추가하면 됩니다. 각각 명령 하나면 충분합니다:

Claude Code

claude mcp add --env LMCP_ORIGIN=manual --transport stdio --scope user local-mcp -- npx -y local-mcp@latest

--scope user는 그대로 두세요. 이 옵션이 없으면 Claude Code는 서버를 현재 프로젝트에만 저장하며, 그 항목이 LMCP가 나머지 모든 곳에 기록하는 항목보다 우선합니다. 연결은 claude mcp list로 확인할 수 있으며, local-mcp가 연결됨으로 표시되어야 합니다.

Codex

다음 블록을 ~/.codex/config.toml에 추가하세요:

[mcp_servers.local-mcp]
command = "npx"
args = ["-y", "local-mcp@latest"]

[mcp_servers.local-mcp.env]
LMCP_ORIGIN = "manual"

Codex의 CLI, 데스크톱 앱, IDE 확장 프로그램은 모두 이 같은 파일을 읽으므로 한 번만 설정하면 됩니다. 이름은 local-mcp로 유지하세요. LMCP의 설치와 제거가 이 이름을 찾기 때문에, 다른 이름의 블록은 중복으로 남게 됩니다.

연결 후 에이전트가 할 수 있는 일

• 코드를 건드리기 전에 맥락 읽기 — 작업의 출처가 된 티켓이나 스레드를 가져옵니다: search_emails, m365_search_emails, teams_search_messages, slack_search_messages.
• 일정 확인 — 회의를 제안하거나 마감일을 추정하기 전에 list_calendar_events / m365_list_events.
• 저장소뿐 아니라 파일 시스템 전체에서 작업 — 프로젝트 밖에 있는 설정, 명세, 로그를 가져오는 file_search, file_read, finder_list.
• 이미 쓰고 있는 채널로 보고 — 복사해 붙여넣지 않고 상태나 요약을 게시하는 teams_send_channel_message, teams_send_message, send_email.

이런 프롬프트를 써 보세요: “고객이 이 버그를 설명한 메일을 찾아서, 목요일에 내가 비어 있는지 확인하고, Teams의 #eng 채널에 한 줄 상태를 올려 줘.” 앱 세 개를 터미널을 벗어나지 않고 처리합니다.

안전하고 개인정보가 보호되나요?

Claude Code와 Codex의 경우 LMCP는 로컬 stdio로 연결됩니다. Mac에서 프로세스로 실행되어 LMCP 클라우드 릴레이를 거치지 않고 에이전트와 직접 통신하므로, 이러한 도구 호출은 당사 서버를 거치지 않습니다. 다만 에이전트가 읽은 내용은 에이전트가 보내는 곳으로 그대로 전달됩니다. 메일을 열면 그 텍스트는 Anthropic 또는 OpenAI 모델과의 대화에 포함되며 각 사의 약관이 적용됩니다. 또한 모든 호출은 에이전트가 이미 가진 권한 확인(예: Claude Code 자체의 도구 승인 설정)을 거칩니다. LMCP는 사용자가 관리하는 승인을 우회하지 않으며, 에이전트가 요청할 수 있는 기능을 늘려 줄 뿐입니다.

LMCP는 기기에서 로컬 도구를 실행합니다. 클라우드 AI 제공업체와 연결된 서비스는 요청된 데이터를 받을 수 있으며 해당 서비스의 약관이 적용됩니다.

어떤 터미널 AI 클라이언트에서 작동하나요?

• Claude Code — Anthropic의 CLI. claude mcp add 또는 프로젝트 수준의 .mcp.json으로 연결합니다.
• Codex — OpenAI의 CLI, 데스크톱 앱, IDE 확장 프로그램. ~/.codex/config.toml로 연결합니다.
• 로컬 stdio 서버 설정을 읽는 그 밖의 모든 MCP 호환 클라이언트 — 같은 설치로 Cursor, Windsurf, VS Code 등에서도 작동합니다.

받은편지함이나 캘린더를 확인하느라 흐름을 끊지 마세요. LMCP를 설치하고 Claude Code나 Codex에 연결해, 터미널 AI에 부족했던 맥락을 채워 주세요.