Claude Desktop에서 MCP

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

사전 요구 사항

• Claude Desktop 앱 (macOS 또는 Windows)
• Node.js 18+ 설치 (node --version)
• 귀하의 Synapse Mind Key

1단계: 구성 파일 열기

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

2단계: Synapse MCP 서버 추가

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

3단계: Claude Desktop 재시작

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

4단계: 테스트

새 채팅에서 입력:

memory_recall aufrufen

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

사용 가능한 도구 (선택)

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

문제 해결

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

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

"Mind Key invalid" 오류

• SYNAPSE_MIND_KEY가 mk_로 시작하는지 확인
• POST /minds로 새 키 받기 (/login의 JWT 필요)
• JSON에서 키 주변에 따옴표 없음

npx를 찾을 수 없음

• Node.js 18+ 설치: https://nodejs.org/
• 설치 후 터미널 재시작
• Homebrew가 있는 macOS: brew install node

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

• SYNAPSE_URL이 접근 가능한지 확인: curl https://synapse.schaefer.zone/health
• Mind Key가 작동하는지 확인: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• MCP 문제 해결 참조

도구 프로필 (토큰 절약)

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

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

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

다음 단계

• Claude Code 설정
• Cursor 설정
• MCP 문제 해결