🔌 AI 에이전트 연결 안내

전국 자연휴양림 185곳의 지식 그래프를 AI가 직접 검색하고 다룰 수 있게 연결하는 두 가지 방법입니다.

💬 바로 물어보기 MCP 연동 챗봇 · 설치 없음

아래 챗봇은 이 페이지에서 안내하는 원격 MCP 서버(/mcp)의 도구를 그대로 불러 답합니다(Cloudflare Workers AI gemma-4-26b-a4b-it). 어떤 도구를 불렀는지는 답변 아래 "🔧 MCP 도구"를 펼치면 보입니다.

① 원격 MCP 서버 추천 · 읽기 전용 · 로그인 없음

Claude 같은 AI 앱에 아래 주소를 추가하면, 대화 중에 AI가 휴양림을 검색하고 상세 정보·주변 휴양림·메모를 찾아 답합니다.

https://forest-graph.pages.dev/mcp

서버 상태 확인 중…

Claude (웹·데스크톱 앱)

설정 → 커넥터로 갑니다.
사용자 지정 커넥터 추가를 누릅니다.
이름은 forest-graph처럼 아무거나, URL에는 위 주소를 넣고 추가합니다. 인증 설정은 비워 둡니다.
새 대화에서 커넥터를 켜고 아래 예시처럼 물어봅니다.

Claude Code

claude mcp add --transport http forest-graph https://forest-graph.pages.dev/mcp

그 밖의 MCP 클라이언트

전송 방식 Streamable HTTP, 인증 없음. 설정 파일을 쓰는 클라이언트라면 다음과 같이 넣습니다.

{
  "mcpServers": {
    "forest-graph": { "type": "http", "url": "https://forest-graph.pages.dev/mcp" }
  }
}

이렇게 물어보세요

강원도 국립 휴양림 중에 계곡이 있는 곳 알려줘

유명산자연휴양림 주변 20km 안의 휴양림은?

편백 숲이 있는 휴양림을 지역별로 정리해줘

성불산자연휴양림 입장료와 주요시설은?

③ 페이지 안 AI 챗봇 설치 없음 · Cloudflare Workers AI

그래프 페이지 오른쪽 아래 💬 AI에게 묻기를 누르면 바로 쓸 수 있습니다. 챗봇은 위 ①의 MCP 서버를 MCP 클라이언트로 불러 데이터를 찾고, ②의 화면 도구로 그래프·지도를 직접 바꿉니다.

질문을 받으면 서버(/chat)가 MCP initialize → tools/list로 도구 목록을 받고, 모델(@cf/google/gemma-4-26b-a4b-it)이 고른 도구를 tools/call로 실행합니다.
모델이 화면 도구(switch_view, set_filters, show_forest, highlight_forests)를 고르면 페이지가 실행합니다.
검색 결과 휴양림은 그래프에서 금색 테두리로, 지도에서 금색 고리로 강조되고 나머지는 흐려집니다. 상세 패널에서는 검색어에 형광펜이 칠해집니다.
답변 속 휴양림 이름과 결과 카드를 누르면 그 노드로 이동하고, "🔧 MCP 도구" 줄을 펼치면 어떤 도구를 어떤 인자로 불렀는지 보입니다.

무료 한도(하루 10,000 뉴런)를 다 쓰면 그날은 챗봇이 답하지 못할 수 있습니다. 헤더 검색창에서 Enter를 눌러도 같은 방식으로 결과가 강조됩니다.

② WebMCP 브라우저 안 AI · 실험 기능

그래프 페이지가 WebMCP(document.modelContext)로 브라우저의 AI 에이전트에게 도구를 직접 제공합니다. 검색 도구에 더해 화면을 움직이고 필터를 바꾸며, 허락한 경우 메모도 붙일 수 있습니다.

이 브라우저의 WebMCP 지원 여부 확인 중…

켜는 방법 (Chrome)

