← 그래프 목록

MCP 연결 안내

Claude, Cursor, VS Code 같은 AI 도구가 도깨비의세계 거래 그래프를 직접 조회하고 메모를 관리하도록 연결하는 방법입니다.

MCP 엔드포인트 https://dokkaebi-graph.pages.dev/mcp

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

제공 도구

도구하는 일권한
get_ontology클래스·속성·제약·파생 규칙(R1~R4), 그래프 노드 id 형식공개
get_trade_summary거래종료 7일 집계. 전체 / 서버(server) / 서버군(group)별 건수·1만당 가격공개
list_servers서버 순위 (건수 또는 1만당 중앙값 기준)공개
list_notes그래프에 붙은 메모 목록, 휴지통 보기공개
add_note메모 추가. node_id를 주면 해당 노드에 붙음편집
update_note메모 글·색·위치·붙은 노드 수정편집
delete_note휴지통으로 이동, permanent면 휴지통에서 영구 삭제편집
restore_note휴지통 메모 복원편집

AI가 추가한 메모는 온톨로지 그래프(page: ontology)와 집계 그래프(page: summary)에 포스트잇으로 바로 보입니다.

도구별 연결 방법

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

읽기 전용

claude mcp add --transport http dokkaebi {EP}

편집 포함

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

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

설정의 개발자 메뉴에서 claude_desktop_config.json을 열고 아래를 추가한 뒤 앱을 다시 시작합니다. 원격 서버를 로컬 연결로 바꿔 주는 mcp-remote를 쓰므로 Node.js가 필요합니다.

{
  "mcpServers": {
    "dokkaebi": {
      "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}

커스텀 커넥터는 임의의 헤더를 넣을 수 없어서 이 방식으로는 읽기 도구만 동작합니다. 편집까지 하려면 Claude Code나 Claude Desktop 방식을 쓰세요. 커스텀 커넥터 사용 가능 여부는 요금제와 조직 설정에 따라 다릅니다.

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

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

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

{
  "inputs": [
    { "type": "promptString", "id": "dokkaebi-token", "description": "편집 비밀번호", "password": true }
  ],
  "servers": {
    "dokkaebi": {
      "type": "http",
      "url": "{EP}",
      "headers": { "Authorization": "Bearer ${input:dokkaebi-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"}'

연결 후 이렇게 물어보세요

참고