문서 MCP 서버 — AI 도구에서 이 문서를 바로 찾기

PlantPulse 문서를 AI 도구가 직접 찾아 읽게 하는 MCP(Model Context Protocol) 서버입니다. Claude Code · Claude Desktop · Cursor · VS Code 처럼 MCP 를 지원하는 도구에 주소 하나만 넣으면, 대화 중에 문서를 검색하고 쪽 전체를 읽은 뒤 출처 링크를 달아 답합니다.

누구나 쓸 수 있습니다. 가입도 API 키도 필요 없습니다. 읽기 전용이라 문서를 고치거나 다른 시스템에 닿는 기능은 없습니다.

접속 정보

항목	값
주소	`https://docs.plantpulse.io/mcp`
전송 방식	Streamable HTTP (무상태 — 세션 없음)
인증	없음
언어	`en`(기본) · `ko` · `ja` · `zh` · `de`
문서 범위	이 사이트에 지금 게시된 문서 전체 — 플랫폼 · 엣지 · AI · 스튜디오 · 리소스

문서가 갱신되어 사이트가 다시 배포되면 MCP 서버의 내용도 함께 바뀝니다. 따로 색인을 기다릴 필요가 없습니다.

연결하기

Claude Code

claude mcp add --transport http plantpulse-docs https://docs.plantpulse.io/mcp

추가한 뒤 claude mcp list 에서 plantpulse-docs 가 ✓ Connected 로 보이면 됩니다. 프로젝트 전체가 함께 쓰게 하려면 --scope project 를 붙입니다(.mcp.json 에 기록됩니다).

Claude Desktop

설정 → 커넥터 → 사용자 지정 커넥터 추가에 주소 https://docs.plantpulse.io/mcp 를 넣습니다. 인증 항목은 비워 둡니다.

설정 파일(claude_desktop_config.json)로 넣으려면 원격 서버를 이어 주는 mcp-remote 를 씁니다(Node.js 가 필요합니다).

