세션이 끝나도,
작업은 남도록.

내 계정으로, 내 기기에 연결하기

모든 사용자는 각자 스케치북 계정과 연결 키를 사용합니다. 직접 진행하거나 각 단계의 프롬프트를 에이전트에게 전달할 수 있습니다.

1. 1

   환경을 준비하세요

   직접 진행하기

   Node.js 24 이상을 설치하고 사용할 앱을 준비하세요. 자동 설치는 macOS용이며 Codex, Claude Code, 설치된 Claude Desktop을 함께 등록합니다.

   Node.js 다운로드 ↗

   에이전트에게 맡기기

   프롬프트 복사

   이 Mac에 abbsbook MCP를 설치할 준비를 해주세요. OS, node --version, node -p "process.execPath"를 확인하고 Node.js 24 이상인지 점검하세요. 사용할 Codex·Claude Code·Claude Desktop과 해당 설정 파일의 위치를 확인하세요. 아직 MCP 설정은 바꾸지 말고 준비 상태와 필요한 조치를 알려주세요. 인증 파일 내용이나 기존 설정의 비밀값은 출력하지 마세요.

2. 2

   로그인하고 내 연결 키를 만드세요

   직접 진행하기

   스케치북에 로그인하고 가입·온보딩을 마칩니다. 약관이 표시되면 직접 내용을 확인하고 동의하세요. 설정 → 개인정보 → Claude · Codex 연결에서 “내 MacBook”처럼 이름을 정하고 키를 만든 뒤 abbsbook-credentials.json을 다운로드 폴더에 저장합니다.

   로그인하고 연결 키 만들기 ↗

   인증 파일은 발급 직후 받을 수 있습니다. 잃어버리면 기존 연결을 해지하고 새 키를 만드세요. 채팅에는 파일 내용이나 키를 붙여넣지 말고 경로만 알려주세요.

   에이전트에게 맡기기

   프롬프트 복사

   abbsbook MCP의 계정 인증 준비를 안내해주세요. https://abigbigsketchbook.com/settings/privacy#settings-integrations 에서 제가 직접 로그인·필수 약관 동의·연결 키 발급을 하도록 안내하고 기다려주세요. 제가 완료했다고 알려준 후, 지정한 abbsbook-credentials.json의 존재와 형식만 로컬에서 확인하세요. 로그인, 약관 동의, 키 발급을 대신 수행하지 말고 토큰 값이나 파일 내용을 채팅·로그에 출력하지 마세요.

3. 3

   설치 파일을 받고 등록하세요

   직접 진행하기

   macOS 터미널에서 아래 명령을 실행합니다. 인증 파일의 이름이나 위치가 다르면 마지막 줄의 경로를 바꾸세요.

   명령 복사

   mkdir -p "$HOME/Downloads/abbsbook-mcp" &&
   cd "$HOME/Downloads/abbsbook-mcp" &&
   curl --fail --location --output abbsbook-mcp.zip https://abigbigsketchbook.com/downloads/abbsbook-mcp.zip &&
   unzip -o abbsbook-mcp.zip &&
   shasum -a 256 -c SHA256SUMS.txt &&
   node install.mjs ./abbsbook.mjs "$HOME/Downloads/abbsbook-credentials.json"

   설치 파일 직접 받기 (.zip) ↓

   기존 앱 설정은 백업한 뒤 abbsbook 항목을 추가합니다. 설치가 끝나면 다운로드 폴더의 인증 파일 사본은 지워도 됩니다. 앱을 다시 열거나 새 CLI 세션을 시작하세요.

   에이전트에게 맡기기

   프롬프트 복사

   이 Mac에 abbsbook MCP를 설치해주세요. Node.js 24 이상과 제가 발급해 다운로드한 인증 파일의 경로를 확인하세요. https://abigbigsketchbook.com/downloads/abbsbook-mcp.zip 을 전용 임시 폴더로 다운로드하고 압축을 푸세요. shasum -a 256 -c SHA256SUMS.txt 검증에 성공한 경우에만 node install.mjs ./abbsbook.mjs "인증 파일의 절대 경로"를 실행하세요. 기존 앱 설정과 백업을 보존하고 인증 파일 내용을 출력하지 마세요. 등록한 앱, 설정 경로, 재시작 방법을 알려주세요. 이 연결은 stdio 방식이므로 원격 URL 등록이나 OAuth 로그인을 시도하지 마세요.

