# Claude Desktop에서 MCP
SUMMARY: 2분 안에 Synapse를 Claude Desktop에 연결. Claude가 79개의 Synapse 도구를 네이티브로 받습니다.

KEY CONTEXT:
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
             %APPDATA%\Claude\claude_desktop_config.json (Windows)
MCP server command: npx -y synapse-mcp-api@latest
Env vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)
After config: restart Claude Desktop, check for 🔌 icon with "79 tools"
Test: type "memory_recall aufrufen" in a new chat
Troubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting

Claude Desktop에서 MCP
Claude Desktop은 macOS 및 Windows용 Anthropic의 데스크톱 앱입니다. Synapse
MCP 서버를 구성하면 Claude가 79개의 모든 Synapse 도구에 네이티브로 접근할
수 있습니다 — 메모리 저장, 회상, 작업 관리, 채팅 등이 가능합니다.
사전 요구 사항
- Claude Desktop 앱 (macOS 또는 Windows)
- Node.js 18+ 설치 ()
- 귀하의 Synapse Mind Key
1단계: 구성 파일 열기
- macOS: 
- Windows: 
파일이 없으면 생성하십시오.
2단계: Synapse MCP 서버 추가
[CODE BLOCK]
> [!TIP]
> 이미 다른 MCP 서버가 구성된 경우, 기존  객체 안에
>  블록을 추가하면 됩니다.
3단계: Claude Desktop 재시작
1. Claude Desktop을 완전히 종료 (macOS에서 Cmd+Q, 창 닫기가 아님)
2. Claude Desktop 다시 열기
3. 새 채팅 시작
4. 좌측 하단의 🔌 플러그 아이콘 확인 — "79 tools"라고 표시되어야 함
4단계: 테스트
새 채팅에서 입력:
[CODE BLOCK]
Claude가  도구를 호출하고 저장된 메모리의 요약으로 응답해야
합니다 (마인드가 비어 있는 경우 "No memories yet").
사용 가능한 도구 (선택)
| 도구 | 설명 |
|------|-------------|
|  | 모든 메모리 회상 |
|  | 새 메모리 저장 |
|  | 메모리 검색 |
|  | 작업 나열 |
|  | 작업 생성 |
|  | 새 메시지 확인 |
|  | 메시지에 응답 |
|  | 브라우저 탭 열기 |
|  | 등록된 컴퓨터 나열 |
전체 목록: MCP란 무엇입니까?
문제 해결
Claude Desktop에 도구가 나타나지 않음
1. Node.js 버전 확인:  (≥ 18이어야 함)
2. 구성 파일이 유효한 JSON인지 확인 (후행 쉼표 없음)
3. Claude Desktop을 완전히 재시작 (Cmd+Q, 창 닫기가 아님)
4. Claude Desktop 로그 확인:  (macOS)
"Mind Key invalid" 오류
- 가 로 시작하는지 확인
- 로 새 키 받기 (의 JWT 필요)
- JSON에서 키 주변에 따옴표 없음
npx를 찾을 수 없음
- Node.js 18+ 설치: <https://nodejs.org/>
- 설치 후 터미널 재시작
- Homebrew가 있는 macOS: 
도구는 표시되지만 호출이 실패
- 이 접근 가능한지 확인: 
- Mind Key가 작동하는지 확인: 
- MCP 문제 해결 참조
도구 프로필 (토큰 절약)
더 작은 LLM을 사용하거나 컨텍스트 토큰을 절약하려는 경우, 도구 프로필 설정:
[CODE BLOCK]
프로필:  (8개 도구),  (25),  (119, 기본값).
다음 단계
- Claude Code 설정
- Cursor 설정
- MCP 문제 해결