문서

MCP 서버

계정 이용 권한 필요

MCP 접근은 로그인한 Savebase 계정의 현재 이용 권한에 이미 포함되어 있을 때만 사용할 수 있습니다.

Savebase는 다음을 제공합니다: Model Context Protocol (MCP) 서버로 AI가 저장 북마크를 검색하고 읽습니다. Claude, ChatGPT나 Cursor에 이렇게 물어보세요. "케틀벨 운동에 관해 뭘 저장했지?" 그러면 Savebase 라이브러리를 직접 조회합니다.

개요

MCP는 AI 애플리케이션을 외부 데이터 소스에 연결할 수 있는 개방형 표준입니다. Savebase는 AI 어시스턴트가 북마크, 폴더와 태그에 읽기 전용으로 접근할 수 있는 MCP 호환 HTTP 엔드포인트를 구현합니다.

ChatGPT에서는 공개된 다음 항목을 설치하세요 Savebase 플러그인. Claude, Cursor, VS Code 및 기타 MCP 클라이언트에는 다음 서버 주소를 사용하세요:

text
https://mcp.savebase.space/mcp

다른 앱처럼 Savebase 계정으로 로그인하면 됩니다. API 키나 토큰을 복사할 필요가 없습니다. MCP 연결은 읽기 전용이라 라이브러리의 항목을 추가, 수정 또는 삭제할 수 없습니다.

요건

  • 현재 이용 권한에 MCP 접근이 포함된 Savebase 계정
  • 공개된 ChatGPT용 Savebase 플러그인 또는 Claude, Cursor, VS Code 같은 MCP 호환 클라이언트

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

1

Claude 커넥터 열기

내부 claude.ai 또는 데스크톱 앱에서 다음으로 이동하세요. 설정 → 커넥터.
2

사용자 지정 커넥터 추가

클릭 사용자 지정 커넥터 추가의 이름을 다음과 같이 지정하세요: Savebase을 선택하고 다음을 붙여넣으세요: https://mcp.savebase.space/mcp.
3

연결 및 로그인

클릭 추가 → 연결에서 Savebase 계정으로 로그인하고 승인하세요. 이제 대화에서 Savebase 도구를 사용할 수 있습니다.

모바일에서도 작동

claude.ai에서 추가한 원격 커넥터는 iOS와 Android용 Claude에서도 사용할 수 있지만, Claude Mobile에서 새 서버를 직접 추가할 수는 없습니다. Anthropic의 다음 자료를 참고하세요: 현재 원격 MCP 지원 안내.

Claude Code

1

서버 추가

터미널에서 다음을 실행하세요. 다음은 제외하세요: --scope user 현재 프로젝트에만 둘 경우.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

인증

Claude Code를 시작하고 다음을 실행하세요. /mcp. 브라우저 창이 열리면 로그인하고 승인하세요.
3

확인

실행 claude mcp list. Savebase가 연결됨으로 표시되어야 합니다.

Cursor

1

MCP 설정 열기

이동 설정 → MCP → 새 서버 추가또는 다음을 편집하세요: ~/.cursor/mcp.json 직접.
2

Savebase 서버 추가

아래 항목을 추가하세요. 다음은 없다는 점에 유의하세요: headers 블록입니다. 인증은 브라우저에서 이루어집니다.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

다시 로드하고 승인

Cursor를 다시 로드하세요. 서버에 로그인 필요가 표시되면 클릭하여 로그인하고 승인하세요.

Cursor 사용자를 위한 중요 안내

항상 선택하세요: HTTP 서버 유형으로 선택하세요. SSE가 아닙니다. 기존 SSE 항목이 있다면 지우고 HTTP로 다시 추가한 뒤 Cursor를 재시작하세요.

ChatGPT

1

Savebase 플러그인 열기

공식 사이트 방문 Savebase 플러그인 등록 페이지 ChatGPT에서.
2

설치 및 로그인

