AI 에이전트 연결하기

빠른 시작

OwlMem은 팀의 모든 AI 에이전트에게 MCP를 통해 하나의 공유 지식 베이스와 메모리를 제공합니다. 에이전트 하나를 연결하는 데 일 분 정도면 충분합니다.

1. 스페이스를 만드세요. owlmem.com/app에서 이메일로 로그인하세요. 첫 스페이스는 무료입니다.
2. AI에 OwlMem을 추가하세요. 앱이 원격 MCP 서버나 사용자 지정 커넥터를 요구하는 곳에 이 주소를 입력하세요.
   복사

   https://mcp.owlmem.com/mcp

3. 승인하세요. 앱이 OwlMem 페이지를 엽니다. 에이전트 이름을 정하고 Allow를 클릭하세요. 이게 전부입니다. 복사할 키는 없습니다.

그다음 에이전트에게 사용법을 알려 주세요. 에이전트 가르치기를 참고하세요. 연결된 모든 앱은 콘솔의 AI agents & tokens → Connected apps에 표시되며, 여기서 언제든 연결을 끊을 수 있습니다.

Claude (웹, 데스크톱, 모바일)

1. Settings → Connectors를 열고 Add custom connector를 선택하세요.
2. 이름을 OwlMem으로 정하고 URL을 붙여넣으세요.
   복사

   https://mcp.owlmem.com/mcp

3. Connect를 클릭하고 OwlMem에 로그인한 뒤 Allow를 클릭하세요.

웹에서 추가한 커넥터는 Claude Desktop과 모바일 앱에서도 작동합니다. Claude의 Team 및 Enterprise 플랜에서는 관리자가 먼저 조직용으로 커넥터를 추가해야 할 수도 있습니다.

Claude Code

서버를 추가하세요(모든 프로젝트에서 쓰려면 --scope user를 붙이세요).

claude mcp add --transport http --scope user owlmem https://mcp.owlmem.com/mcp

그런 다음 Claude Code를 시작해 /mcp를 입력하고, owlmem을 선택한 뒤 Authenticate를 고르세요. 브라우저에서 OwlMem 승인 페이지가 열립니다.

Codex

서버를 추가하면 바로 로그인이 시작됩니다.

codex mcp add owlmem --url https://mcp.owlmem.com/mcp

브라우저 단계가 시간 초과되었다면 codex mcp login owlmem을 실행하세요. 또는 ~/.codex/config.toml에 직접 추가한 뒤 로그인하세요.

[mcp_servers.owlmem]
url = "https://mcp.owlmem.com/mcp"

Codex는 승인 설정에서 허용하지 않는 한 MCP 도구를 호출하기 전에 먼저 묻습니다.

ChatGPT

1. Settings → Apps & Connectors를 여세요. Advanced settings에서 Developer mode를 켜세요.
2. Create를 선택하고 이름을 OwlMem으로 정한 뒤, URL을 붙여넣고 인증 방식으로 OAuth를 선택하세요.
   복사

   https://mcp.owlmem.com/mcp

3. OwlMem에 로그인하고 Allow를 클릭하세요.

사용자 지정 커넥터를 쓸 수 있는지는 ChatGPT 플랜과 워크스페이스 설정에 따라 다릅니다.

Cursor

~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 다음을 추가하세요.

{
  "mcpServers": {
    "owlmem": { "url": "https://mcp.owlmem.com/mcp" }
  }
}

Cursor Settings → MCP를 여세요. OwlMem에 Needs login이 표시되면 클릭하고 브라우저에서 승인하세요.

VS Code (GitHub Copilot)

명령 팔레트에서 MCP: Add Server를 실행하고 HTTP를 선택한 뒤 URL을 붙여넣거나, .vscode/mcp.json에 추가하세요.

{
  "servers": {
    "owlmem": { "type": "http", "url": "https://mcp.owlmem.com/mcp" }
  }
}

Copilot이 처음 서버를 사용할 때 VS Code가 로그인을 요청합니다.

Windsurf, Gemini CLI 등

Windsurf — ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "owlmem": { "serverUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Gemini CLI — ~/.gemini/settings.json에 추가한 뒤 /mcp auth owlmem을 실행하세요.

{
  "mcpServers": {
    "owlmem": { "httpUrl": "https://mcp.owlmem.com/mcp" }
  }
}

OAuth 방식의 원격 MCP 서버를 지원하는 다른 클라이언트도 똑같습니다. URL을 입력하고 승인하세요. OwlMem은 MCP 인증 사양(PKCE와 동적 클라이언트 등록을 포함한 OAuth 2.1)을 지원합니다.

토큰으로 연결하기

스크립트, CI 작업, 오래된 클라이언트처럼 로그인 과정을 처리할 수 없는 도구도 있습니다. 이런 경우 콘솔의 AI agents & tokens → Connect an AI에서 토큰을 만들고 Bearer 토큰으로 보내세요.

Authorization: Bearer om_…

Claude Code 예시:

claude mcp add --transport http owlmem https://mcp.owlmem.com/mcp --header "Authorization: Bearer $OWLMEM_TOKEN"

로컬(stdio) 서버만 실행하는 클라이언트라면 mcp-remote로 연결하세요.

{
  "mcpServers": {
    "owlmem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.owlmem.com/mcp", "--header", "Authorization: Bearer ${OWLMEM_TOKEN}"],
      "env": { "OWLMEM_TOKEN": "om_…" }
    }
  }
}

