모든 AI를 위한 하나의 메모리

MCP 연동

MemoryFirst는 Model Context Protocol(MCP) 서버를 제공합니다. 호환되는 모든 클라이언트(Claude, ChatGPT, Cursor, LM Studio, 자체 에이전트)가 내 신원으로, 검증 가능한 인용과 함께 회사 메모리를 읽고 쓸 수 있습니다. MCP 클라이언트가 없는 로컬 모델도 컨텍스트를 텍스트로 받아 사용할 수 있습니다.

지름길: AI에게 시키세요

커넥터 메뉴를 찾지 못했거나 모바일을 사용 중이라면 이 메시지를 어시스턴트에 붙여 넣으세요. 이 페이지를 읽고 내 클라이언트에 맞는 정확한 단계를 알려 줍니다.

https://mcp.memoryfirst.ai 이것을 MCP 커넥터로 설치하고, 내 AI 클라이언트에 맞는 정확한 단계를 알려 줘.

연결하는 두 가지 방법

원격(권장)

모든 클라이언트와 모든 팀원이 하나의 HTTP 엔드포인트를 사용합니다. 설치할 것이 없으며 모바일과 claude.ai에서도 작동합니다.

https://mcp.memoryfirst.ai

이전 URL은 이미 설정해 둔 경우 계속 작동합니다: https://api.memoryfirst.ai/mcp

stdio 전용 클라이언트

로컬 프로세스만 실행하는 클라이언트(구버전 Claude Desktop, 스크립트)는 오픈소스 브리지 mcp-remote로 같은 원격 서버에 연결하고 OAuth로 로그인합니다. 자체 npm 패키지는 없습니다.

npx -y mcp-remote https://mcp.memoryfirst.ai

인증과 신원

  • API 키: 스크립트, CLI, 에이전트용입니다. 설정 → API 키에서 만들며 다음과 같이 전송합니다: Authorization: Bearer mf_live_…
  • OAuth: 사람용입니다. 클라이언트가 MemoryFirst 로그인 화면을 열면 내 계정으로 로그인하며, 모든 호출에 내 이름과 사용한 AI가 서명처럼 남습니다. 키를 복사할 필요가 없습니다.
  • 팀: 워크스페이스의 각 멤버는 소유자, 멤버, 읽기 전용 중 하나의 역할을 가집니다. 읽기 전용 멤버는 기억하고 질문할 수 있지만 기록할 수는 없습니다. 이벤트에는 작성자(사람과 모델)가 저장됩니다.

클라이언트별 설정

  • Claude Code: claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai --header "Authorization: Bearer mf_live_…"
  • claude.ai, Claude Desktop, Claude iOS: 설정 → 커넥터 → 위 URL로 사용자 지정 커넥터 추가. 접근은 OAuth로 이루어집니다.
  • ChatGPT: 설정 → 커넥터 → 위 URL로 만들기. mf_* 도구와 함께 커넥터의 search와 fetch 도구를 사용합니다.
  • Cursor, VS Code, Windsurf: MCP 서버 파일에 다음을 추가하세요: { "mcpServers": { "memoryfirst": { "url": "https://mcp.memoryfirst.ai", "headers": { "Authorization": "Bearer mf_live_…" } } } }
  • LM Studio, Open WebUI, Jan: MCP를 지원하는 모든 데스크톱 클라이언트가 같은 URL과 같은 키를 사용합니다. 내 컴퓨터에서 실행되는 모델이 회사 메모리를 읽고 씁니다.
  • 자체 에이전트: HTTP 위의 JSON-RPC 2.0(initialize, tools/list, tools/call), 무상태. 어떤 MCP SDK로도 작동합니다.