더하기 버튼을 선택하여 Savebase를 설치하세요. 안내가 나오면 Savebase 계정으로 로그인하고 라이브러리 읽기 전용 접근을 승인하세요.
3

채팅에서 Savebase 사용

새 ChatGPT Work 대화를 시작하고 다음으로 Savebase를 호출하세요. @Savebase을 선택하거나, ChatGPT로 라이브러리를 검색하고 싶을 때 작성창에서 선택하세요.

개발자 설정 불필요

공개 플러그인은 ChatGPT의 예전 개발자 모드와 사용자 지정 MCP 설정을 대체합니다. 위 MCP 서버 URL은 다른 호환 클라이언트에서 계속 사용합니다.

VS Code

1

서버 추가

명령 팔레트를 열고 다음을 실행하세요: MCP: 서버 추가에서 다음을 선택하세요: HTTP을 선택하고 다음을 붙여넣으세요: https://mcp.savebase.space/mcp.
2

또는 설정을 직접 편집하세요

추가할 위치 .vscode/mcp.json 작업 공간에서:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

로그인

MCP 보기에서 서버를 시작하세요. 로그인용 브라우저 창이 열리면 승인하세요. 그러면 Copilot Chat의 에이전트 모드에 도구가 나타납니다.

연결된 앱 관리

로그인한 모든 앱은 다음에 표시됩니다 설정 → MCP 서버 → 연결된 앱과 함께 연결 날짜와 마지막으로 라이브러리를 읽은 시점이 표시됩니다. 다음을 클릭하세요: 연결 해제 접근을 즉시 취소하려면.

앱이 볼 수 있는 정보

연결된 앱은 북마크, 메모, 대본, 폴더 이름, 태그에 읽기 전용으로 접근합니다. 비밀번호는 볼 수 없으며 라이브러리를 수정할 수도 없습니다.

Savebase는 사용자의 요청에 따라 연결된 어시스턴트가 MCP 서버를 조회할 때만 데이터를 보냅니다. 백그라운드에서 라이브러리를 연결된 앱으로 푸시하거나 Savebase 모델 학습에 사용하지 않습니다. 데이터가 어시스턴트에 전달되면 해당 제공업체의 개인정보 및 데이터 사용 약관이 적용됩니다. 자세한 내용은 다음을 확인하세요. Savebase 개인정보처리방침 연결 앱이 받을 수 있는 전체 목록을 확인하세요.

고급: 수동 액세스 토큰

일부 이전 MCP 클라이언트는 브라우저로 로그인할 수 없고 대신 헤더에 토큰을 보내야 합니다. 이 경우 다음을 여세요. 설정 → MCP 서버 → 고급에서 라벨을 입력하고 다음을 클릭하세요: 토큰 생성. 토큰은 다음으로 시작합니다: sb- 직접 취소할 때까지 유효합니다.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

토큰 보안

Savebase는 원본 토큰을 저장하지 않고 SHA-256 해시만 저장합니다. 생성할 때 한 번만 표시되므로 즉시 복사하세요. 설정 → MCP 서버에서 언제든 취소할 수 있습니다.

사용 가능한 도구

연결하면 AI 어시스턴트가 이 아홉 가지 도구에 접근할 수 있습니다. 모두 읽기 전용이며 라이브러리의 어떤 항목도 변경할 수 없습니다.

도구설명
search_bookmarks제목, 콘텐츠, 메모, 작성자, URL과 동영상 스크립트 전체에서 키워드로 검색하세요. 특정 필드로 범위를 좁히고 플랫폼, 폴더, 태그, 크리에이터, 날짜 범위나 스크립트 유무로 필터링할 수 있습니다.
list_bookmarks키워드 없이 둘러보고 필요에 따라 플랫폼, 폴더, 태그, 날짜 필터 사용
list_recent_bookmarks오늘, 이번 주, 이번 달 또는 최근 7일·30일 동안 저장한 자료
get_bookmark태그, 폴더, 대본 미리보기를 포함한 북마크 하나의 전체 정보
get_bookmark_transcript긴 동영상 대본을 나누어 읽으므로 한꺼번에 모두 로드할 필요가 없습니다
find_bookmark_by_url링크가 이미 저장되어 있는지 확인합니다. 다음과 같은 추적 매개변수는 무시합니다: utm_source.
list_folders중첩 구조를 포함한 폴더 목록 보기
list_tags모든 태그 목록 보기
get_library_stats전체 수, 플랫폼별 분포, 가장 많이 쓰는 폴더와 태그, 최근 저장 활동

