Notes — AI가 기록하는 노트

Notes를 위한 일일 불릿 노트입니다 — Claude Code 플러그인으로, 다른 모든 클라이언트를 위한 독립형 Agent Skill로, 그리고 MCP URL을 읽을 수 있는 모든 것을 위한 일반 MCP URL로 제공됩니다.

당신의 AI는 스스로 판단해 당신의 노트에 메모를 남깁니다. 오늘의 페이지에, 당신이 작성하는 모든 것과 동일한 엔티티 그래프로 태그를 달고, 누구의 불릿인지 항상 구분할 수 있도록 표시합니다. 몇 주 후 프로젝트 페이지를 열면 당신의 메모와 AI의 메모가 날짜 순서로 한 페이지에 있습니다. 그리고 다음 세션이 이를 다시 읽어 주므로 다시 설명할 필요가 없습니다.

이것은 메모리 데이터베이스가 아닙니다. 벡터 인덱스도, 축출 정책도, 훅도, 직접 가져오는 Postgres도 없습니다. 메모리는 이미 읽고 있는 노트 속의 불릿 하나이며, 손으로 수정할 수 있고, 그 메모리를 만들어 낸 대화로 연결되는 링크가 있습니다.

설치

Claude Code

/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skill

Cursor, VS Code, Codex, Gemini CLI, Antigravity, Amp, OpenCode, Warp…

여기서 스킬과 연결은 분리되어 있습니다. 이 클라이언트들은 개방형 Agent Skills 형식을 읽고 자체 MCP 서버 URL을 사용하기 때문입니다.

gh skill install jpwilliams/notes-skill

이 설치는 이들이 공유하는 벤더 중립 경로인 .agents/skills/에 설치됩니다. 따라서 어떤 것을 사용하든 명령 하나면 됩니다. (GitHub CLI를 사용하지 않으려면 npx skills add jpwilliams/notes-skill도 같은 작업을 합니다.) 그런 다음 MCP 서버를 추가하세요:

https://notes.jpwilliams.dev/api/v1/mcp

그 밖의 모든 것

원격 MCP를 지원하는 모든 클라이언트는 패키지도 설치도 없이 해당 URL을 직접 사용할 수 있습니다. 나머지는 클라이언트가 스스로 발견합니다. notes.jpwilliams.dev/install에 클라이언트별 지침이 있습니다.

어떤 경로를 택했든 다음에 일어나는 일

브라우저가 열립니다. 이미 있는 계정으로 로그인하고, 연결이 할 수 있는 일을 읽은 다음 이름을 지정하세요. 그 이름은 연결이 쓰는 모든 불릿에 나타나므로, 하루의 메모 중간에 읽고 싶은 이름으로 정하세요. "업무용 노트북"이 "Claude"보다 낫습니다.

이것이 설정의 전부입니다. 발급할 키도, 붙여넣을 키도, 키체인도, claude mcp add도, URL도 없습니다. notes.jpwilliams.dev의 🔑 기기 액세스 페이지에서 언제든 연결을 끊을 수 있으며, 그러면 즉시 작동이 중지됩니다.

Related MCP server: GoLogX (logx-mcp)

데스크톱 앱과 웹사이트에서

플러그인 없이 동일한 연결입니다. https://notes.jpwilliams.dev/api/v1/mcp URL로 Notes를 사용자 지정 커넥터로 추가하세요. 앱이 나머지를 발견하고, 승인 및 이름 지정을 위해 같은 화면으로 안내합니다. 플러그인은 터미널에서 갖출 가치가 있습니다. 노트북을 사용해야 할 때를 Claude에게 가르치는 스킬을 담고 있기 때문입니다. 커넥터 단독으로는 도구와 동일한 지침의 짧은 버전을 제공하며, 이는 서버 자체가 보냅니다.

할 수 있는 일

네 가지 도구와, 에이전트가 언제 그것들을 사용해야 하는지를 가르치는 스킬.

의도적으로 할 수 없는 일

• 추가만 가능합니다. 어떤 것도 편집하거나 삭제할 수 없습니다 — 당신의 텍스트도, 다른 에이전트의 것도, 자신의 것도. 수정은 새 불릿을 추가하는 것이며, 노트에서도 원래 그렇게 합니다.

• 기존 엔티티만 가능합니다. 존재하지 않는 엔티티를 가리키는 #tag는 조용히 무시되지 않고 호출 전체가 거부됩니다. 이름 변경과 병합은 아직 없으므로, 오타는 실제로 읽는 인덱스에 영구적으로 잘못된 선반이 됩니다. 프로젝트의 엔티티는 직접 한 번 생성합니다.

• 코퍼스 검색 없음. 모든 읽기는 상한이 아니라 형태에 의해 제한됩니다. 그래서 한 달치 메모든 10년치 메모든 프로젝트를 읽는 비용은 동일합니다.

읽는 것

당신의 전체 노트 — 모든 날, 모든 엔티티, 모든 할 일, 회의록에서 추출한 메모까지 포함합니다. 이것이 동의 화면에서 승인하는 내용이며, 화면에도 그렇게 명시되어 있습니다.

추가와 읽기만 허용됩니다. 이는 모델이 준수할 수도 있고 아닐 수도 있는 도구 설명의 한 줄이 아니라, 데이터가 읽히는 시점에 서버에서 강제됩니다.

볼 수 있는 것

에이전트가 작성하는 모든 불릿은 일별 보기에 표시되고 해당 연결에 부여한 이름으로 표시됩니다. 커서를 올리면 자격 증명, 작성 시각, 에이전트가 자신에 대해 말한 내용(공급업체, 모델, 출처 대화)을 볼 수 있습니다. 마지막 항목들은 자체 보고 사항이며 그렇게 표시됩니다. 이름과 타임스탬프는 우리 쪽 정보이므로, 애플리케이션이 스스로 이름을 붙이는 대신 사용자가 이름을 지정하는 이유가 바로 그것입니다.

표시는 출처를 기록하며 절대 지워지지 않습니다. 에이전트의 불릿을 손으로 편집해도 그것이 당신의 것이 되지는 않습니다. 정리하는 것은 일반적인 경우이며, 처음 만지면 사라지는 표시라면 일주일 안에 대부분의 불릿에서 사라졌을 것입니다. 불릿을 삭제하는 것이 바로 수정 행위입니다.

그것들 없이 하루를 읽고 싶다면, 🔑 기기 액세스에 스위치가 있습니다. 숨김 실행은 원래 있던 자리에 개수를 남겨 두므로, 하루가 조용히 아무것도 작성되지 않은 척하지 않습니다. 같은 페이지에 모든 연결이 나열되며, 하나를 즉시 끊을 수 있습니다. 그 연결이 이미 작성한 메모는 정확히 그 자리에 남아, 사용자가 지정한 이름으로 계속 표시됩니다.

요구 사항

Notes 계정. 앱은 notes.jpwilliams.dev에 있습니다.

라이선스

MIT.