AI 도구 연결 (MCP)

Claude, Cursor, VS Code 같은 AI 도구가 이 체르노빌 지식 그래프를 직접 검색하고, 키가 있으면 편집까지 할 수 있도록 MCP 서버를 열어 두었습니다.

확인 중… https://chernobyl-graph.pages.dev/mcp

전송 방식: Streamable HTTP · 인증 없이 연결하면 읽기 전용, 편집 키를 Bearer 토큰으로 보내면 편집 도구까지 열립니다.

직접 연결하지 않고 바로 써 보려면 오른쪽 아래 💬 AI에게 묻기를 누르세요. 이 챗봇도 같은 MCP 서버의 읽기 도구로 답합니다.

제공하는 도구

도구	하는 일	권한
`graph_overview`	클래스별 개수, 전체 노드 ID 목록, 쓰이는 관계 종류	누구나
`search_nodes`	한글·영문 이름이나 설명으로 노드 검색	누구나
`get_node`	노드 설명, 나가는·들어오는 관계, 붙은 메모	누구나
`list_relations`	관계 종류나 노드로 관계(트리플) 걸러 보기	누구나
`find_path`	두 노드를 잇는 가장 짧은 관계 경로	누구나
`export_turtle`	그래프 전체를 RDF Turtle로 내보내기	누구나
`add_node` · `update_node`	노드 추가·수정	편집 키
`add_relation`	두 노드 사이 관계 추가	편집 키
`add_memo`	노드에 포스트잇 메모 붙이기	편집 키
`delete_item` · `restore_item`	휴지통으로 보내기·복원 (되돌릴 수 있음)	편집 키

AI가 바꾼 내용도 편집 화면의 이력에 mcp로 기록되어, 언제든 되돌릴 수 있습니다.

연결하기

쓰는 도구를 고르세요. 아래 예시는 읽기 전용 연결입니다. 편집까지 하려면 그 아래 편집 권한으로 연결을 보세요.

터미널에서 한 줄이면 됩니다.

claude mcp add --transport http chernobyl-graph {{URL}}

그다음 Claude Code에서 /mcp로 연결 상태를 확인하고, "체르노빌 그래프에서 레가소프와 연결된 사건을 알려줘"처럼 물어보면 됩니다.

Claude 데스크톱 앱이나 claude.ai에서 설정 → 커넥터(Connectors)로 갑니다.
사용자 지정 커넥터 추가(Add custom connector)를 누릅니다.
이름은 체르노빌 그래프, URL에는 아래 주소를 넣고 추가합니다.

{{URL}}

이 방식은 헤더를 넣을 수 없어 읽기 전용으로만 연결됩니다. 사용자 지정 커넥터는 요금제에 따라 제공 여부가 다를 수 있습니다.

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

{
  "mcpServers": {
    "chernobyl-graph": {
      "url": "{{URL}}"
    }
  }
}

프로젝트의 .vscode/mcp.json에 추가하고, Copilot 채팅을 에이전트 모드로 바꿔 사용합니다.

{
  "servers": {
    "chernobyl-graph": {
      "type": "http",
      "url": "{{URL}}"
    }
  }
}

원격(HTTP) MCP를 지원하는 도구라면 주소만 넣으면 됩니다. 로컬(stdio) 서버만 지원하는 도구는 mcp-remote로 이어 줍니다.

{
  "mcpServers": {
    "chernobyl-graph": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "{{URL}}"]
    }
  }
}

연결 시험해 보기

MCP Inspector로 도구 목록을 직접 확인할 수 있습니다.

npx @modelcontextprotocol/inspector

열린 화면에서 Transport를 Streamable HTTP로, URL을 위 주소로 두고 Connect를 누르세요.

편집 권한으로 연결

AI가 노드·관계·메모를 추가하거나 지우게 하려면, 관리자 비밀 키를 Authorization: Bearer 헤더로 보내도록 설정합니다. <비밀 키> 자리에 키를 넣으세요.

Claude Code

claude mcp add --transport http chernobyl-graph-edit {{URL}} --header "Authorization: Bearer <비밀 키>"

Cursor · VS Code 등 설정 파일

"chernobyl-graph-edit": {
  "url": "{{URL}}",
  "headers": { "Authorization": "Bearer <비밀 키>" }
}

VS Code는 "type": "http"도 함께 넣어 주세요.

주의 · 키가 들어간 설정 파일은 공유하거나 Git에 올리지 마세요. 키가 틀리면 연결이 거부되니, 읽기만 하려면 헤더를 빼고 연결하면 됩니다. 키가 새어 나갔다면 키를 바꾸세요. 바꾸면 예전 키로 만든 연결은 모두 끊깁니다.

직접 호출해 보기

MCP는 JSON-RPC를 POST로 주고받습니다. 터미널에서 도구 목록을 받아 보는 예시입니다.

curl -s {{URL}} -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Windows PowerShell에서는 따옴표 처리가 달라서 위 명령이 그대로 동작하지 않을 수 있습니다. Git Bash나 WSL에서 실행하세요.