간단한 답변
프로세스 내부에 상태를 저장하는 대신 사용자 지정 MCP 서버에 외부 기억 레이어를 연결하세요. MemoryLake Project를 생성하고, MCP Server 엔드포인트를 생성한 다음, 핸들러 내부에서 Bearer 토큰으로 비밀을 사용하여 엔드포인트 URL을 호출하여 컨텍스트를 읽거나 씁니다. 기억은 모든 세션에 걸쳐 지속되며, 서버의 모든 인스턴스가 동일한 저장소에 접근합니다.
사용자 지정 MCP 서버에서 프로세스 내 기억이 부족한 이유
당신이 작성한 서버에 기억을 추가하는 가장 빠른 방법은 모듈 수준의 사전 또는 코드와 함께 번들된 간단한 SQLite 파일입니다. 개발에서는 잘 작동하지만, 첫 번째 엣지 케이스에서 모델이 깨집니다: 프로세스를 재시작하면 사전이 비워지고, 두 개의 인스턴스를 배포하면 서로 다르게 되고, 프로젝트를 팀원에게 넘기면 그들은 검토할 기록이 없는 빈 슬레이트에서 시작하게 됩니다.
더 깊은 문제는 프로세스 내 저장이 두 가지 책임을 혼합한다는 것입니다. 서버는 요청 핸들러입니다 — 그 일은 도구 호출을 해석하고 결과를 반환하는 것입니다. 상태 내구성도 소유하게 되면, 스키마 마이그레이션, 백업 일정 및 내보내기 파이프라인을 도구 논리에 집중해야 하는 코드 내부에서 관리하게 됩니다.
기억을 외부화하면 이러한 문제를 깔끔하게 분리합니다. 핸들러는 얇게 유지됩니다: 기억 레이어를 호출하고, 반환된 컨텍스트를 통합하고, 도구 논리를 실행하며, 선택적으로 새로운 사실을 다시 씁니다. 기억 레이어는 지속성, 버전 관리, 검색 및 접근 제어를 처리합니다. 서버의 코드베이스에 인프라를 추가하지 않고도 재시작 및 인스턴스 간에 내구성 있는 기록을 얻을 수 있습니다.
시작하기 전에
당신은 다음이 필요합니다:
- 무료 MemoryLake 계정
- 당신이 작성하고 수정할 수 있는 사용자 지정 MCP 서버 코드베이스
- 지속하고 싶은 컨텍스트 — 사용자 선호도, 프로젝트 규칙 또는 참조 파일(PDF, Word, Excel, PowerPoint, Markdown 또는 이미지)
사용자 지정 MCP 서버에 장기 기억 추가하는 방법 (단계별)
1단계: 기억 프로젝트 구축하기
MemoryLake에 로그인하고 프로젝트 관리를 엽니다. 프로젝트 생성을 클릭하고 서버의 도메인에 매핑되는 이름을 지정합니다 — 예를 들어, "사용자 지정 서버 기억" 또는 테넌트별 레이블. 문서 드라이브를 열고 업로드를 사용하여 서버의 핸들러가 읽을 수 있어야 하는 참조 파일을 푸시합니다. 그런 다음 문서 탭 → 문서 추가 → 확인을 열어 프로젝트에 첨부합니다. 규칙, 제약 조건 또는 사용자 사실에 대해서는 기억 탭 → 기억 추가를 열고 항목을 입력한 후 저장을 클릭합니다.
2단계: MCP 서버 엔드포인트 생성하기
MCP 서버 탭 → MCP 서버 추가로 이동합니다. 설명적인 레이블을 지정합니다 — 예를 들어, "사용자 지정 MCP 백엔드" — 그런 다음 생성을 클릭합니다. MemoryLake는 세 가지 값을 반환합니다: 키 ID, 비밀, 및 엔드포인트 URL. 비밀을 즉시 복사하세요; 패널을 닫은 후에는 다시 가져올 수 없습니다.
3단계: MCP를 통해 MemoryLake에 서버 연결하기
사용자 지정 서버의 MCP 구성에서 엔드포인트 URL을 붙여넣고 비밀을 Bearer 토큰으로 설정합니다. 이제 핸들러는 도구 호출 시작 시 컨텍스트를 읽거나 끝에서 새로운 사실을 쓸 수 있습니다. 인증은 요청별로 이루어지므로, 서버의 모든 인스턴스가 동일한 프로젝트에 접근하며, 기억은 복제본 수에 관계없이 일관되게 축적됩니다. 전체 구성 참조는 MCP 설정 가이드를 참조하세요. [MemoryLake 무료 사용해보기]
사용자 지정 서버 내장 저장소 vs MemoryLake
| 차원 | 프로세스 내 / 번들 저장소 | MemoryLake |
|---|---|---|
| 세션 간 지속 | 아니오 (재시작 시 지워짐) | 예 |
| 다른 AI와 작동 | 아니오 | 예 — ChatGPT, Claude, Gemini, 모든 MCP 도구 |
| 용량 | 로컬 디스크 / 기억에 의해 제한됨 | 무제한 프로젝트 및 문서 |
| 버전 관리 | 아니오 | 예 (Git 스타일의 기록) |
| 데이터 소유권 | 변동적, 내보내기 보장 없음 | 당신이 소유 (AES-256, 언제든지 내보내기/삭제 가능) |
| 벤치마크 | — | LoCoMo #1 — 94.03% |
팁 및 모범 사례
- 논리적 테넌트 또는 작업 공간당 하나의 프로젝트 범위를 설정하여 서버가 요청에서 프로젝트 식별자를 전달하여 읽기를 라우팅할 수 있도록 하여 서로 다른 사용자의 기억을 분리합니다.
- 구조화된 규칙과 사실을 기억 항목에 저장하고 문서 드라이브에 더 큰 참조 문서를 저장합니다 — 짧은 항목은 도구 핸들러의 왕복에서 더 빠르게 검색됩니다.
- 핸들러 시작 시 컨텍스트를 읽고 끝에서 업데이트된 사실을 씁니다; 이렇게 하면 각 호출이 독립적으로 유지되고 어떤 인스턴스도 로컬 상태 없이 어떤 요청이든 처리할 수 있습니다.
- Bearer 토큰을 정기적으로 회전시키고 MCP 서버 탭에서 이전 키를 무효화한 후 새 키를 생성하여 배포 구성에서 업데이트하고 재배포합니다. 세션을 소모할 필요는 없습니다.
문제 해결
- 핸들러가 오래된 또는 누락된 컨텍스트를 반환함: 서버 구성의 엔드포인트 URL이 올바른 프로젝트를 가리키고 이전 빌드의 로컬 환경 변수에 의해 재정의되지 않았는지 확인합니다.
- 401로 인증 거부됨: Bearer 토큰은 복사한 비밀 값과 정확히 일치해야 하며, 키 ID가 아닙니다. MCP 구성에서 설정된 값을 다시 확인하세요.
- 시작 시 "비밀을 찾을 수 없음" 오류: 비밀은 한 번만 표시됩니다. MCP 서버 탭을 열고 기존 키를 무효화한 후 새 키 ID, 비밀 및 엔드포인트 URL을 생성합니다.
당신의 사용자 지정 서버에 기억을 부여하세요
당신의 서버는 도구 논리를 처리합니다; MemoryLake는 단일 요청보다 더 오래 지속되어야 하는 모든 것을 처리합니다.