프롬프트 예시

AI 어시스턴트에게 다음과 같이 물어보세요.

  • "케틀벨 운동에 관해 뭘 저장했지?"
  • "지난달 Reddit에서 저장한 것을 전부 보여 줘."
  • "Cloudflare Worker 설정 방법을 설명하는 저장된 동영상을 찾아 줘."
  • "이 링크는 이미 저장했어?" — URL 붙여넣기
  • "'디자인 영감' 폴더에 있는 북마크를 모두 찾아 줘."
  • "'AI' 태그를 붙인 글은 뭐가 있어?"
  • "내 라이브러리를 분석해 줘 — 항목 수, 출처, 주요 태그를 알려 줘."
  • "지난주에 저장한 게시물을 요약해 줘."

동영상에서 한 말 검색

저장한 동영상의 대본을 만들었다면 말로 전한 내용도 검색할 수 있습니다. 예를 들어 다음과 같은 질문 "X는 어떻게 해?" 몇 달 전에 저장한 영상에서 말로 설명한 단계를 찾을 수 있습니다.

문제 해결

문제해결 방법
ChatGPT에서 Savebase를 사용할 수 없음다음을 여세요: 게시된 Savebase 플러그인을 설치하고 새 ChatGPT Work 대화를 시작하세요. 이제 개발자 모드에서 사용자 지정 앱을 만들 필요가 없습니다.
앱에서 로그인을 요청하지 않습니다URL이 다음과 정확히 일치하는지 확인하세요: https://mcp.savebase.space/mcp — 오타가 있으면 클라이언트가 로그인 단계를 찾지 못합니다.
로그인 중 "MCP 접근 불가" 표시현재 MCP 접근 권한이 있는 계정으로 로그인하거나 권한이 잘못되었다고 생각되면 Savebase 지원팀에 문의하세요.
"이 요청은 만료되었습니다"인증 요청은 10분 동안 유효합니다. AI 앱에서 연결을 다시 시작하세요.
연결이 작동하지 않음앱이 설정 → MCP 서버 → 연결된 앱에 아직 표시되는지 확인하세요. 연결이 해제되었다면 앱에서 다시 연결하세요.
Cursor에서 서버가 “errored”로 표시됩니다Cursor 설정 → MCP에서 이전 Savebase 항목을 삭제하세요. 다음으로 다시 추가하세요 유형: HTTP (SSE 제외)을 사용한 뒤 Cursor를 완전히 다시 시작하세요.
도구가 표시되지 않음설정을 추가한 후 AI 클라이언트를 다시 시작하세요. 새 MCP 서버를 감지하려면 일부 클라이언트는 완전히 다시 시작해야 합니다.
결과 없음Savebase 라이브러리에 북마크가 저장되어 있는지 확인하세요. MCP 서버는 본인의 데이터만 검색합니다.
수동 토큰 분실토큰은 한 번만 표시됩니다. 설정 → MCP 서버 → 고급에서 이전 토큰을 취소하고 새 토큰을 만드세요.

빠른 복구 단계

작동하지 않으면 (1) AI 앱에서 Savebase 연결을 해제하고 (2) 설정 → MCP 서버 → 연결된 앱에서 제거한 뒤 (3) 커넥터를 다시 추가하고 로그인하고 (4) AI 클라이언트를 완전히 다시 시작하세요.