[mcp_servers.abbsbook]
command = "/absolute/path/to/node"
args = ["/absolute/path/abbsbook.mjs", "codex", "/absolute/path/abbsbook-credentials.json"]
startup_timeout_sec = 20
tool_timeout_sec = 180

{
  "mcpServers": {
    "abbsbook": {
      "command": "/absolute/path/to/node",
      "args": [
        "/absolute/path/abbsbook.mjs",
        "claude",
        "/absolute/path/abbsbook-credentials.json"
      ]
    }
  }
}

사용하는 앱에서 확인하세요

설치 뒤 앱을 다시 열거나 새 세션을 시작합니다. 도구 목록과 내 스케치북 목록까지 확인해야 연결 검증이 완료됩니다.

codex mcp get abbsbook

abbsbook MCP의 연결을 검증해주세요. 먼저 MCP 도구 목록에 list_sketchbooks, create_sketchbook, get_sketchbook, save_session이 보이는지 확인하고 list_sketchbooks를 실제 호출하세요. 제 스케치북 이름과 쓰기 가능 여부를 알려주세요. 아직 이벤트나 스케치북은 생성하지 마세요. 빈 목록이 정상 반환되면 인증은 성공한 것입니다. 도구가 없거나 인증에 실패하면 성공했다고 하지 말고 오류 코드와 해결할 단계를 알려주세요.

이렇게 첫 기록을 남겨 보세요

요약은 지금 대화 중인 에이전트가 작성합니다. abbsbook은 전달받은 제목·본문·날짜와 첨부를 이벤트로 저장합니다.

에이전트 대화에서 저장할 스케치북과 프로젝트·세션을 지정하고 요약을 요청하세요. 필요한 파일의 절대 경로와 링크를 함께 전달한 뒤 저장 결과 링크를 웹에서 확인합니다.

이번 프로젝트에서 이 세션 동안 작업한 내용을 요약해서 abbsbook에 저장해주세요.

1. list_sketchbooks로 내 스케치북을 확인하세요. 저장할 곳을 아직 지정하지 않았다면 먼저 물어봐 주세요.
2. 프로젝트 이름과 현재 세션 ID를 사용하세요. 세션 ID를 알 수 없다면 재사용할 고유 ID를 정하고 알려주세요.
3. 완료한 작업, 결정한 사항, 다음 할 일을 제목과 본문에 정리하세요.
4. 내가 지정한 스크린샷·파일·관련 링크를 첨부해 save_session으로 저장하세요.
5. complete와 failures를 확인하고 이벤트 ID와 스케치북 링크를 알려주세요. 첨부가 실패했다면 실패 내용을 포함하고 같은 프로젝트·세션 ID로 재시도하세요.

사람마다 계정을, 기기마다 연결을

연결이 막혔을 때

abbsbook MCP 연결 실패를 진단해주세요. 실제 오류 코드, Node.js 버전, 앱 설정의 command·args 경로, 인증 파일 존재 여부를 확인하세요. 토큰이나 인증 파일 내용을 출력하지 마세요. 약관 동의나 키 재발급은 제가 직접 할 수 있도록 안내하세요. 문제를 고친 후 list_sketchbooks를 실제 호출해 검증하고, 성공 응답을 받기 전에는 완료라고 하지 마세요.

현재 지원 방식과 최신 MCP 표준

현재 배포본은 MCP 2025-11-25 호환 SDK를 사용합니다. 최신 2026-07-28 표준에서도 stdio와 Streamable HTTP는 구분됩니다. HTTP 인증은 OAuth 2.1 기반이며, 보호된 리소스 메타데이터·PKCE·대상 리소스 검증을 다룹니다. 새 클라이언트 등록은 CIMD를 권장하고 DCR은 이전 구현과의 호환용으로 남깁니다.

원격 서버용 OAuth 명령을 현재 로컬 설치에 섞지 않습니다. 지원 방식이 바뀌면 실제 연결 절차도 함께 갱신합니다.