시작하기

빠른 시작

키 발급 → 첫 검색 → 첫 메모리 추가까지 5분.


워크스페이스 API 키 하나로 검색과 수집을 모두 시작할 수 있습니다.

1. API 키 발급

Memory.Inc 앱에서 워크스페이스를 열고 설정 → API 로 이동해 키를 발급하세요. 키는 pwk_ 로 시작하며, 발급 직후 한 번만 전체 값이 보입니다 — 안전한 곳에 저장하세요.

API 키는 서버 측 비밀입니다. 브라우저·모바일 앱·공개 저장소에 절대 넣지 마세요.

2. 첫 검색

POST /v1/search 로 워크스페이스에 질문하면 합성된 답변과 인용을 받습니다.

curl -X POST 'https://api.memory.inc/v1/search' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{ "query": "지난주 결제 모듈 관련 결정", "limit": 5 }'
{
  "ok": true,
  "data": {
    "answer": "결제 모듈은 v2 로 마이그레이션하기로 …",
    "citations": [
      {
        "id": "…",
        "source_item_id": "…",
        "title": "주간 결정 메모",
        "snippet": "- 결제 모듈 v2 로 이전",
        "url": "https://app.memory.inc/…",
        "author": "권도균",
        "published_at": "2026-06-09T…Z"
      }
    ]
  }
}

LLM 합성을 건너뛰고 인용(passages)만 받고 싶으면 "include_answer": false 를 넣으세요 — 토큰을 약 80% 절약합니다.

3. 첫 메모리 추가

POST /v1/memories 로 워크스페이스에 메모리를 넣습니다.

curl -X POST 'https://api.memory.inc/v1/memories' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "text": "# 결정\n- 결제 모듈 v2 로 마이그레이션",
    "title": "주간 결정 메모",
    "external_id": "decision-2026-06-09"
  }'

external_id 를 주면 같은 값으로 다시 호출할 때 새 버전으로 덮어쓰기(업서트) 됩니다. 색인은 비동기로 진행되고, 임베딩이 끝나면 검색에 잡힙니다.

다음 단계

  • 인증 — 키 종류·스코프·레이트리밋·응답 형식
  • 검색 · 메모리 추가 전체 레퍼런스
  • AI 도구 대화를 자동 색인하려면 CLI
  • 에이전트에 메모리를 도구로 붙이려면 MCP