{
  "mcpServers": {
    "plantpulse-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.plantpulse.io/mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json 에 넣습니다.

{
  "mcpServers": {
    "plantpulse-docs": {
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

VS Code (GitHub Copilot 에이전트 모드)

작업 공간의 .vscode/mcp.json 에 넣습니다.

{
  "servers": {
    "plantpulse-docs": {
      "type": "http",
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

ChatGPT

ChatGPT 에서는 사용자 지정 커넥터(사용자 지정 MCP 서버)로 붙입니다.

사용자 지정 MCP 서버를 추가하는 화면을 엽니다. 지금은 Plugins(chatgpt.com/plugins)의 + → Add custom MCP server 이고, 판에 따라 설정 → 커넥터(Apps & Connectors) → 고급 설정 에서 개발자 모드를 켠 뒤 만들기 로 나오기도 합니다.
이름(예: PlantPulse Docs)과 설명을 넣고, 주소에 https://docs.plantpulse.io/mcp 를 넣습니다.
인증은 없음(No authentication)을 고릅니다.
위험 안내를 읽고 동의한 뒤 만듭니다. 서버가 알려 주는 도구 목록에 search · fetch 가 보이면 됩니다.

이 메뉴를 쓸 수 있는지는 ChatGPT 요금제와 워크스페이스 설정(관리자가 사용자 지정 커넥터를 허용했는지)에 따라 다르고, 메뉴 이름도 ChatGPT 판에 따라 바뀝니다. ChatGPT 의 커넥터와 딥 리서치는 이름이 정확히 search · fetch 인 도구를 찾으므로, 이 서버는 그 두 도구를 따로 제공합니다(아래 도구).

그 밖의 MCP 클라이언트

Streamable HTTP 를 지원하는 클라이언트라면 대개 아래 모양을 받습니다.

{
  "mcpServers": {
    "plantpulse-docs": {
      "type": "http",
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

도구

다섯 가지 모두 읽기 전용입니다.

도구	인자	돌려주는 것
`search_docs`	`query`(필수, 300자까지) · `product` · `locale` · `limit`(1~20, 기본 8)	가장 잘 맞는 절 — 제목 · 절 제목 · 제품 · 주소 · 발췌
`get_page`	`path`(필수) · `locale`	쪽 하나의 제목 · 주소 · 절 목록 · 본문 전체(6만 자까지)
`list_pages`	`product` · `locale` · `cursor` · `limit`(1~200, 기본 100)	쪽 목록 — 경로 · 제목 · 제품. 다음 묶음은 `cursor` 로
`search`	`query`(필수) · `locale` · `product` · `limit`(1~20, 기본 8)	ChatGPT 용. `{"results":[{id, title, url, text}]}` — 쪽 단위 결과
`fetch`	`id`(필수) — `search` 가 준 id 또는 문서 주소	ChatGPT 용. `{id, title, text, url, metadata}` — 쪽 하나의 본문 전체

product 는 platform · edge · ai · studio · resources 중 하나입니다. 여러 제품에 「비밀번호 · API 키 변경」 처럼 같은 제목의 쪽이 있으므로, 제품이 정해진 질문이면 지정하는 편이 정확합니다.
locale 을 주지 않으면 영어(en)로 찾습니다. 한국어로 묻는다면 ko 가 잘 맞습니다.
get_page 의 path 는 /platform/frontline/user-guide 같은 사이트 경로, /ko/... 처럼 언어가 붙은 경로, https://docs.plantpulse.io/... 전체 주소를 모두 받습니다. 없는 경로면 비슷한 쪽을 알려 줍니다.
search · fetch 는 ChatGPT 가 기대하는 이름과 모양으로 같은 색인을 돌려줍니다. search 는 locale 을 주지 않으면 검색어의 글자로 언어를 고릅니다(한글 → ko, 가나 → ja, 그 밖의 한자 → zh, 독일어 → de, 나머지 en). id 는 /ko/edge/user-guide/plc-profiling-testkit 처럼 언어가 붙은 쪽 경로입니다.
검색은 이 사이트의 문서 챗과 같은 색인 · 같은 방식(키워드 BM25, 한국어 조사 처리 포함)입니다.

AI 도구에는 서버가 «답할 때 돌려받은 주소를 출처로 달라» 는 안내를 함께 보냅니다. 답에 링크가 붙어 있으면 그 쪽을 열어 원문을 확인할 수 있습니다.

이용 한도

공개 서버라 한 사람이 자원을 독차지하지 못하게 몇 가지 한도를 둡니다.

항목	한도	넘으면
요청 횟수	IP 당 분당 약 30회(순간 20회까지 허용)	`429` — 1분 뒤 다시 시도
요청 크기	64 KB	`413`
검색어 길이	300자	도구 오류
검색 결과	한 번에 20개, 발췌는 700자 안팎	잘라서 돌려줌
쪽 본문	6만 자	잘라서 돌려주고 원문 주소를 덧붙임

AI 도구 하나가 연결할 때 보통 요청 서너 번(초기화 · 도구 목록)을 쓰고, 질문 하나에 검색 · 쪽 읽기를 몇 번 더 합니다. 평소 쓰임새로는 한도에 닿지 않습니다.

무엇이 기록되나

서버는 문서 사이트와 같은 웹 서버 접속 기록(접속 IP · 시각 · 주소)만 남깁니다. 검색어와 도구 인자는 따로 저장하지 않습니다. 회사 기밀이 담긴 문장을 검색어로 넣지는 마세요 — 공개 서버입니다.

직접 확인하기

클라이언트 없이 curl 로도 동작을 볼 수 있습니다. Accept 머리글에 두 형식을 모두 적어야 합니다.

curl -s https://docs.plantpulse.io/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_docs","arguments":{"query":"PLC 프로파일링","locale":"ko","limit":3}}}'

서버 상태(버전 · 문서 수)는 https://docs.plantpulse.io/mcp/healthz 에서 봅니다.

문제가 생기면

증상	원인과 조치
연결 실패 · `406`	클라이언트가 Streamable HTTP 를 지원하지 않거나 `Accept` 머리글이 빠졌습니다. 옛 SSE 전송 방식만 지원하는 클라이언트는 Claude Desktop 처럼 `mcp-remote` 를 거쳐 붙입니다.
`405`	`GET` 으로 불렀습니다. 이 서버는 무상태라 `POST` 만 받습니다.
`429`	요청이 한도를 넘었습니다. 1분쯤 뒤 다시 시도합니다.
`503`	사이트가 막 다시 배포되어 서버가 색인을 올리는 중입니다. 몇 초 뒤 다시 시도합니다.
결과가 영어로만 나옴	`locale` 을 주지 않았습니다. AI 도구에 «한국어 문서로 찾아 줘» 라고 말하면 `ko` 로 부릅니다.

접속 정보​

연결하기​

Claude Code​

Claude Desktop​

Cursor​

VS Code (GitHub Copilot 에이전트 모드)​

ChatGPT​

그 밖의 MCP 클라이언트​

도구​

이용 한도​

직접 확인하기​

문제가 생기면​