← 디아블로 인물 관계 그래프

MCP 연결 안내

Claude, Cursor, VS Code 같은 AI 도구가 디아블로 인물 관계 온톨로지를 조회하고 그래프 메모를 관리하도록 연결하는 방법입니다.

MCP 엔드포인트

전송 방식: Streamable HTTP (원격 서버, 설치 필요 없음) · 인증: 읽기 도구는 없음, 메모 쓰기 도구는 Authorization: Bearer <편집 비밀번호>

제공 도구

도구하는 일권한
get_diablo_ontology클래스 계층·관계 유형·규칙(R1~R4)·시대·인물 id 목록공개
get_diablo_character인물 한 명의 설명·시대·모든 관계·추론 결과 (id/한글/영문 이름)공개
find_diablo_relations인물·상대·관계 유형·시대로 관계 검색공개
list_notes그래프에 붙은 메모 목록, 휴지통 보기공개
add_note메모 추가. node_id(인물 id 또는 이름)를 주면 그 노드에 붙음편집
update_note메모 글·색·위치·붙은 노드 수정편집
delete_note휴지통으로 이동, permanent면 휴지통에서 영구 삭제편집
restore_note휴지통 메모 복원편집

AI가 추가한 메모는 그래프에 포스트잇으로 바로 보입니다.

도구별 연결 방법

편집 도구까지 쓰려면 아래 예시의 <편집 비밀번호>를 실제 비밀번호로 바꾸세요. 읽기만 할 거라면 헤더 부분을 빼면 됩니다.

읽기 전용

claude mcp add --transport http diablo {EP}

편집 포함

claude mcp add --transport http diablo {EP} --header "Authorization: Bearer <편집 비밀번호>"

추가 후 Claude Code에서 /mcp로 연결 상태를 확인할 수 있습니다. 모든 프로젝트에서 쓰려면 --scope user를 붙이세요.

설정의 개발자 메뉴에서 claude_desktop_config.json을 열고 아래를 추가한 뒤 앱을 다시 시작합니다. Node.js가 필요합니다.

{
  "mcpServers": {
    "diablo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "{EP}", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer <편집 비밀번호>" }
    }
  }
}

읽기 전용이면 "--header", "Authorization:${AUTH_HEADER}"와 env를 빼세요.

claude.ai 또는 Claude 앱의 설정 → 커넥터에서 커스텀 커넥터 추가를 누르고 이름과 URL을 넣습니다.

{EP}

커스텀 커넥터는 임의의 헤더를 넣을 수 없어서 읽기 도구만 동작합니다. 사용 가능 여부는 요금제와 조직 설정에 따라 다릅니다.

~/.cursor/mcp.json(전역) 또는 프로젝트의 .cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "diablo": {
      "url": "{EP}",
      "headers": { "Authorization": "Bearer <편집 비밀번호>" }
    }
  }
}

프로젝트의 .vscode/mcp.json에 추가합니다. 비밀번호는 처음 연결할 때 입력 창으로 물어봅니다.

{
  "inputs": [
    { "type": "promptString", "id": "diablo-token", "description": "편집 비밀번호", "password": true }
  ],
  "servers": {
    "diablo": {
      "type": "http",
      "url": "{EP}",
      "headers": { "Authorization": "Bearer ${input:diablo-token}" }
    }
  }
}

stdio만 지원하는 클라이언트

npx -y mcp-remote {EP} --header "Authorization: Bearer <편집 비밀번호>"

MCP Inspector로 확인

npx @modelcontextprotocol/inspector

Transport를 Streamable HTTP로, URL을 엔드포인트로 넣고 Connect를 누르면 도구 목록을 볼 수 있습니다.

curl로 직접 확인

curl -s -X POST {EP} \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

WebMCP (브라우저 안에서 연결)

그래프 페이지는 WebMCP 표준 초안의 document.modelContext에 도구 8개를 등록합니다. 서버 설정 없이, 그 페이지를 연 브라우저의 AI 에이전트가 사용자가 보고 있는 그래프를 직접 조작합니다. 브라우저 기본 지원이 없으면 페이지에 포함된 폴리필(@mcp-b/global)이 같은 API를 제공합니다.

도구하는 일권한
diablo_search · diablo_get_character인물 검색·상세읽기
diablo_focus · diablo_filter화면 이동, 보기·시대·관계 유형 필터 변경화면 조작
diablo_list_notes메모 목록읽기
diablo_add_note · diablo_update_note · diablo_delete_note메모 추가·수정·휴지통 이동화면에서 편집 잠금 해제한 동안

연결 방법

  1. Chrome 웹 스토어에서 MCP-B 확장 프로그램을 설치합니다.
  2. 그래프 페이지를 열거나 새로고침합니다.
  3. 오른쪽 패널 "AI 연결 → ② WebMCP"에 ✔ … 도구 8/8개 등록됨이 보이면 준비 완료입니다.
  4. 확장 패널을 열면 이 페이지의 도구가 나타나고, 확장에 연결된 AI(Claude 등)에게 그래프 조작을 요청할 수 있습니다.
  1. WebMCP를 지원하는 Chrome에서 주소창에 chrome://flags를 입력합니다.
  2. "WebMCP"를 검색해 Enabled로 바꾸고 브라우저를 다시 시작합니다.
  3. 그래프 페이지를 열면 상태에 브라우저 기본 WebMCP로 표시됩니다. 브라우저에 내장된 에이전트가 도구를 사용할 수 있습니다.

플래그 이름과 지원 버전은 Chrome 버전에 따라 달라질 수 있습니다.

그래프 페이지의 "도구 테스트"에서 도구를 골라 실행하거나, 개발자 도구 콘솔에서 직접 호출합니다.

const t = (await document.modelContext.getTools()).find(x => x.name === 'diablo_search');
await document.modelContext.executeTool(t, { query: '티리엘' });

WebMCP는 아직 표준화 중인 실험 기능이라 브라우저·확장 버전에 따라 동작이 다를 수 있습니다. 안정적인 연결은 위 원격 MCP를 쓰세요.

연결 후 이렇게 물어보세요

참고