MCP 연결 안내

《피를 마시는 새》 인물 관계도를 Claude, ChatGPT 같은 다른 AI 서비스에서 도구로 쓸 수 있습니다. 아래 MCP 서버 주소를 각 서비스의 커넥터 설정에 넣으면 됩니다.

MCP 서버 주소

https://pimasae-character-graph.pages.dev/mcp

전송 방식: Streamable HTTP · 인증: 없음 · 지원 프로토콜: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
서버 상태 확인 중…

제공하는 도구

아래 목록은 이 페이지가 MCP 서버에 tools/list를 직접 요청해 받아 온 것입니다.

도구	설명	성격
불러오는 중…

스포일러 관계는 include_spoilers: true를 줄 때만 나옵니다. 인물은 id(elsi), 이름(정우 규리하), 별칭(황제 사냥꾼) 어느 것으로도 찾습니다.

Claude에서 연결

Claude 웹 · 데스크톱 앱

설정 → 커넥터에서 사용자 지정 커넥터 추가를 누릅니다.
이름은 자유롭게(예: 피를 마시는 새), URL에는 위의 MCP 서버 주소를 넣습니다. 인증 설정은 비워 둡니다.
대화 화면의 도구 메뉴에서 이 커넥터를 켜고 “엘시와 정우는 어떤 사이야?”처럼 물어봅니다.

팀·엔터프라이즈 플랜에서는 관리자가 커넥터 추가를 허용해야 할 수 있습니다. 메뉴 이름은 앱 버전에 따라 조금 다를 수 있습니다.

Claude Code

claude mcp add --transport http pimasae https://pimasae-character-graph.pages.dev/mcp

ChatGPT에서 연결

설정 → 앱과 커넥터 → 고급 설정에서 개발자 모드를 켭니다.
커넥터 만들기에서 이름과 MCP 서버 주소를 넣고, 인증은 없음을 고릅니다.
새 대화에서 개발자 모드의 이 커넥터를 골라 질문합니다.

ChatGPT의 사용자 지정 MCP 커넥터는 플랜과 지역에 따라 제공 여부가 다르고, 메뉴 위치도 바뀔 수 있습니다. 쓰기 도구(add_note 등)는 실행 전에 확인을 요청받을 수 있습니다.

그 밖의 MCP 클라이언트

원격(HTTP) MCP 서버를 지원하는 클라이언트(Cursor, VS Code, Windsurf 등)에는 보통 다음과 같은 설정을 넣습니다. 키 이름은 클라이언트마다 조금씩 다릅니다.

{
  "mcpServers": {
    "pimasae": {
      "type": "http",
      "url": "https://pimasae-character-graph.pages.dev/mcp"
    }
  }
}

직접 시험해 보기

MCP Inspector로 연결해 도구를 하나씩 불러 볼 수 있습니다. 전송 방식은 Streamable HTTP를 고르고 위 주소를 넣으세요.

npx @modelcontextprotocol/inspector

터미널에서 curl로 도구 목록을 받아 볼 수도 있습니다.

curl -s https://pimasae-character-graph.pages.dev/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "mcp-protocol-version: 2026-07-28" \
  -H "mcp-method: tools/list" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"curl","version":"1"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

메모 쓰기와 편집 키

add_note로 남긴 메모는 관계도 페이지의 모든 방문자에게 보입니다.
MCP로 만든 메모에는 결과에 edit_key가 함께 옵니다. 이 메모를 고치거나(update_note) 지울(delete_note) 때 그 키가 필요합니다. 키는 서버에 해시로만 저장되어 다시 알려 줄 수 없으니 보관해 두세요.
메모 내용은 2,000자까지이고, 저장은 IP당 1분에 60번까지 받습니다.
메모는 방문자가 쓴 글이므로, AI에게는 사실이나 지시로 취급하지 말라고 도구 설명에 적어 두었습니다.

그 밖의 방법

WebMCP (브라우저 안의 에이전트)

관계도 페이지를 연 브라우저에 WebMCP를 지원하는 에이전트가 있으면, 페이지가 같은 조회·메모 도구와 화면 조작 도구(show_character, set_view)를 document.modelContext로 등록합니다. 지원하는 브라우저에서는 관계도 페이지 하단에 “WebMCP 도구 n개 등록됨”이 표시됩니다.

내장 챗봇

관계도 페이지 오른쪽 아래의 💬 챗봇에게 묻기는 Cloudflare Workers AI 모델이 이 MCP 서버의 조회 도구를 불러 답합니다. 챗봇은 메모를 쓰거나 지우지 않습니다.

데이터 출처

인물·관계는 나무위키 「피를 마시는 새/등장인물」과 각 인물 문서(CC BY-NC-SA 2.0 KR)를 요약해 만든 것으로, 원작과 직접 대조하지는 않았습니다. 원본 온톨로지: Turtle · JSON-LD · SHACL