MCP
AI 를 MCP 로 연결하면 지식 계층을 다루는 도구 10개를 갖게 됩니다. 이 페이지는 각 도구가 하는 일, 적용되는 한도, 그리고 전형적인 사용 흐름을 다룹니다.
연결하면 생기는 것
Contextick 이 연결되면 AI 는 도구 10개를 갖습니다. 회원님이 직접 호출할 일은 없습니다 — 평소 말로 요청하면 AI 가 알맞은 것을 고릅니다. “이거 나중을 위해 저장해 둬” 는 저장으로, “가격 페이지 어떻게 정했더라?” 는 다시 꺼내오기로 이어집니다.
모든 것은 회원님 계정 범위 안에 있습니다. 사람마다 자기 개인 저장소를 갖고, AI 는 연결돼 있는 동안에만 거기에 닿을 수 있습니다.
전형적인 흐름
- 저장합니다. “이 마이그레이션 계획 기억해 줘.” AI 가 제목, 자체 완결적인 노트, 짧은 요약으로 다듬은 다음 Save 를 호출합니다.
- 다시 꺼내옵니다. 며칠 뒤 다른 대화에서 — 어쩌면 다른 AI 에서 — “우리가 쓴 마이그레이션 계획 써 줘” 라고 합니다. AI 가 Search 를 호출해 의미가 가장 가까운 항목들을 요약으로 받아옵니다.
- 전문을 읽습니다. 그대로 인용하거나 고치려면 AI 가 그 항목의 id 로 Get 을 호출합니다. 검색 결과는 요약이라, 노트 전체를 읽는 방법은 이것뿐입니다.
- 개정본을 저장합니다. AI 가 Save 를 다시 호출하는데, 넘기는 것은 전체 갱신본입니다 — 바뀐 부분만이 아니라 변경이 반영된 노트 전체입니다.
- 정리합니다. 그 저장이 성공한 뒤에야 옛 id 에 Delete 를 호출합니다. 먼저 지우면 원본을 잃습니다.
도구 10개
Save
나중에 다시 볼 만한 것을 남깁니다 — 코드 조각, 아이디어, 설계나 결정, 보고서, 리서치 메모. AI 가 먼저 제목·자체 완결적인 노트·짧은 요약으로 다듬으며, 분량을 맞추려고 잘라내지 말고 내용을 충실히 유지하도록 안내받습니다.
입력: 제목, 노트, 요약.
반환: 새 항목의 id 와 지금까지 저장한 총량.
Search
앞서 저장한 것을 다시 가져옵니다. AI 가 주제나 질문, 키워드 몇 개를 넘기면 의미가 가장 가까운 항목들을 받습니다 — 질의와 같은 단어를 공유하는 것만이 아닙니다.
각 결과는 요약 형태로 돌아오며, 언제 저장했는지, 누가 저장했는지, 그리고 — 기록을 시작한 이후 저장된 것이라면 — 어느 AI 에서 왔는지가 함께 옵니다. 마지막 항목이 공유 계층의 핵심입니다: ChatGPT 에서 저장한 노트가 Claude 에서 출처를 유지한 채 돌아옵니다.
입력: 무엇을 꺼내올지, 그리고 선택적으로 결과 개수.
반환: id, 제목, 요약, 몇 번 열렸는지, 그리고 어떻게 저장됐는지 — 언제, 누가, 어느 AI 에서.
Get
저장된 항목 하나를 전문으로 엽니다. AI 가 노트를 그대로 인용하거나, 고치기 전에 전체를 읽을 때 씁니다. 검색 결과는 요약이므로 전문에 닿는 방법은 이것뿐입니다.
Get 은 읽기가 아니라 쓰기입니다. 항목을 열면 그 항목의 열람 횟수가 올라가고, 그래서 Least opened 와 Most opened 가 의미를 갖습니다. 이 도구가 스스로를 읽기가 아니라 쓰기로 정직하게 보고하기 때문에, 쓰기 동작 전에 확인을 요구하는 AI 클라이언트에서는 Get 도 확인 대상이 됩니다. (ChatGPT 를 비롯한 일부 클라이언트는 저장 전에도 확인합니다.) 횟수 말고는 아무것도 바뀌지 않습니다.
입력: id.
반환: 항목의 전문.
Delete
id 로 저장 항목을 삭제합니다 — 한 번에 하나 또는 여러 개. 영구적이고 되돌릴 수 없어서, 도구가 AI 에게 무엇을 지울지 회원님과 먼저 확인하도록 안내합니다. 항목을 개정본으로 교체하는 경우에는 새 것을 먼저 저장하고 그것이 성공한 뒤에만 옛 id 를 지우도록 돼 있습니다.
입력: id 하나 이상.
반환: 무엇이 지워졌는지, 무엇을 못 찾았는지, 그리고 그 뒤의 저장 총량.
Usage
“얼마나 저장했지?” 에 답합니다 — 지식 계층에 있는 항목 수와 차지하는 총 용량.
입력: 없음.
반환: 항목 수와 바이트 단위 총 용량.
Least opened
전문이 적게 열린 순서로 저장 항목을 나열합니다 — 조용히 묵혀 있던 것을 보는 방법입니다. 이건 거르는 게 아니라 정렬합니다: 다섯 개를 저장했고 다섯 개 모두 자주 열렸어도 그 다섯 개를 그대로 돌려줍니다. 각 항목에는 실제 열람 횟수가 함께 옵니다.
이 횟수는 전문 열람만 셉니다. Get 이 실행될 때만 올라갑니다 — 다른 것으로는 오르지 않습니다. AI 가 Search 요약에서 필요한 걸 찾아 거기서 답했다면 Get 을 부르지 않았으므로, 제 역할을 다했어도 항목은 0 에 머뭅니다. 횟수가 낮다고 안 쓰인 게 아닙니다. 잘 쓴 요약은 아무도 열지 않아도 항목을 쓸모 있게 만듭니다. 숫자만 보지 말고 제목과 저장 시점을 함께 놓고 읽으세요.
입력: 선택적으로 나열 개수.
반환: id, 제목, 열람 횟수, Search 로 찾을 수 있는 상태인지, 그리고 각 항목이 어떻게 저장됐는지 — 언제, 누가, 어느 AI 에서. 목록을 가볍게 유지하려고 요약은 싣지 않습니다. 요약은 Search 에 있습니다.
Most opened
같은 목록을 반대쪽에서 봅니다 — 전문을 자꾸 다시 열게 되는 항목들입니다. AI 가 인용하거나 고치려고 자세히 필요로 했던 것들이라, 실제로 기대고 있는 노트인 경향이 있습니다. 다만 역은 성립하지 않습니다. 이 목록에 없는 항목은 그저 요약만으로 충분히 쓸모 있었을 수 있습니다.
입력: 선택적으로 나열 개수.
반환: Least opened 와 같은 필드를, 열람 횟수 반대 순서로.
Changes
노트가 무엇에 대한 것인지가 아니라, 어떤 시점 이후에 저장된 것을 나열합니다 — "월요일 이후로 뭘 추가했지?". AI 가 첫 호출에 날짜와 시각을 주고, 돌려받은 커서를 따라 나머지를 이어 읽습니다.
결과는 항상 오래된 것부터이고, 다루는 것은 추가뿐입니다. 나중에 지운 항목은 나오지 않고, 준비가 끝난 항목이 다시 나오지도 않습니다. 물어보는 대신 일이 일어나는 시점에 내 시스템이 알게 하려면 웹훅이 그 이벤트를 직접 가진 엔드포인트로 보내 줍니다.
입력: 시작 시점 또는 커서, 선택적으로 나열 개수.
반환: 각 항목의 id·제목·요약, 언제 어디에서 저장됐는지, 아직 검색되는 상태인지, 그리고 이어 읽을 커서.
Get group
업로드한 파일 한 건의 조각들을 나열합니다. 대시보드에서 올린 문서는 번호가 붙은 조각들로 저장되고, 거기서 나온 항목은 모두 같은 그룹 라벨을 답니다 — 검색이 보고서의 3번 조각을 물어왔을 때, 나머지를 보여주는 경로가 이것입니다.
파일 제목은 그룹 전체에 한 번만 실리고 조각은 id 와 상태로 돌아오므로, 큰 업로드가 지금 얼마나 검색 가능해졌는지 한눈에 보입니다. 나열은 조각을 여는 것이 아니라서 열람 횟수에 영향을 주지 않습니다.
받는 것: 그룹 라벨 — 업로드에서 나온 항목이면 다른 도구들이 함께 돌려줍니다.
돌려주는 것: 파일 제목, 조각 수와 그중 검색 가능·처리 중·실패가 각각 몇 개인지, 그리고 조각마다의 id 와 상태.
Delete group
보고 있던 조각 하나가 아니라 업로드한 파일 전체를 한 번에 잊습니다. 그 그룹 라벨을 단 조각이 모두 함께 사라지므로, 77조각짜리 PDF 를 하나씩 지울 필요가 없습니다.
영구적이며 되돌릴 수 없고, 전부 아니면 전무입니다 — 도중에 끊겨도 파일은 반쯤 지워지지 않고 온전히 남습니다. 직접 저장한 노트와 다른 업로드의 조각은 라벨이 달라 그대로 있습니다.
받는 것: 그룹 라벨.
돌려주는 것: 어떤 조각이 지워졌는지, 그리고 그 뒤 저장량이 얼마인지.
Help
여기 어떤 도구도 하지 않는 세 가지 — HTTP API, 아웃바운드 웹훅, 파일 넣기 — 의 계약 전문을 AI 에게 건넨다. 그중 무엇이든 AI 에게 물으면 해당 토픽을 먼저 읽으므로, 답이 추측이 아니라 현재 계약에서 나온다.
대화 안에서 "노트가 저장되면 알림 받으려면 어떻게 해?" 라고 묻고 동작하는 답을 얻을 수 있는 이유가 이것이다 — 이 사이트로 나올 필요가 없다.
받는 것: 토픽 하나 — api,
webhooks, upload.
돌려주는 것: 그 계약 전문 — 엔드포인트, 페이로드, 서명 검증, 재시도, 에러 코드. 키와 서명 시크릿은 절대 들어 있지 않고, 어느 화면에 있는지만 알려준다.
한도
| 대상 | 한도 | 넘으면 |
|---|---|---|
| 저장 1회당 노트 본문 | 16,000자 | 거절 — AI 가 일관된 조각으로 나눠 각각 저장하므로 유실되는 것은 없습니다 |
| 제목 | 120자 | 말줄임표와 함께 잘림 |
| 요약 | 300자 | 말줄임표와 함께 잘림 |
| 검색 결과 수 | 1–10 (기본 5) | 범위 안으로 조정 |
| Least/Most opened 결과 수 | 1–20 (기본 10) | 거절 |
| Changes 결과 수 | 1–100 (기본 50) | 거절 |
| Search · Least opened · Most opened · 시점으로 시작하는 Changes — 시간당 / 하루 | 60 / 300 (Free) · 60 / 600 (Pro) | 창이 리셋될 때까지 거절되며, 오류가 얼마나 기다릴지 알려줍니다 |
| Save — 시간당 / 하루 | 60 / 300 (Free) · 200 / 1,000 (Pro) | 창이 리셋될 때까지 거절되며, 이미 저장된 것에는 영향이 없습니다 |
| Get · Usage · Delete · Get group · Delete group · 커서로 이어받는 Changes — 시간당 | 600 | 그 시간이 리셋될 때까지 거절됩니다 |
| Free 플랜 저장 공간 | 5 MB — 수백 페이지 | 공간을 비울 때까지 저장이 거절됩니다 |
제목·요약·노트 본문은 빈 값으로 둘 수 없습니다 — 비어 있으면 임의로 채우지 않고 거절합니다. Free 플랜에 무엇이 포함되는지는 요금제를 보세요.
연결 방식
들어오는 길은 둘이고, 어느 쪽을 쓸지는 회원님이 아니라 연결하는 AI 가 정합니다.
- 로그인(OAuth). 브라우저 로그인으로 연결을 승인합니다 — 복사할 API 키가 없습니다. 채팅 앱에서는 설정에서 Contextick 을 커넥터로 추가하고, Claude Code 나 Codex CLI 에서는 한 번만 로그인 명령을 실행합니다. Claude, ChatGPT, Replit, Claude Code, Codex CLI 가 이 방식입니다.
- API 키. 도구의 MCP 설정 파일에 Contextick 엔드포인트와
Authorization헤더를 넣습니다. 키는 계정 페이지에서 발급합니다. Cursor 와 Devin(옛 Windsurf)이 이 방식입니다.
어느 쪽이든 같은 계정, 같은 개인 저장소입니다 — AI 둘을 연결하면 둘이 같은 지식을 봅니다. 각각의 단계별 안내는 연결 가이드에 있습니다.
회원님의 데이터
저장하는 것은 회원님 전용 데이터베이스로 들어갑니다 — 다른 사람 노트와 섞인 공용 테이블이 아닙니다. 개별 항목이나 데이터베이스 전체는 언제든 계정 페이지에서 지울 수 있고, AI 연결을 끊으면 접근이 즉시 차단됩니다. 자세한 내용은 개인정보 처리방침에 있습니다.
더 보기
이미 갖고 있는 파일을 그대로 넣으려면 문서 업로드를 보세요. 직접 만든 스크립트에서 저장하려면 REST API 를 보세요. 자주 나오는 질문은 FAQ 에 정리돼 있습니다. 플랜과 한도는 요금제에 있습니다. 불분명하거나 잘 안 되는 것이 있으면 문의해 주세요 — 사람이 모든 메일을 읽습니다.