AI 메모리를 위한 MCP 설정은 실제로 얼마나 걸리나요?

네 가지 주요 MCP 클라이언트(Claude Desktop, Cursor, Windsurf, Claude Code)에 대해 약 5분. 가장 느린 단계는 가입하고 API 키를 생성하는 것입니다. 구성 편집 자체는 단일 JSON 블록입니다.

여러 MCP 클라이언트에 걸쳐 동일한 Alma 메모리를 사용할 수 있나요?

예. 다른 클라이언트의 동일한 API 키가 동일한 메모리 저장소를 읽고 씁니다. 아침에 Claude Desktop에서 메모리를 저장하고, 오후에 Cursor에서 참조하고, 터미널의 Claude Code에서 쿼리하세요 — 동일한 두뇌, 모든 표면.

MCP 서버는 모든 Alma 플랜에서 작동하나요?

예. MCP 서버는 무료로 설치할 수 있으며(npm 패키지) 모든 유료 Alma 플랜에서 작동합니다.

내 MCP 클라이언트가 Claude Desktop, Cursor, Windsurf 또는 Claude Code가 아니라면 어떻게 하나요?

Alma MCP 서버는 stdio를 통해 바닐라 MCP를 말하므로 모든 호환 클라이언트가 작동합니다. 패턴은 항상 동일합니다: command + args + env 블록. 막히면 ALMA_DEBUG=1을 설정하여 핸드셰이크를 검사하세요.

AI 메모리를 위한 MCP 사용 방법: 5분 설정

2026년 5월 · 7분 분량 · Fran Olivares, Founder of OlivaresAI

AI 메모리에 MCP를 사용하려면 @olivaresai/alma-mcp를 서버로 설치하고, Alma API 키와 함께 MCP 클라이언트 구성(Claude Desktop, Cursor, Windsurf, Claude Code 또는 다른 호환 클라이언트)에 단일 JSON 블록을 붙여넣은 다음 재시작하세요. 서버는 AI가 자율적으로 호출할 수 있는 35개의 메모리 도구를 노출합니다: 메모리 저장, 메모리 검색, 컨텍스트 조립, 사실 추출, Soul 블록 구성. 총 설정 시간은 약 5분이며 무료 Alma 티어에서 작동합니다.

Model Context Protocol(MCP)은 AI 클라이언트가 외부 도구 및 데이터 소스에 통신할 수 있게 하는 오픈 표준입니다. 클라이언트가 MCP를 말하면 메모리 서버를 연결할 수 있으며 AI는 즉시 영속 메모리 저장소에서 읽고 쓰는 도구를 얻습니다 — 모든 대화, 모든 프로젝트, 매일에 걸쳐. 이 가이드는 2026년 가장 일반적인 네 가지 클라이언트에 대한 5분 설정을 안내하고 이후에 나오는 질문에 답합니다.

AI 메모리를 위한 MCP는 실제로 무엇을 제공하나요?

Alma MCP 서버가 연결되면 AI 클라이언트는 아무것도 입력하지 않고도 호출할 수 있는 35개의 새 도구를 얻습니다. 가장 중요한 것: alma_remember(사실 또는 선호도 저장), alma_recall(자연어 쿼리로 메모리 검색), alma_assemble_context(모든 메모리 레이어에서 현재 질문에 대한 구조화된 컨텍스트 구축), alma_extract(텍스트 블록에서 사실 채굴), alma_update_block(AI 정체성을 위한 Soul Engine 블록 구성), episodes, procedures, environments, conversations, 웹 검색, 파일 생성 등을 위한 도구.

실제로 AI는 사용자가 메모리 관련된 것을 물을 때 이러한 도구를 호출합니다. "ESM 모듈을 선호한다는 것을 기억해" → AI는 alma_remember를 호출합니다. "새 서비스에 대해 어떤 스택에 동의했나?" → AI는 alma_recall을 호출합니다. 도구 왕복은 1초 미만이며, 사용자는 약간 더 사려 깊은 답변을 볼 뿐입니다.

Claude Desktop에서 AI 메모리를 위한 MCP를 어떻게 설정하나요?

1단계. alma.olivares.ai에서 가입하세요. 진입 티어로 Starter 플랜($14/월)으로 시작하세요.

2단계. Settings → API Keys에서 키를 생성하고 복사하세요.

3단계. Claude Desktop의 구성 파일을 여세요. macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json에 있고; Windows에서는 %APPDATA%\Claude\claude_desktop_config.json에 있습니다.

4단계. mcpServers 객체 내에 Alma 서버를 추가하세요: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. mcpServers가 아직 존재하지 않으면 JSON의 최상위 수준에 만드세요.

5단계. Claude Desktop을 재시작하세요. Alma 도구가 슬래시 메뉴에 나타나고 Claude가 자율적으로 호출할 수 있습니다. 시도해 보세요: "내가 가장 좋아하는 에디터가 Helix라는 것을 기억해". 한 턴 후: "내가 가장 좋아하는 에디터는 무엇?" — Claude가 회상합니다.

Cursor에서 AI 메모리를 위한 MCP를 어떻게 설정하나요?

