MCP 서버 · Streamable HTTP

줄거리 MCP

Claude Code, Claude Desktop, Cursor 같은 AI 도구가 완다 시리즈 관계도를 직접 검색하고, 노드에 붙은 포스트잇 메모를 읽고 쓰게 해 주는 서버입니다. 아래 주소를 AI 도구에 등록하면 됩니다. 브라우저 안의 AI 에이전트를 위한 WebMCP 방식도 지원합니다.

서버 주소

https://wanda-notes-api.htkwak-hello.workers.dev/mcp
방식
Streamable HTTP (JSON-RPC 2.0), 세션 없음
읽기 도구
열쇠 없이 사용
쓰기 도구
Authorization: Bearer <편집 열쇠>

‘연결 확인’을 누르면 이 브라우저에서 서버에 접속해 도구 목록을 가져옵니다.

AI가 할 수 있는 일

도구 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 Code

읽기만 쓸 때

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를 입력하면 연결 상태와 도구 목록을 볼 수 있습니다.

Claude Desktop

설정 파일(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

~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 넣습니다.

{
  "mcpServers": {
    "wanda-notes": {
      "url": "https://wanda-notes-api.htkwak-hello.workers.dev/mcp",
      "headers": { "Authorization": "Bearer 여기에 편집 열쇠" }
    }
  }
}

읽기만 쓰려면 headers 줄을 빼세요.

VS Code (GitHub Copilot)

프로젝트의 .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 에이전트

WebMCP는 웹페이지가 자기 기능을 도구로 만들어 브라우저의 AI 에이전트에게 직접 내놓는 표준안입니다. W3C Web Machine Learning 커뮤니티 그룹의 초안(2026-10-20)이라 아직 표준 트랙은 아니고, 브라우저에서도 기본으로 꺼져 있습니다. 사양 보기

이 사이트의 줄거리 관계도 페이지가 WebMCP 도구를 내놓습니다. 위의 서버 방식과는 따로 쓸 수 있고, 둘 다 같은 메모 저장소(D1)를 씁니다.

원격 MCP (위의 서버)WebMCP (관계도 페이지)
도구가 있는 곳Cloudflare Worker 서버열려 있는 /viewer 페이지
페이지를 열어 둬야 하나아니요예. 페이지를 닫으면 도구도 사라집니다.
편집 열쇠Authorization 헤더로 보냄그 브라우저에 한 번 입력해 둔 열쇠를 페이지가 사용
화면과의 연동없음노드 선택과 작품 필터가 사람이 보는 화면에 바로 나타남
쓸 수 있는 곳MCP를 지원하는 AI 도구 어디서나WebMCP를 켠 브라우저와 그 안의 에이전트

페이지가 내놓는 도구 9개

도구종류하는 일
search_graph읽기이름으로 노드를 찾아 id를 돌려줍니다.
get_node읽기노드의 속성, 관계, 붙은 메모를 보여 줍니다. 메모 글은 ‘믿을 수 없는 내용’으로 표시됩니다.
show_node화면화면에서 그 노드를 가운데로 옮기고 패널에 보여 줍니다.
filter_work화면한 작품만 보거나 전체로 되돌립니다.
list_notes읽기메모 목록과 휴지통을 봅니다.
add_note쓰기노드에 메모를 붙입니다.
update_note쓰기메모의 글이나 색을 고칩니다.
delete_note쓰기메모를 휴지통으로 옮깁니다.
restore_note쓰기휴지통의 메모를 되살립니다.

써 보는 방법

에이전트가 메모를 쓰거나 지우면 화면 아래에 “AI 에이전트가 메모를 붙였습니다” 같은 알림이 뜨고, 지운 메모는 휴지통에서 되살릴 수 있습니다. 쓰기 도구에는 ‘결과가 남는 동작’ 표시(consequentialHint)를 달아 두었습니다.

이 브라우저가 WebMCP를 지원하는지 확인합니다.

연결한 뒤 이렇게 말해 보세요

“비전퀘스트의 토머스 셰퍼드가 누구와 이어져 있는지 알려 줘.”search_graph → get_node
“완다비전, 아가사 올 얼롱, 비전퀘스트를 연결하는 인물을 정리해 줘.”graph_overview → get_node 여러 번
“지금 붙어 있는 메모를 전부 요약해 줘.”list_notes
“틴 노드에 ‘6화에서 정체 공개’라고 메모를 붙여 줘.”search_graph → add_note (열쇠 필요)
“방금 쓴 메모를 지웠다가 되살려 줘.”delete_note → restore_note (열쇠 필요)

편집 열쇠 다루기

열쇠는 쓰기 도구에만 필요합니다. 읽기 도구는 열쇠 없이 누구나 쓸 수 있고, 사이트 관계도에 보이는 메모도 같은 내용입니다.

열쇠는 AI 도구의 설정이나 환경 변수에만 두세요. 채팅창, 공개 저장소, 스크린샷에 붙이지 마세요.

열쇠가 새어 나갔다면 Cloudflare 대시보드에서 Worker wanda-notes-api의 ADMIN_KEY 값을 새 값으로 바꾸면, 이전 열쇠는 바로 쓸 수 없게 됩니다.

잘 안 될 때