JW.org 콘텐츠 작업을위한 MCP 서버 - 연구 노트, 워크북 자료, 워치 ꀰ사 및 비디오 캡션이있는 성경 스크리닝 조회.

빠른 시작

Claude 코드 (추천)

Claude 데스크탑

릴리스에서 최신 jw-mcp.mcpb을 다운로드하고 엽니 다 — Claude Desktop 자동으로 설치됩니다.

또는 macOS에서 config ([T1]]]에 수동으로 추가, %APPDATA%\Claude\claude_desktop_config.json] Windows에서:

다른 MCP 클라이언트 (현재, 윈드 서핑, 등)

---

Docker (자기 호스팅)

public HTTPS URL을 가진 기계에 이 서버를 실행하고, 그 URL을 Grok, Claude.ai 또는 ChatGPT로 사용자 정의 커넥터로 붙여 넣으십시오.

Compose는 루프백에만 컨테이너를 바인딩합니다 (127.0.0.1:8080). 공중 인터넷에 8080 포트를 게시하지 마십시오. 호스트에 역 프록시를 넣어, TLS를 종료, 그리고 프록시에 127.0.0.1:8080.

** 포트 443 사용. ** Claude.ai는 다른 포트에 사용자 정의 커넥터에 연결하지 않습니다. 그것은 "Couldn’t는 MCP 서버에 도달하지 않습니다."라고 말합니다. Grok는 다른 포트를 허용하므로 https://host:18443/mcp] 같은 URL은 Grok에서 작동 할 수 있으며 여전히 Claude에 실패합니다.

JW MCP Server

An MCP server for working with JW.org content — Bible scripture lookup with study notes, workbook materials, Watchtower articles, and video captions.

Quick Start

Claude Code (Recommended)

claude mcp add jw-mcp -- npx -y jw-mcp

Claude Desktop

Download the latest jw-mcp.mcpb from Releases and open it — Claude Desktop will install it automatically.

Or add manually to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "jw-mcp": {
      "command": "npx",
      "args": ["-y", "jw-mcp"]
    }
  }
}

Other MCP Clients (Cursor, Windsurf, etc.)

npx -y jw-mcp

---

Docker (self-hosted)

Run this server on a machine with a public HTTPS URL, then paste that URL into Grok, Claude.ai, or ChatGPT as a custom connector.

Compose binds the container to loopback only (127.0.0.1:8080). Do not publish port 8080 on the public internet. Put a reverse proxy on the host, terminate TLS there, and proxy to 127.0.0.1:8080.

Use port 443. Claude.ai never connects to a custom connector on any other port. It only says “Couldn’t reach the MCP server”. Grok accepts other ports, so a URL like https://host:18443/mcp can work in Grok and still fail in Claude. The server logs a warning at startup when MCP_BASE_URL has a port.

1. Copy .env.example to .env.
2. Set MCP_BASE_URL to your public origin, with no path and no port. Example: https://jw-mcp.example.com.
3. Set MCP_AUTH_SECRET to a long access key (at least 16 characters).
4. Keep MCP_AUTH=true. HTTP mode with auth off is loopback-only. Do not disable auth in Docker.
5. Set MCP_TRUST_PROXY=true only when exactly one proxy sits in front of the server and sets or appends the real client IP in X-Forwarded-For (Caddy, nginx, or a Cloudflare Tunnel). Leave it unset otherwise.
6. Start it:

docker compose up --build -d

The connector URL is:

https://your-host/mcp

When you add the connector, the AI site opens a login page. Type the same access key you put in MCP_AUTH_SECRET.

Local HTTP (http://localhost:8080) is fine for testing because compose binds loopback. Claude, ChatGPT, and Grok must reach a public HTTPS URL. A tunnel such as ngrok or Cloudflare Tunnel can expose that loopback port for a live click-test. Do not publish 8080 on 0.0.0.0.