# 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 서버 추가

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> 이미 다른 MCP 서버가 구성된 경우, 기존 `"mcpServers"` 객체 안에
> `"synapse"` 블록을 추가하면 됩니다.

## 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").

## 사용 가능한 도구 (선택)

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

전체 목록: [MCP란 무엇입니까?](/docs/mcp/what-is-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 문제 해결](/docs/mcp/troubleshooting) 참조

## 도구 프로필 (토큰 절약)

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

```json
{
  "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 설정](/docs/mcp/claude-code)
- [Cursor 설정](/docs/mcp/cursor)
- [MCP 문제 해결](/docs/mcp/troubleshooting)