주소창에 아래를 붙여 넣고 WebMCP for testing을 Enabled로 바꿉니다.
```
chrome://flags/#enable-webmcp-testing
```
Chrome을 완전히 다시 시작합니다.
그래프 페이지를 열고 오른쪽 위 🔌 버튼에서 "도구 N개 등록됨"이 보이는지 확인합니다.
WebMCP를 지원하는 에이전트나 확장 프로그램(예: Chrome의 Model Context Tool Inspector)으로 그 탭의 도구를 불러 씁니다.

WebMCP는 표준 논의 중인 기능이라 Chrome 버전에 따라 이름과 동작이 바뀔 수 있습니다. 이 페이지는 새 이름(document.modelContext)과 예전 이름(navigator.modelContext)을 모두 지원합니다. 도구는 그래프 페이지가 열려 있는 탭에서만 쓸 수 있습니다.

메모 붙이기(`add_note`)를 쓰려면

그래프 페이지 왼쪽 편집 (D1 저장)에서 편집 모드를 켜고 편집 토큰을 넣어 둔 경우에만 동작합니다. 이 도구는 "중요한 동작"(consequentialHint)으로 표시되어, 에이전트가 실행 전에 사용자 확인을 받을 수 있습니다.

도구 목록

원격 MCP 서버는 데이터 도구 5개를, WebMCP는 여기에 화면 도구 6개를 더해 11개를 제공합니다. 페이지 챗봇은 메모 붙이기를 뺀 10개를 씁니다.

도구	하는 일	MCP	WebMCP
`search_forests`	이름·주소 키워드, 조회 지역, 운영주체(국립·공립·사립), 특성 태그로 휴양림 검색	✓	✓
`get_forest`	주소·전화·입장료·특성·주요시설·15km 이내 휴양림·붙은 메모, 그래프 페이지 링크	✓	✓
`list_facets`	검색에 쓸 지역·운영주체·특성 태그(분류별) 목록과 휴양림 수	✓	✓
`find_nearby`	기준 휴양림에서 지정한 km 안의 휴양림을 가까운 순으로	✓	✓
`list_notes`	그래프에 사람이 붙인 포스트잇 메모	✓	✓
`show_forest`	그래프·지도에서 휴양림으로 이동하고 상세 패널 열기		✓
`set_filters`	지역·운영주체·특성 필터 바꾸기 또는 지우기		✓
`switch_view`	그래프 ↔ 지도 화면 전환		✓
`highlight_forests`	휴양림을 그래프·지도에서 금색으로 강조하고 그쪽으로 화면 이동, 검색어 형광펜		✓
`clear_highlight`	강조 표시 지우기		✓
`add_note`	노드에 포스트잇 메모 붙이기 (편집 모드·토큰 필요)		✓

자주 묻는 질문

원격 MCP 서버로 데이터를 바꿀 수 있나요?: 아니요. 원격 MCP 서버는 읽기 전용입니다. 데이터 편집은 그래프 페이지의 편집 모드(편집 토큰 필요)에서만 할 수 있습니다.
데이터는 언제 기준인가요?: 휴양림 정보는 2026-10-27에 수집했고, 웹에서 고친 내용과 메모는 바로 반영됩니다. "예약 가능성"은 수집 시점의 추정값이라 실제 잔여 객실이 아닙니다.
Claude에서 도구가 보이지 않아요.: URL 끝이 /mcp인지 확인하고, 커넥터를 추가한 뒤 새 대화에서 커넥터가 켜져 있는지 봅니다. 위 "서버 상태"가 정상인지도 확인하세요.
WebMCP 상태가 "지원 안 함"으로 나와요.: 플래그를 켠 뒤 Chrome을 완전히 다시 시작했는지 확인하세요. 다른 브라우저나 버전에서는 아직 지원하지 않을 수 있습니다. 이때도 ① 원격 MCP 서버는 그대로 쓸 수 있습니다.
그래프의 특정 휴양림을 링크로 보내고 싶어요.: 주소 끝에 #노드ID를 붙이면 그 휴양림이 바로 열립니다. 예: https://forest-graph.pages.dev/#forest%3A0101 (유명산자연휴양림). get_forest 결과의 page에 이 링크가 들어 있습니다.