Cursor에서 MCP
코딩 세션 간 영구 프로젝트 메모리를 위해 Synapse를 Cursor IDE에 연결.
Cursor에서 MCP
Cursor는 VS Code 기반의 AI 구동 IDE입니다. Synapse MCP를 사용하면 Cursor가 세션 간에 영구 메모리를 얻습니다 — 프로젝트 결정, 코드베이스 패턴, 과거 디버깅 세션을 기억합니다.
사전 요구 사항
- Cursor IDE 설치 (https://cursor.com)
- Node.js 18+
- 귀하의 Synapse Mind Key
설정
1단계: Cursor 설정 열기
Cursor에서:
- 설정 열기 (macOS에서 Cmd+, Windows/Linux에서 Ctrl+,)
- "MCP" 검색 또는
Cursor Settings → MCP Servers로 이동
2단계: Synapse MCP 서버 추가
"Add MCP Server" 클릭 및 구성:
| 필드 | 값 |
|---|---|
| Name | synapse |
| Type | stdio |
| Command | npx -y synapse-mcp-api@latest |
| Env | SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone |
3단계: config.json 직접 편집 (대안)
Cursor는 ~/.cursor/config.json에 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"
}
}
}
}4단계: Cursor 재시작
Cursor를 완전히 재시작 (macOS에서 Cmd+Q 후 다시 열기).
작동 확인
Cursor의 채팅 패널 (Cmd+L)에서:
recall all my memoriesCursor가 memory_recall을 호출하고 저장된 메모리로 응답해야 합니다.
일반적인 패턴
프로젝트 온보딩
새 프로젝트를 열 때:
recalling project context — what do I know about this codebase?Cursor가 memory_recall을 호출하고 중단한 곳에서 작업을 계속합니다.
아키텍처 결정
store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."Cursor가 high 우선순위로 project 메모리로 저장합니다.
디버깅 기록
what bugs have I hit in this codebase?Cursor가 mistake 메모리를 검색하고 과거 수정을 상기시켜 줍니다.
세션 간 코드 패턴
search memories: "authentication pattern"Cursor가 이전에 구현한 인증 구현에 대한 메모리를 찾습니다.
문제 해결
MCP 서버가 연결되지 않음
- Node.js 확인:
node --version(≥ 18) - MCP 서버 테스트:
npx -y synapse-mcp-api@latest(오류 없이 시작해야 함) - Cursor의 MCP 로그 확인 (View → Output → MCP)
- Cursor 완전히 재시작
도구가 나타나지 않음
~/.cursor/config.json이 유효한 JSON인지 확인SYNAPSE_MIND_KEY환경 변수가 설정되었는지 확인- Cursor 버전이 MCP를 지원하는지 확인 (≥ 0.42)
Mind Key 무효
# Test your Mind Key directly
curl -H "Authorization: Bearer mk_YOUR_KEY" \
https://synapse.schaefer.zone/memory/recall