Claude Code, Claude Desktop, Cursor 같은 AI 도구가 완다 시리즈 관계도를 직접 검색하고, 노드에 붙은 포스트잇 메모를 읽고 쓰게 해 주는 서버입니다. 아래 주소를 AI 도구에 등록하면 됩니다. 브라우저 안의 AI 에이전트를 위한 WebMCP 방식도 지원합니다.
Authorization: Bearer <편집 열쇠>‘연결 확인’을 누르면 이 브라우저에서 서버에 접속해 도구 목록을 가져옵니다.
도구 13개입니다. 읽기 도구는 데이터를 바꾸지 않습니다. 쓰기 도구도 지우는 것은 휴지통으로 옮길 뿐이라 되살릴 수 있고, 관계 변경은 기본 데이터를 지우지 않고 revert_edit로 되돌립니다. 사이트의 줄거리 챗봇은 같은 도구로 메모와 관계를 열쇠 없이 고칠 수 있습니다(하루 쓰기 20회 제한).
| 도구 | 종류 | 하는 일 |
|---|---|---|
graph_overview | 읽기 | 작품 수, 노드 종류별 개수, 시작하기 좋은 노드를 보여 줍니다. |
search_graph | 읽기 | 한국어·영어 이름으로 노드(작품, 캐릭터, 배우, 사건, 회차)를 찾아 id를 돌려줍니다. |
get_node | 읽기 | 노드 하나의 줄거리와 속성, 연결된 모든 관계, 붙어 있는 메모를 보여 줍니다. |
list_notes | 읽기 | 메모 목록. 노드별로 거르거나 휴지통을 볼 수 있습니다. |
note_history | 읽기 | 메모의 만들기·고치기·삭제·복원 이력과 그때의 글을 보여 줍니다. |
add_note | 쓰기 | 노드에 새 메모를 붙입니다. 500자까지, 색은 노랑·분홍·파랑·초록. |
update_note | 쓰기 | 메모의 글이나 색을 고칩니다. 이전 글은 이력에 남습니다. |
delete_note | 쓰기 | 메모를 휴지통으로 옮깁니다. 영구 삭제가 아닙니다. |
restore_note | 쓰기 | 휴지통의 메모를 원래 노드에 되살립니다. |
add_relation | 쓰기 | 두 노드 사이에 관계를 추가합니다(예: 틴 환생 빌리). 관계 종류와 노드 종류를 검사합니다. |
remove_relation | 쓰기 | 관계를 지웁니다. 기본 데이터는 남아 있어 되돌릴 수 있습니다. |
list_edits | 읽기 | 바뀐 관계 목록과 변경 id를 보여 줍니다. |
revert_edit | 쓰기 | 변경 id로 관계 변경 하나를 되돌립니다. |
쓰기 도구까지 쓰려면 편집 열쇠를 헤더로 보내야 합니다. 읽기만 쓸 거라면 열쇠 부분을 빼고 등록하세요. 아래 설정은 각 도구가 공개한 설정 형식을 따른 것이고, 화면과 명령은 도구 버전에 따라 조금 다를 수 있습니다.
읽기만 쓸 때
claude mcp add --transport http wanda-notes https://wanda-notes-api.htkwak-hello.workers.dev/mcp
쓰기까지 쓸 때 (열쇠를 환경 변수로 두고 등록)
export WANDA_NOTES_KEY="여기에 편집 열쇠" claude mcp add --transport http wanda-notes https://wanda-notes-api.htkwak-hello.workers.dev/mcp \ --header "Authorization: Bearer $WANDA_NOTES_KEY"
등록한 뒤 Claude Code 안에서 /mcp를 입력하면 연결 상태와 도구 목록을 볼 수 있습니다.
설정 파일(Settings → Developer → Edit Config)의 claude_desktop_config.json에 아래를 넣습니다. 원격 서버를 이어 주는 mcp-remote를 쓰므로 Node.js가 설치되어 있어야 합니다.
{
"mcpServers": {
"wanda-notes": {
"command": "npx",
"args": [
"mcp-remote",
"https://wanda-notes-api.htkwak-hello.workers.dev/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": { "AUTH_HEADER": "Bearer 여기에 편집 열쇠" }
}
}
}읽기만 쓰려면 --header와 env 줄을 빼세요. 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 실행합니다.
~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 넣습니다.
{
"mcpServers": {
"wanda-notes": {
"url": "https://wanda-notes-api.htkwak-hello.workers.dev/mcp",
"headers": { "Authorization": "Bearer 여기에 편집 열쇠" }
}
}
}읽기만 쓰려면 headers 줄을 빼세요.
프로젝트의 .vscode/mcp.json에 넣습니다. 열쇠는 입력 창으로 받아 파일에 남지 않게 했습니다.
{
"inputs": [
{ "type": "promptString", "id": "wanda-key", "description": "편집 열쇠", "password": true }
],
"servers": {
"wanda-notes": {
"type": "http",
"url": "https://wanda-notes-api.htkwak-hello.workers.dev/mcp",
"headers": { "Authorization": "Bearer ${input:wanda-key}" }
}
}
}원격 MCP 서버(Streamable HTTP)를 받는 도구라면 위 주소를 그대로 등록하면 됩니다. 사용자 지정 헤더를 지원하지 않는 화면(예: 주소만 입력하는 커넥터 추가 창)에서는 열쇠를 보낼 수 없어서 읽기 도구만 쓸 수 있습니다.
도구 목록 가져오기
curl -s https://wanda-notes-api.htkwak-hello.workers.dev/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'노드 검색해 보기
curl -s https://wanda-notes-api.htkwak-hello.workers.dev/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_graph","arguments":{"query":"완다"}}}'WebMCP는 웹페이지가 자기 기능을 도구로 만들어 브라우저의 AI 에이전트에게 직접 내놓는 표준안입니다. W3C Web Machine Learning 커뮤니티 그룹의 초안(2026-10-20)이라 아직 표준 트랙은 아니고, 브라우저에서도 기본으로 꺼져 있습니다. 사양 보기
이 사이트의 줄거리 관계도 페이지가 WebMCP 도구를 내놓습니다. 위의 서버 방식과는 따로 쓸 수 있고, 둘 다 같은 메모 저장소(D1)를 씁니다.
| 원격 MCP (위의 서버) | WebMCP (관계도 페이지) | |
|---|---|---|
| 도구가 있는 곳 | Cloudflare Worker 서버 | 열려 있는 /viewer 페이지 |
| 페이지를 열어 둬야 하나 | 아니요 | 예. 페이지를 닫으면 도구도 사라집니다. |
| 편집 열쇠 | Authorization 헤더로 보냄 | 그 브라우저에 한 번 입력해 둔 열쇠를 페이지가 사용 |
| 화면과의 연동 | 없음 | 노드 선택과 작품 필터가 사람이 보는 화면에 바로 나타남 |
| 쓸 수 있는 곳 | MCP를 지원하는 AI 도구 어디서나 | WebMCP를 켠 브라우저와 그 안의 에이전트 |
| 도구 | 종류 | 하는 일 |
|---|---|---|
search_graph | 읽기 | 이름으로 노드를 찾아 id를 돌려줍니다. |
get_node | 읽기 | 노드의 속성, 관계, 붙은 메모를 보여 줍니다. 메모 글은 ‘믿을 수 없는 내용’으로 표시됩니다. |
show_node | 화면 | 화면에서 그 노드를 가운데로 옮기고 패널에 보여 줍니다. |
filter_work | 화면 | 한 작품만 보거나 전체로 되돌립니다. |
list_notes | 읽기 | 메모 목록과 휴지통을 봅니다. |
add_note | 쓰기 | 노드에 메모를 붙입니다. |
update_note | 쓰기 | 메모의 글이나 색을 고칩니다. |
delete_note | 쓰기 | 메모를 휴지통으로 옮깁니다. |
restore_note | 쓰기 | 휴지통의 메모를 되살립니다. |
chrome://flags/#enable-webmcp-testing을 ‘Enabled’로 바꾸고 다시 시작합니다. Chrome 149 이상이면 Origin Trial로도 쓸 수 있습니다. 자세한 내용은 Chrome 문서를 보세요.에이전트가 메모를 쓰거나 지우면 화면 아래에 “AI 에이전트가 메모를 붙였습니다” 같은 알림이 뜨고, 지운 메모는 휴지통에서 되살릴 수 있습니다. 쓰기 도구에는 ‘결과가 남는 동작’ 표시(consequentialHint)를 달아 두었습니다.
열쇠는 쓰기 도구에만 필요합니다. 읽기 도구는 열쇠 없이 누구나 쓸 수 있고, 사이트 관계도에 보이는 메모도 같은 내용입니다.
열쇠는 AI 도구의 설정이나 환경 변수에만 두세요. 채팅창, 공개 저장소, 스크린샷에 붙이지 마세요.
열쇠가 새어 나갔다면 Cloudflare 대시보드에서 Worker wanda-notes-api의 ADMIN_KEY 값을 새 값으로 바꾸면, 이전 열쇠는 바로 쓸 수 없게 됩니다.
Authorization: Bearer 열쇠 형식인지, 열쇠 앞뒤에 공백이나 따옴표가 섞이지 않았는지 확인하세요.list_notes에 deleted: true를 주어야 보입니다.