ChatGPT 연결

  1. ChatGPT에서 설정 → 앱 및 커넥터를 여세요. 요금제에서 자체 커넥터에 개발자 모드를 요구하는 경우 고급 설정에서 켜세요.
  2. 만들기를 누르고 이름을 MemoryFirst로 정한 뒤 OAuth 인증을 선택하고 MCP 서버 URL에 다음을 붙여 넣으세요: https://mcp.memoryfirst.ai
  3. ChatGPT가 MemoryFirst 화면으로 이동시킵니다. 계정으로 로그인하고 워크스페이스, 접근 수준(읽기 전용이 기본 선택), 범위, 원한다면 만료 기한을 고른 뒤 승인을 누르세요.
  4. 채팅에서 도구 메뉴로 MemoryFirst를 켜세요. ChatGPT는 search와 fetch로 검색하고 mf_query로 질문하며, 읽기 및 쓰기 권한이 있으면 mf_record로 기록할 수도 있습니다.

Claude 연결

  1. claude.ai에서 설정 → 커넥터 → 사용자 지정 커넥터 추가를 열고 URL을 붙여 넣으세요(Team과 Enterprise 요금제에서는 조직 관리자가 추가합니다): https://mcp.memoryfirst.ai
  2. 연결을 누르면 MemoryFirst 화면이 열립니다. 로그인하고 워크스페이스, 접근 수준, 범위, 만료 기한을 고른 뒤 승인을 누르세요.
  3. 커넥터는 같은 계정으로 claude.ai, Claude Desktop, 모바일 앱에서 사용할 수 있으며, 대화마다 도구 메뉴에서 켜세요.
  4. Claude Code에서는 서버를 추가한 뒤 /mcp로 승인하세요(또는 위와 같이 API 키를 사용하세요): claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai

내 세션을 답변에서 제외하기

Claude Code 세션 id를 X-MemoryFirst-Session 헤더로 보내면 mf_query와 search가 해당 세션의 녹취록을 결과에서 제외하므로, 방금 한 질문이 메아리처럼 답변으로 돌아오지 않습니다. 선택 사항이며, 보내지 않아도 아무것도 달라지지 않습니다. 값은 영문자, 숫자, 하이픈, 밑줄로 이루어진 8~128자여야 하며 그 외의 값은 무시됩니다. Claude Code는 연결할 때마다 저장된 설정의 환경 변수 참조를 확장하므로 id는 실행 중인 세션의 환경에서 읽힙니다. 터미널에서는 서버를 추가할 때 변수가 확장되지 않도록 작은따옴표를 사용하세요. 이는 Claude Code가 환경에 CLAUDE_CODE_SESSION_ID를 노출하는 것에 의존하므로, 사용 중인 버전이 노출하지 않으면 헤더가 비어 있거나 확장되지 않은 채로 전송되어 서버가 무시합니다.

명령줄에서(API 키로 연결한다면 Authorization 헤더도 함께 추가하세요):

claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai \
  --header 'X-MemoryFirst-Session: ${CLAUDE_CODE_SESSION_ID}'

또는 .mcp.json에서:

{
  "mcpServers": {
    "memoryfirst": {
      "type": "http",
      "url": "https://mcp.memoryfirst.ai",
      "headers": { "X-MemoryFirst-Session": "${CLAUDE_CODE_SESSION_ID}" }
    }
  }
}

stdio 서버(@memoryfirst/mcp-server)와 Claude Code 훅은 세션 id를 알고 있으면 이 헤더를 자동으로 보냅니다.

각 접근 수준의 의미

애플리케이션은 최대 권한을 요청하고, 얼마나 줄지는 내가 정합니다. 내 역할이 허용하는 것 이상은 절대 받을 수 없습니다. 읽기 전용 멤버는 쓰기를 선택해도 기록할 수 없습니다.

  • 읽기 전용(기본값): 메모리를 조회합니다: mf_recall, mf_query, mf_projects, mf_state, search, fetch. 이벤트 기록, 상태 재생성, 작업 변경은 할 수 없습니다.
  • 읽기 및 쓰기: 추가로 결정과 이벤트를 기록하고(mf_record), 상태를 재생성하고, 작업을 만들거나 업데이트하며, 내 이름으로 서명됩니다. 위험: AI가 악의적인 내용(웹페이지, 이메일 등)을 읽으면 메모리에 거짓 데이터를 기록하도록 유도될 수 있습니다. 정말 필요한 애플리케이션에만 부여하세요.
  • 일부 프로젝트만: 연결은 내가 선택한 프로젝트만 볼 수 있습니다. 워크스페이스 전체를 훑는 도구(search, mf_morning, mf_assets, mf_skills)는 사용할 수 없으며, ChatGPT에서는 프로젝트를 지정해 mf_query로 질문하세요.
  • 만료: 선택한 날짜가 지나면 연결이 작동하지 않으며 애플리케이션이 다시 권한을 요청해야 합니다.
  • 해제: 대시보드의 연결된 앱에 각 연결의 수준, 프로젝트, 승인자, 마지막 사용 시점이 나열됩니다. 해제하면 갱신이 중단되고 다음 호출부터 연결이 작동하지 않습니다.

