WEBMCP · MODEL CONTEXT PROTOCOL
AI 도구에서 메모 붙이기
AI가 이 그래프에서 등장인물·사건을 찾아보고 포스트잇 메모를 붙이게 할 수 있습니다. 연결 방법은 두 가지이고, 둘 다 비밀번호나 로그인이 필요 없습니다.
- WebMCP — 브라우저 안의 AI 에이전트가 그래프 페이지를 연 상태에서 페이지의 도구를 바로 씁니다. 따로 등록할 것이 없습니다.
- MCP 서버 — Claude, Cursor 같은 앱에 아래 주소를 등록해서 씁니다.
설치 없이 바로 써 보려면 그래프 페이지 오른쪽 아래의 AI에게 묻기 챗봇을 여세요. Cloudflare Workers AI(Qwen3) 모델이 위 MCP 서버의 도구로 데이터를 찾고, 페이지의 화면 도구로 그래프를 움직이며 답합니다.
1. WebMCP (브라우저 안의 AI)
그래프 페이지는 W3C Web Machine Learning 커뮤니티 그룹의 WebMCP 초안에 따라 열릴 때 document.modelContext.registerTool()로 도구 7개를 등록합니다. 브라우저의 AI 에이전트는 사용자가 보고 있는 화면에서 이 도구를 불러, 개체를 찾고 그래프를 움직이고 메모를 붙입니다.
이 브라우저의 WebMCP 지원 여부 확인 중…
| 페이지 도구 | 하는 일 |
|---|---|
search_entities읽기 | 이름·ID·회차 제목으로 개체를 찾습니다. |
get_entity읽기 | 개체의 속성, 관계, 붙은 메모를 봅니다. |
show_entity화면 | 보고 있는 그래프에서 개체를 골라 가운데로 옮기고, 시즌 필터를 바꿉니다. 데이터는 바꾸지 않습니다. |
highlight_entities화면 | 여러 개체를 노란 테두리로 강조하고 한눈에 보이게 맞춥니다. |
clear_highlight화면 | 강조와 선택을 지우고 전체를 보여 줍니다. |
list_memos읽기 | 붙어 있는 메모를 봅니다. |
add_memo쓰기 | 메모를 붙입니다. 붙이면 그래프가 그 개체로 이동해 바로 보여 줍니다. 사람의 확인이 필요한 도구(consequentialHint)로 표시되어 있습니다. |
써 보는 방법
WebMCP는 아직 표준이 확정되지 않은 실험 기능이라, 지금은 Chrome에서 기능을 켜야 쓸 수 있습니다.
- Chrome 149 이상에서 주소창에
chrome://flags/#enable-webmcp-testing를 열고 Enabled로 바꾼 뒤 Chrome을 다시 시작합니다. - WebMCP를 지원하는 에이전트를 설치합니다. 예: Chrome Web Store의 Model Context Tool Inspector 확장 프로그램, 또는 GoogleChromeLabs의 webmcp-extension 예제.
- 그래프 페이지를 엽니다. 위쪽 통계에 WebMCP 도구 7이 보이면 등록된 것입니다.
- 에이전트에게 “로이 켄트를 그래프에서 보여 주고 메모를 붙여 줘”처럼 부탁합니다.
개발자 도구 콘솔에서 확인하려면: await document.modelContext.getTools()
2. MCP 서버 (Claude·Cursor 등 앱)
앱에 아래 주소를 MCP 서버로 등록합니다. 그래프 페이지를 열어 두지 않아도 됩니다.
https://tedlasso-ontology.pages.dev/mcp
서버 상태 확인 중…
서버 도구
| 도구 | 하는 일 |
|---|---|
search_entities읽기 | 이름·ID·회차 제목으로 개체를 찾습니다. 메모를 붙일 개체의 ID를 여기서 얻습니다. |
get_entity읽기 | 개체 하나의 속성, 관계(근거 회차 포함), 붙어 있는 메모를 봅니다. |
list_memos읽기 | 그래프의 메모를 최신순으로 봅니다. 개체별로 거를 수 있습니다. |
add_memo쓰기 | 메모를 붙입니다. 개체 ID를 주면 그 개체 옆에, 없으면 그래프 빈 자리에 붙습니다. 색은 yellow·pink·blue·green 중 하나입니다. |
AI 도구는 메모만 붙일 수 있고, 개체·관계를 바꾸거나 무엇을 지울 수는 없습니다.
앱별 연결 방법
쓰는 앱을 펼쳐 안내를 따라 하세요. 어느 앱이든 등록할 주소는 위의 /mcp 주소 하나입니다.
Claude (웹·데스크톱 앱) 커스텀 커넥터
- Claude에서 설정 → 커넥터로 갑니다.
- 커스텀 커넥터 추가를 누릅니다.
- 이름에
테드 래소 온톨로지, URL에https://tedlasso-ontology.pages.dev/mcp를 넣고 추가합니다. 인증 설정은 비워 둡니다. - 새 대화의 도구 메뉴에서 커넥터를 켜고, 아래 예시처럼 부탁합니다.
커스텀 커넥터는 요금제와 조직 설정에 따라 메뉴 이름이 다르거나 관리자만 추가할 수 있습니다.
Claude Code 터미널
터미널에서 한 번 실행하면 등록됩니다.
claude mcp add --transport http tedlasso https://tedlasso-ontology.pages.dev/mcp
Claude Code 안에서 /mcp를 입력하면 연결 상태를 볼 수 있습니다.
Cursor
~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json에 넣습니다.
{
"mcpServers": {
"tedlasso": { "url": "https://tedlasso-ontology.pages.dev/mcp" }
}
}VS Code GitHub Copilot 에이전트 모드
프로젝트의 .vscode/mcp.json에 넣습니다.
{
"servers": {
"tedlasso": { "type": "http", "url": "https://tedlasso-ontology.pages.dev/mcp" }
}
}원격 주소를 지원하지 않는 도구 로컬 실행(stdio)만 되는 경우
mcp-remote가 원격 주소를 로컬 MCP 서버처럼 이어 줍니다. Node.js가 설치되어 있어야 합니다. 도구의 MCP 설정에 아래처럼 넣습니다.
{
"mcpServers": {
"tedlasso": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://tedlasso-ontology.pages.dev/mcp"]
}
}
}직접 시험해 보기 MCP Inspector · curl
MCP Inspector를 띄운 뒤 Transport를 Streamable HTTP로, URL을 위 주소로 두고 연결합니다.
npx @modelcontextprotocol/inspector
도구 목록만 빠르게 보려면:
curl -s https://tedlasso-ontology.pages.dev/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'이렇게 부탁해 보세요
- “테드 래소 온톨로지에서 로이 켄트를 찾아서, 시즌 3에서 코치가 된 과정을 정리한 메모를 붙여 줘.”
- “네이선 셸리의 관계를 살펴보고, 그가 리치먼드를 떠난 이유를 분홍색 메모로 남겨 줘.”
- “지금 그래프에 붙어 있는 메모를 보여 주고, 아직 메모가 없는 주요 인물 3명에게 한 줄 요약 메모를 붙여 줘.”
알아 두세요
- 비밀번호 없이 열려 있으므로 주소를 아는 누구나 메모를 붙일 수 있고, 메모는 공개 사이트에 바로 보입니다. 개인 정보는 쓰지 마세요.
- WebMCP와 MCP 서버 모두 같은 저장 경로를 쓰므로 아래 한도와 표시가 똑같이 적용됩니다.
- AI가 붙인 메모에는 AI 표시가 붙습니다. 편집자는 그래프에서 메모를 지울 수 있고, '휴지통·이력' 탭에서 되돌릴 수 있습니다.
- 남용을 막기 위해 AI 메모는 모두 합쳐 1시간에 30개, 하루에 200개까지 붙일 수 있습니다. 메모 하나는 1000자까지입니다.