토큰은 만료되지 않습니다. 더 이상 필요 없으면 콘솔에서 철회하세요. 에이전트는 사용자 본인과 그 이름의 조합이므로, 이미 쓰고 있는 이름으로 새 토큰을 만들면 기존 토큰이 대체되어 즉시 작동을 멈춥니다. 로그인으로 앱을 다시 연결할 때도 마찬가지입니다.

다른 사람의 AI를 위한 초대 토큰

파트너의 에이전트가 계정 없이 조직을 쓸 수 있게 하려면, 주 계정이 AI agents & tokens에서 초대 토큰(omi_…)을 만듭니다. 파트너는 자기 앱에 OwlMem을 추가하고, OwlMem 로그인 페이지에서 로그인하는 대신 토큰을 붙여넣습니다. 토큰은 처음 사용한 AI에 묶이며, 이후 다른 누가 시도하면 거부됩니다. 목록에서 각 토큰이 묶였는지 확인할 수 있고, 토큰을 철회하면 해당 AI의 연결이 끊깁니다.

에이전트가 쓰는 도구

지식은 사람과 에이전트가 다시 찾아 읽는 페이지(사용법, 결정 사항, 프로젝트 노트)를 위한 곳입니다. 메모리는 에이전트가 의미로 불러올 수 있는 개별 사실을 위한 곳입니다.

검색과 불러오기는 모든 요금제에서 무제한입니다. 메모리 저장은 요금제의 월간 메모리 쓰기 횟수에, 문서 작성은 저장 용량에 포함됩니다.

에이전트 가르치기

에이전트의 상시 지침(CLAUDE.md, AGENTS.md, Cursor 규칙, Claude 프로젝트 지침)에 몇 줄만 넣어 두면 에이전트가 OwlMem을 훨씬 잘 활용합니다.

## Team memory (OwlMem)
- Before starting a task, use kb_search (documents) and kb_recall (facts) for the topic.
- When you learn something reusable — a fix, a gotcha, a decision — save it with kb_write
  under lessons/ or projects/<name>/. Search first and update the existing page instead of
  creating a duplicate.
- Store facts that change (prices, versions, status) with kb_retain and snapshot=true or an
  expiry, so they retire on their own.
- Never put passwords or API keys in documents or memory. Use the OwlMem vault.

새 스페이스는 네 개의 폴더(lessons/, projects/, reference/, archive/)로 시작하며, 각 폴더에는 짧은 README가 있습니다. 에이전트는 세 단계 깊이까지 다른 폴더를 만들 수 있습니다.

보관함과 owlmem 명령

보관함은 에이전트에게 필요한 자격 증명을 엔드투엔드 암호화로 보관합니다. 항목은 나만 가진 키로 내 기기에서 암호화되며, OwlMem은 읽을 수 없는 암호문만 저장합니다. 주 계정이 콘솔의 Vault(보관함)에서 켜면 조직의 모든 사람이 사용할 수 있습니다. 이때 표시되는 복구 코드를 꼭 보관하세요. 콘솔이 내 이메일 앱으로 나에게 보내 두도록 제안하므로, 복구 코드는 OwlMem을 거치지 않습니다.

Passkey로 잠금 해제. Your approval methods에서 추가하는 모든 Passkey는 기기의 지문이나 얼굴 인식으로 보관함도 열 수 있도록 설정됩니다(Passkey의 PRF 기능을 사용하며, Chrome, Edge, Safari, Google 비밀번호 관리자, iCloud 키체인의 Passkey가 지원합니다). 그 뒤로는 가져오기, 내보내기, 새 기기 잠금 해제가 한 번의 탭으로 끝나며, 복구 코드는 비상시에만 필요합니다.

에이전트는 owlmem 명령(Node 18 이상)으로 사용합니다.

npm install -g owlmem
owlmem login            # paste a token for this agent
owlmem vault unlock     # press Enter to approve in your browser with a passkey (or paste the recovery code)
owlmem run --env DB_PASSWORD=prod/db:password -- ./deploy.sh

owlmem run은 비밀을 명령의 환경 변수에 넣어 주므로 에이전트는 비밀을 보지 못합니다. 에이전트가 보관함을 직접 쓰게 하려면 로컬 MCP 서버를 추가하세요. 복호화는 내 기기 안에서만 이루어집니다.

claude mcp add owlmem-vault -- npx -y owlmem mcp

owlmem vault unlock에서 Enter를 누르면 브라우저에 에이전트, 기기, 코드가 표시된 페이지가 열립니다. 코드가 터미널과 일치하는지 확인하고 Passkey를 탭하면, 키가 그 기기용으로 암호화되어 그 기기에만 전송됩니다.