원클릭 설치

서버가 이미 설정된 상태로 에디터가 열립니다. 처음 사용할 때 MemoryFirst 계정으로 로그인하라는 안내가 표시됩니다.

MCP 클라이언트가 없는 로컬 모델

Ollama, llama.cpp 등 시스템 프롬프트만 받는 모든 모델: 토큰 예산에 맞춰 정리된 프로젝트 컨텍스트를 요청해 전달하세요. 다른 클라이언트가 보는 것과 같은 상태이며, 클라이언트만 바뀔 뿐 메모리는 같습니다.

# 요청한 예산 안에서 마크다운으로 된 프로젝트 상태
CONTEXT=$(curl -s "https://api.memoryfirst.ai/v1/brain/context?project=lexiel&max_tokens=3000" \
  -H "Authorization: Bearer $MEMORYFIRST_API_KEY")

ollama run llama3.1 --system "$CONTEXT"

Claude Code에서는 이 과정이 이미 자동화되어 있습니다(시작 시 컨텍스트 제공, 종료 시 세션을 이벤트로 정리). 사용 도구: @memoryfirst/claude-hooks.

도구

원격과 로컬에서 동일하며, 동등성은 테스트로 검증합니다.

  • mf_recall · 프로젝트의 결정, 블로커, 배포, 현재 유효한 상태
  • mf_query · 인용이 달린 자연어 질문. 파티션과 문서 유형으로 범위를 좁힐 수 있습니다
  • mf_record · 결정, 블로커, 배포, 고객 연락을 기록합니다. 내 신원과 내 AI의 서명이 남습니다
  • mf_projects · 워크스페이스 메모리의 프로젝트 목록과 프로젝트별 이벤트 수
  • mf_morning · 워크스페이스의 최근 24시간 브리핑(유형별)
  • mf_skills · 반복된 질문에서 컴파일된 스킬 카탈로그와 해당 SKILL.md
  • mf_assets · 워크스페이스의 자산과 프로젝트 레지스트리
  • mf_state · 프로젝트의 현재 유효한 상태(과거 이력이 아닌 지금 유효한 것)
  • search · ChatGPT 커넥터용 검색
  • fetch · ChatGPT 커넥터용으로, id로 이벤트 전체를 가져옵니다

검증 가능한 인용

각 mf_query 응답에는 인용마다 spanRef 가 포함됩니다. 문서는 페이지와 영역, 오디오는 밀리초, 브레인에서는 이벤트 id입니다. 클라이언트가 이를 출처 링크로 표시합니다.

{
  "answer": "The contract scope is fixed-fee €4,500.",
  "citations": [
    {
      "sourceType": "doc",
      "spanRef": { "page": 3, "bbox": [120, 450, 380, 60] },
      "snippet": "Fixed fee of €4,500 for the scope defined..."
    },
    {
      "sourceType": "ops",
      "spanRef": { "source": "brain.event:decision_taken:78048c2c-…", "eventId": "chunk:0" },
      "snippet": "Decision (Jose, claude-code): fixed fee confirmed with the client on 12 May."
    }
  ]
}

자세한 스키마, 오류 코드, 플랜별 한도는 API 레퍼런스에 있습니다. 빠진 내용이 있나요? 문의: hola [at] memoryfirst.ai.