마당 사용 설명

처음이라면 초록 1 → 2 → 3만 순서대로 따라 하세요. 10분이면 첫 프로젝트가 보드에 올라옵니다. 나머지는 필요할 때 읽으면 됩니다.

1마당이 뭐예요?

AI한테 일을 시키다 보면 이런 생각이 듭니다. “그 프로젝트 어디까지 했더라?” “다음에 뭐 하기로 했지?”

마당은 프로젝트마다 카드 한 장으로 그걸 보여 줍니다. 카드에는 지금 하는 일, 다음 할 일, 막힌 일이 적혀 있어요.

카드는 내가 쓰지 않습니다. 일하던 AI한테 “에사 정리”라고 한마디 하면 AI가 대신 적어 줍니다.

AI와 일하기“에사 정리” 한마디마당에 카드가 생김

2처음 한 번만: 준비하기

AI 도구와 에사를 연결하는 단계입니다. AI 도구 하나에 한 번만 하면 됩니다.

2-1에사에서 열쇠(API 키) 받기

에사에 들어가서 이메일로 로그인합니다.

위쪽 메뉴에서 API 키를 누릅니다.

새 키 발급에 칸이 세 개 있어요. 처음이면 전부 비워도 됩니다. 비워도 연결되고 카드도 똑같이 생겨요.

칸 이름	뭘 적나요?	예시	비우면
이 키의 용도	나만 알아보는 메모	내 맥북 Claude	'(이름 없음)'. 열쇠가 여러 개면 헷갈려요
기본 화자	이 AI의 영어 별명 (영어 소문자·숫자·- 2~24자)	claude-mac	누가 썼는지가 전부 'ai'로 보여요
툴 이름	쓰는 AI 도구. 아래 버튼을 누르면 돼요	Claude	도구가 알려 주는 이름이 자동으로 들어가요

도움말AI를 여러 개 쓰거나 컴퓨터가 여러 대라면 화자와 툴 이름을 넣으세요. 마당 정리본에 “Claude · claude-mac”, “Codex · codex-1”처럼 누가 한 일인지 나뉘어 보입니다.

발급을 누르면 asr_로 시작하는 긴 글자가 나옵니다. 이게 열쇠예요.

주의열쇠는 이때 딱 한 번만 보입니다. 새로고침하면 사라져요. 바로 2-2로 가서 붙여 넣으세요. 잃어버려도 괜찮습니다. 새로 받으면 기억은 그대로 이어져요.

도움말새 키 발급이 회색으로 막혀 있으면 아직 초대받지 않은 계정입니다. 운영자에게 초대를 부탁하세요.

2-2AI 도구에 열쇠 꽂기

열쇠가 나온 화면 바로 아래에 내 도구에 붙여 넣을 글이 이미 채워져 있습니다. 복사를 눌러 아래 자리에 붙여 넣으면 끝이에요. 내 도구를 눌러 보세요.

Claude Code (터미널, Claude 앱의 코드 탭)

터미널에 복사한 한 줄을 붙여 넣고 엔터. 모양은 이렇습니다.

claude mcp add --transport http asr-claude-mac https://asrmemory.com/mcp --header "Authorization: Bearer 내_열쇠"

claude mcp list를 쳤을 때 asr-claude-mac이 보이면 성공.

Claude 데스크톱 앱 (채팅)

설정 파일 ~/Library/Application Support/Claude/claude_desktop_config.json을 열고, 복사한 글을 mcpServers 안에 붙여 넣습니다.

Claude 앱을 완전히 껐다가 다시 켭니다.

Cursor · Antigravity · Trae

도구의 MCP 설정 파일에 복사한 글을 붙여 넣고 도구를 다시 켭니다. Cursor는 ~/.cursor/mcp.json, Antigravity는 ~/.gemini/antigravity/mcp_config.json입니다.

Codex

설정 → 맞춤형 MCP에 연결을 엽니다.

유형 스트리밍 가능한 HTTP, URL https://asrmemory.com/mcp

헤더 키 Authorization, 값 Bearer 내_열쇠

주의열쇠는 비밀번호와 같아요. 채팅창·문서·단톡방에 붙여 넣지 마세요.

