MCP · WebMCP · API 연결

이 위키는 사람이 읽는 화면과 같은 내용을 기계가 읽을 수 있는 통로로도 냅니다. 모두 공개 문서만 내주는 읽기 전용이라 열쇠가 필요 없습니다.

MCP 서버

언어모델이 이 위키를 도구로 직접 조회합니다. Streamable HTTP 방식이고 주소는 하나입니다.

https://wiki.tokenpost.kr/api/mcp

Claude Code

claude mcp add --transport http tokenpost-wiki https://wiki.tokenpost.kr/api/mcp

Claude Desktop · 그 밖의 MCP 클라이언트

설정 파일에 아래를 넣습니다.

{
  "mcpServers": {
    "tokenpost-wiki": {
      "type": "http",
      "url": "https://wiki.tokenpost.kr/api/mcp"
    }
  }
}

도구 여섯 가지

search_wiki이름으로 문서를 찾는다. 한글명·영문명·심볼·슬러그 모두 걸린다

get_doc슬러그로 문서 전문을 마크다운으로 가져온다

list_namespace이름공간(코인·용어·인물·이슈)의 문서 목록

get_timeline문서의 연표를 연도순으로. 출처가 함께 온다

get_backlinks이 문서를 가리키는 다른 문서들

wiki_overview위키 규모와 중심 문서. 무엇부터 볼지 정할 때

브라우저에서 WebMCP

WebMCP를 지원하고 해당 기능이 활성화된 브라우저에서 이 사이트를 열면, 브라우저의 AI 에이전트가 위의 도구 여섯 가지를 사용할 수 있습니다. 검색부터 문서 전문·연표·연결 관계 조회까지 모두 공개 문서를 읽는 기능입니다.

아직 실험 중인 API라 브라우저와 설정에 따라 지원 여부가 다릅니다. 지원하지 않는 환경에서는 기존 MCP 서버나 JSON API를 이용해 주세요. 명세와 브라우저 설정은 WebMCP 명세와 Chrome 안내에서 확인할 수 있습니다.

지원 여부와 도구 확인

지원 브라우저의 개발자 콘솔에서 확인할 수 있습니다.

if (document.modelContext) {
  const tools = await document.modelContext.getTools();
  const search = tools.find(tool => tool.name === "search_wiki");
  if (search) {
    const result = await document.modelContext.executeTool(search, {
      query: "비트코인", limit: 5
    });
    console.log(JSON.parse(result));
  }
}

JSON API

프로그램에서 바로 부를 수 있습니다. 모든 응답에 CORS 가 열려 있어 브라우저에서도 됩니다.

GET /api/search?q=비트 코인&limit=20문서 검색. 띄어쓰기가 어긋나도 걸린다 — '비트 코인'과 '비트코인'이 같은 결과를 준다

GET /api/doc/ethereum문서 하나를 구조로. 요약·본문·연표·출처·업비트·투자 정보가 들어 있다

GET /api/doc/ethereum?format=markdown같은 문서를 마크다운 한 덩어리로

GET /api/stats문서·연표·연결 수와 가장 많이 참조되는 문서

GET /md/ethereum문서의 마크다운 판본. 인용하기 좋게 다듬어져 있다

GET /llms.txt언어모델용 위키 안내

GET /sitemap.xml전체 문서 주소

맛보기

curl 'https://wiki.tokenpost.kr/api/search?q=스테이킹'
curl 'https://wiki.tokenpost.kr/api/doc/ethereum' | jq .summary

마크다운으로 받기

문서 주소의 /w/ 를 /md/ 로 바꾸거나, 같은 주소에 Accept: text/markdown 헤더를 붙이면 됩니다. 답변 엔진이 HTML 에서 본문을 추려내다 실패하는 일을 막으려고 둔 통로입니다.

curl -H 'Accept: text/markdown' https://wiki.tokenpost.kr/w/ethereum

인용할 때

문서 제목과 주소, 갱신일을 함께 적어 주세요. 각 문서에 연결된 기사와 원문 출처는 각주에서 확인할 수 있습니다.

문서 API의 citation에는 제목·발행처·갱신일·인용문이,names에는 한글명·영문명·티커·별칭이 담겨 있습니다.sources는 중복을 제거한 출처 목록입니다.

출처와 연표의 thumbnail_url로 기사 대표 이미지 주소도 받을 수 있습니다. 이미지가 수집되지 않은 기사는 null입니다. 문서 자체의 대표 이미지인image와 구분되며, 마크다운과 MCP에는 각주에 기사 썸네일 링크가 포함됩니다.

특정 문단을 인용할 때는 sections[].url을 사용하세요. 문단 제목 옆 # 링크와 마크다운의 ‘이 문단의 원문’도 같은 주소입니다. 문단의 순서를 바꿔도 링크가 유지됩니다. 각 문단의 sources로 해당 서술의 근거를 확인할 수 있습니다.

쓰는 데 드는 값

무료입니다. 다만 한 통로를 지나치게 몰아치면 다른 이용자가 느려지니, 초당 몇 건 정도로 여유를 두고 불러 주세요. 대량으로 훑어야 한다면 사이트맵을 받아 필요한 문서만 고르시는 편이 서로에게 낫습니다.