에이전트가 보관함을 쓰려면 승인(Passkey, 인증 앱 또는 GitHub)이 필요하며, 한 번에 15분에서 2시간까지 유효합니다. 각자 자기 에이전트를 승인하고, 주 계정은 누구의 에이전트든 승인할 수 있습니다. 삭제와 내보내기는 항상 새로 승인받아야 합니다. Bitwarden, 1Password, KeePass, .env 파일에서 가져오기나 내보내기는 콘솔에서 Passkey를 한 번 탭하거나 owlmem vault import / export로 할 수 있습니다.

백업. 항목이 변경되거나 삭제될 때마다 이전 버전이 30일간 보관됩니다. 주 계정은 보관함 페이지에서 복원할 수 있으며, 복원할 때 대체되는 내용의 사본도 함께 보관됩니다.

요금제와 가격

요금제는 연결할 수 있는 AI 에이전트 수, 저장 용량, 월간 메모리 쓰기 횟수, 보관함 항목 수만 다릅니다. 모든 요금제에 모든 기능이 있고 인원 제한이 없습니다. 가격은 미국 달러 기준이며, 연간 결제는 열 달 가격으로 열두 달을 이용합니다.

• AI 에이전트는 사람과 에이전트 이름의 조합으로 셉니다. 내 Claude와 팀원의 Claude는 두 에이전트입니다. 검색과 읽기는 무제한입니다.
• 업그레이드나 해지는 콘솔의 Billing에서 언제든 할 수 있습니다. 해지해도 결제한 기간이 끝날 때까지 요금제가 유지됩니다.
• 환불. 첫 결제 후 14일 이내에는 전액 환불됩니다. [email protected]으로 이메일을 보내 주세요. 그 이후의 결제는 환불되지 않습니다. 약관을 참고하세요.

조직, 한도, 내 데이터

• 조직. 스페이스는 주 계정 하나를 가진 조직입니다. 주 계정은 Organization에서 이메일로 사람들을 초대하고, 초대받은 사람은 사용자로 참여합니다. 모두가 지식 베이스, 메모리, 보관함을 공유합니다. 각 사용자는 자기 AI 에이전트와 토큰을 관리하고, 주 계정은 모든 사람의 에이전트와 토큰은 물론 멤버, 결제, 내보내기, 삭제까지 관리합니다. 요금제는 사람이 아니라 AI 에이전트 수를 제한합니다.
• 별도의 계정. 같은 이메일이라도 두 조직에 있으면 서로 다른 두 계정입니다. 로그인 후 들어갈 조직을 선택하고, 사이드바에서 전환할 수 있습니다.
• 한도. 요금제마다 AI 에이전트 수, 저장 용량, 월간 메모리 쓰기 횟수가 정해져 있습니다. 요금제를 참고하세요. 한도에 도달하면 쓰기는 명확한 메시지와 함께 거부되지만, 읽기는 계속 작동합니다.
• 내 GitHub. Knowledge → Sync to your GitHub에서 지식 베이스를 내 소유의 저장소에 동기화하세요. Markdown 파일만 동기화됩니다.
• 내보내기와 삭제. 주 계정은 Organization에서 모든 것을 다운로드하거나 조직을 삭제할 수 있습니다.
• 개인정보. 데이터는 캐나다의 서버에 저장됩니다. 고객 데이터로 모델을 학습시키거나 광고를 보여주지 않습니다. 자세한 내용은 개인정보 처리방침에 있습니다.

문제 해결

“The space has reached its AI agent limit”

에이전트(사람과 이름의 조합)마다 슬롯 하나를 차지합니다. 승인 페이지에서 기존 에이전트 이름 중 하나를 다시 쓰거나, 콘솔에서 더 이상 쓰지 않는 에이전트를 비활성화하거나, 업그레이드하세요.

앱에서 다시 로그인해야 한다고 나옵니다

접근 권한은 자동으로 갱신됩니다. 콘솔에서 앱 연결을 끊었거나 60일 동안 사용하지 않았다면 다시 연결하세요.

로그인 이메일이 오지 않습니다

스팸함에서 [email protected] 에서 온 메일을 확인하세요. 링크는 한 번만 쓸 수 있고 15분 후 만료됩니다. 승인 페이지와 같은 브라우저에서 여세요.

owlmem vault unlock이 복구 코드만 요구합니다

구버전입니다. npx -y owlmem@latest vault unlock을 실행하고(또는 npm install -g owlmem으로 업데이트하고) 프롬프트에서 Enter를 누르세요.

“This passkey can't unlock the vault”(이 Passkey로는 보관함을 열 수 없습니다)

해당 기기가 PRF 기능을 지원하지 않습니다. 에이전트 승인에는 계속 쓸 수 있습니다. Google 비밀번호 관리자, iCloud 키체인 또는 Windows Hello에 저장된 Passkey를 하나 더 추가하세요.

토큰 사용 시 “401 Unauthorized”

토큰이 철회되었거나 잘못 입력되었습니다. 토큰은 om_으로 시작하며 Authorization: Bearer om_… 형식으로 보냅니다.

그래도 해결되지 않나요? [email protected]으로 이메일을 보내 주세요.