2-3잘 연결됐는지 확인

AI 도구에서 새 대화를 열고 이렇게 말해 보세요.

AI에게기억 떠올려줘

AI가 에사에서 기억을 읽었다고 답하면 준비 끝!

3첫 프로젝트 올리기

이제 쉬워요. 프로젝트 폴더에서 AI랑 평소처럼 일하다가, 일이 한 단락 끝나면 한마디만 하면 됩니다.

3-1AI에게 한마디

처음 한 번은 영어 이름표를 같이 알려 주세요. 이름표 정하는 법은 4번에 있어요.

AI에게에사 정리해줘. 프로젝트는 my-shop

AI가 오늘 한 일, 다음 할 일, 막힌 일을 정리해서 올립니다. 처음이면 프로젝트 소개·주소도 알아서 채워요.

3-2마당에서 확인

마당에 에사와 같은 이메일로 로그인합니다.

보드에 my-shop 카드가 생겼으면 성공!

카드 오른쪽 위 ⋯ → 이름 바꾸기로 알아보기 쉬운 이름(예: 내 쇼핑몰)으로 바꿉니다. 이름을 바꿔도 기록은 그대로예요.

3-3다음부터 이름표를 안 알려 줘도 되게 하기 (추천)

프로젝트 폴더의 AI 규칙 파일에 한 줄만 적어 두세요. Claude는 CLAUDE.md, Codex는 AGENTS.md, Cursor는 .cursorrules입니다. 파일이 없으면 새로 만들면 돼요.

에사에 기록하거나 에사 정리할 때 프로젝트는 my-shop

그러면 이 폴더에서 일하는 AI는 모두 같은 이름표를 씁니다. 카드가 두 장으로 갈라지는 실수가 사라져요.

도움말두 번째 프로젝트도 똑같아요. 그 프로젝트 폴더에서 “에사 정리해줘. 프로젝트는 ○○” 하면 카드가 하나 더 생깁니다.

4영어 이름표(프로젝트 ID) 정하기

프로젝트 ID는 AI가 기록마다 붙이는 영어 이름표입니다. 이름표가 같은 기록끼리 한 카드에 모여요. 카드에 보이는 한글 이름과는 따로입니다.

규칙	좋은 예	나쁜 예
영어 소문자·숫자·- 만	my-shop	My Shop, 내쇼핑몰
짧고 알아보기 쉽게	weddingtalk	project-final-v2
앱과 웹을 따로 보고 싶으면 나누기	weddingtalk-web	(앱·웹 둘 다 weddingtalk)

주의한 번 정하면 바꾸지 마세요. 바꾸면 옛 기록은 옛 이름표에, 새 기록은 새 이름표에 쌓여서 카드가 두 장이 됩니다. 꼭 바꿔야 하면 운영자에게 “○○를 △△로 옮겨 주세요”라고 부탁하세요. 기록을 한꺼번에 옮겨 드려요.

도움말내 프로젝트 ID는 카드를 눌러 들어간 프로젝트 페이지 제목 아래 ID my-shop에 있어요.

5매일 쓰는 법

1마당 보드를 엽니다.
2빨간 배지(멈춤)나 노란 줄(막힘·정할 것)이 있는 카드부터 봅니다.
3‘정할 것’이 있으면 카드를 눌러 읽고, 그 AI한테 답해 줍니다.
4AI랑 일이 한 단락 끝날 때마다 “에사 정리”. 자주 할수록 카드가 정확해져요.

6화면 읽는 법

보이는 것	뜻
오늘 · 어제 (초록)	최근에 일한 프로젝트
3일째 조용 (노랑)	3~4일 동안 기록이 없어요
멈춤 5일 (빨강)	5일 넘게 기록이 없어요. 잊은 건 아닌지 확인
진행 중 · 다음	AI가 마지막 정리 때 적은 지금 일과 다음 일
막힘 · 정할 것 (노랑)	AI 혼자 못 하는 일. 사람이 봐 줘야 해요
코멘트 (파랑)	AI가 나한테 하고 싶은 말
이후 기록 N건	마지막 정리 뒤에 쌓인 기록. 5건 넘으면 '에사 정리' 할 때
위쪽 멈춤·막힘·정할 것 버튼	누르면 그 카드에 파란 테두리가 켜져요
그룹별 ▾ · 2칸 · 3칸	카드 순서와 한 줄에 놓을 카드 수

