{"title":"Claude Desktop에서 MCP","slug":"claude-desktop","category":"mcp","summary":"2분 안에 Synapse를 Claude Desktop에 연결. Claude가 79개의 Synapse 도구를 네이티브로 받습니다.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":342,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Claude Desktop에서 MCP\n\nClaude Desktop은 macOS 및 Windows용 Anthropic의 데스크톱 앱입니다. Synapse\nMCP 서버를 구성하면 Claude가 79개의 모든 Synapse 도구에 네이티브로 접근할\n수 있습니다 — 메모리 저장, 회상, 작업 관리, 채팅 등이 가능합니다.\n\n## 사전 요구 사항\n\n- Claude Desktop 앱 (macOS 또는 Windows)\n- Node.js 18+ 설치 (`node --version`)\n- 귀하의 Synapse Mind Key\n\n## 1단계: 구성 파일 열기\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n파일이 없으면 생성하십시오.\n\n## 2단계: Synapse MCP 서버 추가\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> 이미 다른 MCP 서버가 구성된 경우, 기존 `\"mcpServers\"` 객체 안에\n> `\"synapse\"` 블록을 추가하면 됩니다.\n\n## 3단계: Claude Desktop 재시작\n\n1. Claude Desktop을 완전히 종료 (macOS에서 Cmd+Q, 창 닫기가 아님)\n2. Claude Desktop 다시 열기\n3. 새 채팅 시작\n4. 좌측 하단의 🔌 플러그 아이콘 확인 — \"79 tools\"라고 표시되어야 함\n\n## 4단계: 테스트\n\n새 채팅에서 입력:\n\n```\nmemory_recall aufrufen\n```\n\nClaude가 `memory_recall` 도구를 호출하고 저장된 메모리의 요약으로 응답해야\n합니다 (마인드가 비어 있는 경우 \"No memories yet\").\n\n## 사용 가능한 도구 (선택)\n\n| 도구 | 설명 |\n|------|-------------|\n| `memory_recall` | 모든 메모리 회상 |\n| `memory_store` | 새 메모리 저장 |\n| `memory_search` | 메모리 검색 |\n| `task_list` | 작업 나열 |\n| `task_create` | 작업 생성 |\n| `chat_poll` | 새 메시지 확인 |\n| `chat_reply` | 메시지에 응답 |\n| `browser_new` | 브라우저 탭 열기 |\n| `computer_list` | 등록된 컴퓨터 나열 |\n\n전체 목록: [MCP란 무엇입니까?](/docs/mcp/what-is-mcp)\n\n## 문제 해결\n\n### Claude Desktop에 도구가 나타나지 않음\n\n1. Node.js 버전 확인: `node --version` (≥ 18이어야 함)\n2. 구성 파일이 유효한 JSON인지 확인 (후행 쉼표 없음)\n3. Claude Desktop을 완전히 재시작 (Cmd+Q, 창 닫기가 아님)\n4. Claude Desktop 로그 확인: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### \"Mind Key invalid\" 오류\n\n- `SYNAPSE_MIND_KEY`가 `mk_`로 시작하는지 확인\n- `POST /minds`로 새 키 받기 (`/login`의 JWT 필요)\n- JSON에서 키 주변에 따옴표 없음\n\n### npx를 찾을 수 없음\n\n- Node.js 18+ 설치: \n- 설치 후 터미널 재시작\n- Homebrew가 있는 macOS: `brew install node`\n\n### 도구는 표시되지만 호출이 실패\n\n- `SYNAPSE_URL`이 접근 가능한지 확인: `curl https://synapse.schaefer.zone/health`\n- Mind Key가 작동하는지 확인: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- [MCP 문제 해결](/docs/mcp/troubleshooting) 참조\n\n## 도구 프로필 (토큰 절약)\n\n더 작은 LLM을 사용하거나 컨텍스트 토큰을 절약하려는 경우, 도구 프로필 설정:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\n프로필: `minimal` (8개 도구), `standard` (25), `full` (119, 기본값).\n\n## 다음 단계\n\n- [Claude Code 설정](/docs/mcp/claude-code)\n- [Cursor 설정](/docs/mcp/cursor)\n- [MCP 문제 해결](/docs/mcp/troubleshooting)\n","content_html":"

Claude Desktop에서 MCP

\n

Claude Desktop은 macOS 및 Windows용 Anthropic의 데스크톱 앱입니다. Synapse\nMCP 서버를 구성하면 Claude가 79개의 모든 Synapse 도구에 네이티브로 접근할\n수 있습니다 — 메모리 저장, 회상, 작업 관리, 채팅 등이 가능합니다.

\n

사전 요구 사항

\n\n

1단계: 구성 파일 열기

\n\n

파일이 없으면 생성하십시오.

\n

2단계: Synapse MCP 서버 추가

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
이미 다른 MCP 서버가 구성된 경우, 기존 `\"mcpServers\"` 객체 안에\n`\"synapse\"` 블록을 추가하면 됩니다.

3단계: Claude Desktop 재시작

\n
    \n
  1. Claude Desktop을 완전히 종료 (macOS에서 Cmd+Q, 창 닫기가 아님)
    2. \n
  2. Claude Desktop 다시 열기
    3. \n
  3. 새 채팅 시작
    4. \n
  4. 좌측 하단의 🔌 플러그 아이콘 확인 — "79 tools"라고 표시되어야 함
    5. \n
\n

4단계: 테스트

\n

새 채팅에서 입력:

\n
memory_recall aufrufen

Claude가 memory_recall 도구를 호출하고 저장된 메모리의 요약으로 응답해야\n합니다 (마인드가 비어 있는 경우 "No memories yet").

\n

사용 가능한 도구 (선택)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
도구설명
memory_recall모든 메모리 회상
memory_store새 메모리 저장
memory_search메모리 검색
task_list작업 나열
task_create작업 생성
chat_poll새 메시지 확인
chat_reply메시지에 응답
browser_new브라우저 탭 열기
computer_list등록된 컴퓨터 나열
\n

전체 목록: MCP란 무엇입니까?

\n

문제 해결

\n

Claude Desktop에 도구가 나타나지 않음

\n
    \n
  1. Node.js 버전 확인: node --version (≥ 18이어야 함)
    2. \n
  2. 구성 파일이 유효한 JSON인지 확인 (후행 쉼표 없음)
    3. \n
  3. Claude Desktop을 완전히 재시작 (Cmd+Q, 창 닫기가 아님)
    4. \n
  4. Claude Desktop 로그 확인: ~/Library/Logs/Claude/mcp.log (macOS)
    5. \n
\n

"Mind Key invalid" 오류

\n\n

npx를 찾을 수 없음

\n\n

도구는 표시되지만 호출이 실패

\n\n

도구 프로필 (토큰 절약)

\n

더 작은 LLM을 사용하거나 컨텍스트 토큰을 절약하려는 경우, 도구 프로필 설정:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_...",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone",\n        "MCP_PROFILE": "standard"\n      }\n    }\n  }\n}

프로필: minimal (8개 도구), standard (25), full (119, 기본값).

\n

다음 단계

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}