Cursor의 MCP UI는 Settings → Features → MCP에 있습니다. 이름 alma, command npx, args -y @olivaresai/alma-mcp로 새 서버를 추가하고 키와 함께 env 변수 ALMA_API_KEY를 추가하세요. 저장하고 Cursor를 재시작하세요. Alma 도구는 채팅 도구 사용 표시기에 나타납니다; Composer와 인라인 채팅 모두 액세스할 수 있습니다. Cursor의 프로젝트 컨텍스트와 결합하면 AI는 코드베이스 인식 및 영속적인 교차 프로젝트 메모리를 모두 얻습니다.

Windsurf에서 AI 메모리를 위한 MCP를 어떻게 설정하나요?

Windsurf는 ~/.windsurf/mcp_config.json에서 MCP 구성을 읽습니다. 구조는 Claude Desktop을 미러링합니다: 동일한 Alma 블록이 있는 mcpServers 객체. 편집 후 Windsurf를 재시작하세요. 그러면 Alma 도구가 Cascade에 나타나고 Windsurf는 에이전트 흐름 중에 사용할 수 있습니다 — 특히 이전 세션의 컨벤션을 AI가 회상하도록 하려는 다중 파일 리팩터에 유용합니다.

Claude Code에서 AI 메모리를 위한 MCP를 어떻게 설정하나요?

Claude Code(터미널 네이티브 Claude 클라이언트)는 ~/.config/claude-code/mcp.json에 자체 MCP 구성을 가지고 있습니다. 동일한 Alma 블록을 떨어뜨리세요. claude mcp list를 실행하여 서버가 등록되었는지 확인하세요. 연결되면 Claude Code는 코딩 세션 중에 Alma의 도구를 사용할 수 있습니다; 각 리포지토리가 자체 메모리 네임스페이스를 갖도록 Alma environments 기능과 결합할 때 특히 강력합니다. 정확한 JSON은 Claude Code 통합 문서를 참조하세요.

내 MCP 클라이언트가 목록에 없으면 어떻게 하나요?

Alma의 MCP 서버는 stdio를 통해 바닐라 MCP를 말하므로 모든 호환 클라이언트가 작동합니다. 패턴은 항상 동일합니다: 클라이언트는 command + args + env 구성 블록을 기대하고, 서버를 자식 프로세스로 실행하며, MCP 핸드셰이크를 통해 도구를 발견합니다. 목록에 없는 클라이언트에 막히면 서버 로그(env에서 ALMA_DEBUG=1 설정)가 핸드셰이크가 성공했는지 알려줍니다.

설정 후 일반적인 워크플로

스택 캡처. AI에 "새 서비스에 Bun + Hono + D1을 사용하고 있다"고 말하세요 — alma_remember를 호출합니다. 이틀 후 다른 대화에서: "/users에 대한 라우트 핸들러를 스캐폴드하세요" — AI는 스택을 회상하고 다시 설명 없이 관용적인 Bun + Hono 코드를 생성합니다.

결정 로깅. "MVP에서 Redis를 건너뛰고 D1을 직접 사용하기로 결정했다." 에이전트는 카테고리 decision과 높은 중요도로 결정을 저장합니다. 몇 주 후 아키텍처를 검토할 때 "왜 Redis가 없나?"는 근거와 함께 원래 결정을 반환합니다.

교차 클라이언트 연속성. 아침에 Claude Desktop에서 메모리를 저장하고, 오후에 Cursor에서 참조하고, 밤에 터미널의 Claude Code에서 쿼리하세요. 동일한 Alma 계정, 동일한 메모리 저장소, 모든 클라이언트가 모든 것을 봅니다.

MCP는 도구뿐만 아니라 대화에서도 작동하나요?

예. Alma의 MCP 서버는 또한 리소스(클라이언트가 구독할 수 있는 읽기 전용 데이터)를 노출합니다: soul, memories, environments, conversations, budget, blocks, episodes, procedures 등. MCP 리소스를 표시하는 클라이언트(특히 Claude Desktop)는 이를 사이드바에 표시하고 업데이트를 스트리밍할 수 있습니다. 브라우저를 열지 않고 Claude Desktop 내부에서 전체 메모리 저장소를 탐색할 수 있습니다.

안전성, 비용, 프라이버시는 어떤가요?

MCP 서버는 AI가 지시하는 것만 수행하며 API 키로만 수행합니다 — 암시적 브로드캐스팅이 없습니다. 모든 메모리 쓰기는 Alma 계정으로 범위가 지정되고, 저장 시 암호화되며, 요청 시 내보낼 수 있습니다. 서버는 로컬 머신에서 실행됩니다; Alma API 자체 외의 다른 제3자를 통해 프록시하지 않습니다. 비용 측면: 서버는 무료로 설치할 수 있습니다; Starter 플랜($14/월)이 Alma의 진입 티어이며 MCP 서버를 실행하는 데 필요한 모든 것을 포함합니다.

5분 설정 후 다음 단계는 무엇인가요?

서버가 실행되면 가장 큰 영향을 주는 움직임은 AI가 사실 메모리 외에도 일관된 정체성을 갖도록 Soul Engine 블록(성격, 전문성, 커뮤니케이션 스타일, 엄격한 규칙)을 채우는 것입니다. alma.olivares.ai의 Alma 웹 앱은 Soul 에디터를 노출합니다; 전체 패턴은 Soul Engine: 지속되는 AI 성격을 참조하세요.

See plans