카드를 누르면 프로젝트 페이지가 열려요. 정리본이 최신부터 쌓여 있고, 옆에 주소·기술 스택이 있습니다.

7프로젝트가 많아지면

서너 개가 넘으면 그때 정돈하세요. 처음부터 할 필요 없어요. 모두 보드에서 바로 하고, 누르는 즉시 저장됩니다. 실수하면 아래에 뜨는 되돌리기를 누르세요.

하고 싶은 것	이렇게 해요
이미 있는 프로젝트에 AI 작업 넣기	카드 ⋯ → AI에게 할 말 복사 → AI 대화창에 붙여 넣기. 카드를 눌러 들어가면 규칙 파일 한 줄도 복사할 수 있어요
이름 바꾸기	카드 ⋯ → 이름 바꾸기
묶어서 보기 (앱, 사업 …)	카드 ⋯ → 그룹에 넣기 → 새 그룹 이름 적기. 다음 카드부터는 목록에서 고르기
그룹 이름·순서 바꾸기	그룹 제목 옆 ⋯
안 쓰는 프로젝트 치우기	카드 ⋯ → 숨기기. 보드 맨 아래 '숨긴 프로젝트'에서 언제든 되살려요
카드 미리 만들어 두기	보드 위쪽 + 새 프로젝트 → 한글 이름과 영어 이름표 적기

8미지정 기록 치우기

에사를 예전부터 썼다면 이름표 없이 저장된 옛 기록이 있을 수 있어요. 왼쪽 메뉴 미지정 기록 옆 숫자가 그 개수입니다. 안 치워도 마당은 잘 돌아가요.

1제안별로 보기에서 프로젝트 하나를 고릅니다.
2마당이 맞을 것 같은 기록에 미리 체크해 둬요. 아니면 체크를 풉니다.
3선택한 N건 넣기. 실수했으면 10초 안에 되돌리기.
4필요 없는 기록은 N건 휴지통으로. 에사 보관함에서 되살릴 수 있어요.

9막혔을 때

'에사 정리'라고 했는데 AI가 못 알아들어요

AI 도구가 옛날 설정을 기억하고 있을 때 그래요. 새 대화를 열거나 AI 도구를 껐다 켜 보세요. 그래도 안 되면 2-3의 “기억 떠올려줘”로 연결부터 확인하세요.

보드에 카드가 하나도 없어요

아직 에사 정리를 한 번도 안 한 거예요. 3번 “첫 프로젝트 올리기”를 따라 하세요. 에사와 마당에 같은 이메일로 로그인했는지도 확인하세요.

같은 프로젝트가 카드 두 장으로 보여요

AI가 다른 이름표로 정리해서 그래요(예: my-shop 과 myshop). 안 쓰는 카드는 ⋯ → 숨기기, 그리고 3-3처럼 규칙 파일에 이름표를 적어 두세요. 쌓인 기록을 합치고 싶으면 운영자에게 부탁하세요.

프로젝트 ID와 에사 API 키는 같은 건가요?

달라요. API 키는 AI 도구를 에사에 연결하는 열쇠이고, 키를 받을 때 적는 영어 이름은 그 AI의 별명(화자)이에요. 프로젝트 ID는 기록마다 붙는 프로젝트 이름표예요. 열쇠 하나로 여러 프로젝트 일을 해도 됩니다.

카드에 '소개가 아직 없습니다'라고 나와요

그 프로젝트 소개를 아직 안 채웠다는 뜻이에요. AI에게 “에사 정리하고 정보도 채워줘”라고 한 번 말하거나, 프로젝트 페이지의 정보 고치기로 직접 적으세요.

최신 내용이 안 보여요

마당은 빨리 뜨려고 받아 둔 내용을 2분 동안 씁니다. 새로고침하면 새로 받아 와요.