AI 도구 연결 (MCP)

서버 주소

Claude, Codex, Cursor 같은 AI 도구가 이 지식 그래프를 직접 조회하고 편집할 수 있도록 원격 MCP 서버를 열어 두었습니다. 전송 방식은 Streamable HTTP이고, 로그인은 필요 없습니다.

서버 상태 확인 중…

연결 방법

메뉴 이름과 설정 파일 위치는 도구 버전에 따라 조금 다를 수 있습니다. 서버 이름(spider-man)은 마음대로 바꿔도 됩니다.

설치 없이 써 보기: 그래프 페이지 챗봇

그래프 페이지 오른쪽 아래의 그래프에 물어보기를 누르면, 이 MCP 서버에 연결된 챗봇과 바로 대화할 수 있습니다. 챗봇 서버(/api/chat)가 MCP 클라이언트로서 tools/list로 도구를 받아 AI 모델에게 주고, 모델이 고른 도구를 tools/call로 실행합니다. AI 앱에서 연결했을 때와 같은 도구, 같은 규칙 검사를 거칩니다.

• 모델: Cloudflare Workers AI의 무료 오픈 모델(qwen3-30b-a3b). API 키가 필요 없고, 하루 무료 사용량을 다 쓰면 다음 날(한국 시간 오전 9시)까지 멈춥니다.
• 조회와 편집을 모두 할 수 있습니다. 편집은 저장 전에 규칙 검사를 거치고, 저장되면 열린 화면에 바로 반영됩니다.
• 오른쪽 패널에 열어 둔 노드를 “이 노드”, “지금 보고 있는 인물”처럼 가리킬 수 있습니다.
• 작은 무료 모델이라 가끔 도구 결과를 잘못 옮기거나 ID를 그대로 보여 줄 수 있습니다. 정확한 답이 필요하면 Claude 같은 AI 앱으로 연결하세요.

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

그래프 페이지는 WebMCP로도 도구를 내놓습니다. WebMCP는 웹 페이지가 document.modelContext.registerTool()로 브라우저 안의 AI 에이전트에게 도구를 등록하는 방식입니다. 위의 원격 MCP 서버는 AI 앱이 주소로 접속하는 방식이고, WebMCP는 사용자가 열어 둔 그래프 페이지에서 에이전트가 바로 일하는 방식입니다. 두 가지는 함께 동작합니다.

화면 도구는 WebMCP에만 있습니다.

• get_current_view: 사용자가 지금 보고 있는 노드·관계와 필터 상태. “이 인물의 관계를 정리해 줘”의 ‘이 인물’을 알아낼 때 씁니다.
• focus_node: 노드를 선택하고 확대해 오른쪽 패널에 엽니다.
• set_filters: 작품·클래스·추론 관계 필터를 바꿉니다.

그래프 도구는 이 페이지가 /mcp 서버의 같은 도구로 실행합니다. 그래서 온톨로지 규칙 검사, 휴지통, 변경 기록이 그대로 적용됩니다. 결과에는 누구나 편집한 이름과 메모가 섞일 수 있어 모든 그래프 도구에 untrustedContentHint를, 삭제·되돌리기 도구에 consequentialHint를 붙였습니다.

Chrome에서 시험하기

1. Chrome 주소창에 chrome://flags/#enable-webmcp-testing를 열어 Enabled로 바꾸고 다시 시작합니다.
2. Chrome 웹 스토어에서 WebMCP - Model Context Tool Inspector 확장을 설치합니다.
3. 그래프 페이지를 열면 헤더에 “WebMCP 도구 N개”가 표시됩니다. 확장의 사이드 패널에서 도구 목록을 보고 직접 실행하거나 자연어로 시켜 볼 수 있습니다.

WebMCP는 W3C Web Machine Learning 커뮤니티 그룹의 초안(2026년 10월 20일 판)이며 아직 정식 표준이 아닙니다. 지원 브라우저와 필요한 Chrome 버전, 확장 이름은 바뀔 수 있습니다. 이 페이지는 document.modelContext를 먼저 쓰고, 옛 Chrome 빌드의 navigator.modelContext도 지원합니다. WebMCP가 없는 브라우저에서는 아무 일도 일어나지 않습니다.

제공하는 도구

이렇게 물어보세요

• “피터 파커와 미스테리오는 그래프에서 어떻게 이어져 있어?” → find_path
• “브랜드 뉴 데이에 나오는 사건들을 시간 순서대로 정리해 줘.” → list_nodes, get_node
• “네드 리즈의 관계를 추론 관계까지 포함해서 보여 줘.” → get_node(includeInferred)
• “MJ 노드에 ‘다음 편에서 기억을 되찾을까?’라는 메모를 붙여 줘.” → add_memo
• “해피 호건과 메이 파커 사이에 연인 관계를 추가해도 규칙에 맞는지 먼저 검사해 줘.” → add_relation(dryRun)
• “방금 AI가 만든 변경을 되돌려 줘.” → list_changes, revert_change

편집과 안전장치

편집 권한 확인 중…

• 편집 도구로 보낸 변경은 저장하기 전에 서버가 온톨로지 규칙(정의역·치역, 카디널리티, 비반사·순환, 시간 순서, 등장 일치)을 모두 검사합니다. 위반하면 저장하지 않고 위반 목록을 AI에게 돌려줍니다.
• 편집 도구에 dryRun: true를 주면 저장하지 않고 검사만 합니다.
• 삭제한 항목은 휴지통으로 가고(restore로 복원), 모든 변경은 변경 기록에 남습니다(revert_change로 되돌리기). AI가 만든 변경은 요약 앞에 [AI]가 붙어 그래프 화면의 변경 기록에서도 구분됩니다.