← 그래프로 돌아가기

MCP 연결 안내

Claude, Cursor 같은 AI 도구가 이 사이트의 데이터(작품·캐릭터·배우·인물 관계·크로스오버·회차 줄거리·메모)를 직접 검색하고 편집할 수 있게 해 주는 MCP 서버입니다.

서버 주소 https://dc-ontology.pages.dev/mcp Streamable HTTP · 로그인 없이 읽기 가능

권한

연결 방법

Claude Code (터미널)

읽기 전용:

claude mcp add --transport http dc-ontology https://dc-ontology.pages.dev/mcp

쓰기까지 (관리자 키를 넣어서):

claude mcp add --transport http dc-ontology https://dc-ontology.pages.dev/mcp --header "Authorization: Bearer 관리자키"

추가한 뒤 Claude Code에서 /mcp로 연결 상태를 확인할 수 있습니다.

Claude 데스크톱 앱 · claude.ai

  1. 설정 → 커넥터에서 커스텀 커넥터 추가를 누릅니다.
  2. 이름에 DC 드라마 온톨로지, URL에 위 서버 주소를 넣고 추가합니다.
  3. 새 대화에서 "배리 앨런의 인물 관계 알려줘"처럼 물어보면 도구를 씁니다.

커스텀 커넥터 화면에서는 헤더를 넣을 수 없어 읽기 전용으로 연결됩니다. 편집은 Claude Code나 웹 화면 관리 탭에서 해 주세요. 회사망에서는 정책에 따라 커스텀 커넥터가 막혀 있을 수 있습니다.

Cursor · VS Code · 기타 MCP 클라이언트

설정 파일(예: Cursor의 .cursor/mcp.json, VS Code의 .vscode/mcp.json)에 아래처럼 넣습니다. 읽기 전용이면 headers를 빼세요.

{
  "mcpServers": {
    "dc-ontology": {
      "url": "https://dc-ontology.pages.dev/mcp",
      "headers": { "Authorization": "Bearer 관리자키" }
    }
  }
}

VS Code는 최상위 키가 "servers"이고 항목에 "type": "http"를 함께 적습니다.

원격 MCP를 지원하지 않는 클라이언트

mcp-remote로 로컬 stdio 서버처럼 연결할 수 있습니다 (Node.js 필요).

{
  "mcpServers": {
    "dc-ontology": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://dc-ontology.pages.dev/mcp"]
    }
  }
}

직접 호출해 보기 (curl)

curl -s https://dc-ontology.pages.dev/mcp -H "content-type: application/json" -H "accept: application/json, text/event-stream" -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"search\",\"arguments\":{\"query\":\"Flash\"}}}"

연결 테스트

이 브라우저에서 MCP 서버에 initialize와 tools/list를 보내 봅니다.

도구 목록

도구권한하는 일
search읽기캐릭터·배우·작품·메모를 한글/영문/히어로명으로 검색
get_entity읽기항목 상세 + 출연 작품, 인물 관계, 등장인물, 메모
list_entities읽기종류별 목록 (show, char, event, platform, rel, memo)
get_relationship_network읽기인물 관계망 노드·관계선 (작품별로 좁히기 가능)
list_episodes읽기TVmaze 회차 목록·영문 줄거리, 제목·줄거리 검색
list_memos읽기전체 또는 특정 항목의 메모
list_history · list_trash읽기변경 이력, 휴지통
add_memo관리자메모 추가 (대상 지정 가능)
save_entity관리자작품·캐릭터·관계·크로스오버·플랫폼·메모 추가 또는 수정
delete_entity · restore_entity관리자휴지통으로 삭제, 복원
revert_change관리자변경 이력 하나를 취소

이렇게 물어보세요