Cloudflare Worker 직접 호스팅 (고급)

대부분의 경우 직접 호스팅할 필요는 없습니다. 다만 OAuth 흐름을 완전히 제어하거나, 자체 미들웨어를 추가하거나, 사내망 안에서 직접 운영하고 싶다면 Slima MCP 서버는 오픈 소스 Cloudflare Worker로 공개되어 있어 직접 실행할 수 있습니다.

왜 직접 호스팅을 고려할까요

• 사내망 환경: 트래픽이 회사 네트워크 밖으로 나가지 않게 하고 싶을 때
• OAuth 커스터마이즈: 사내 SSO와 연동해야 할 때
• 감사 로그 / 트래픽 제한 추가: 자체 정책을 얹고 싶을 때
• 학습 목적: MCP 서버의 내부 동작을 이해하고 싶을 때

사전 준비

• Node.js + npm
• Cloudflare 계정 (무료 플랜으로도 충분합니다)
• wrangler CLI (npm i -g wrangler)

진행 절차

1 · 레포 Fork

git clone https://github.com/slima-ai/slima-mcp-server
cd slima-mcp-server

2 · wrangler.toml 설정

name = "my-slima-mcp"
main = "src/index.ts"
compatibility_date = "2026-01-01"

[[kv_namespaces]]
binding = "OAUTH_KV"
id = "직접 만든 KV namespace id"

[vars]
SLIMA_API_BASE = "https://slima.ai/api/v1"

3 · 배포

npm install
wrangler login
npm run deploy:worker

배포가 끝나면 https://my-slima-mcp.workers.dev 같은 URL이 발급됩니다.

4 · 클라이언트 설정을 자신의 서버로 변경

예를 들어 Claude Desktop의 경우는 다음과 같습니다.

"slima": {
  "command": "npx",
  "args": ["-y", "slima-mcp@0", "--server", "https://my-slima-mcp.workers.dev"]
}

claude.ai의 Custom Connector를 사용한다면 URL을 자신의 worker 주소로 지정하면 됩니다.

Slima API용 토큰

직접 호스팅한 worker도 결국은 Slima의 /api/v1와 통신합니다. 즉, 사용자는 여전히 Slima 계정 + API 토큰이 필요합니다.

직접 호스팅한다고 해서 Slima 구독을 우회할 수 있는 것은 아닙니다. worker에서 발생한 트래픽은 그대로 Slima API에 도달하며, 동일한 사용량 / 요금 정책의 적용을 받습니다.

디버그

wrangler tail my-slima-mcp

프로덕션 worker의 실시간 로그를 확인할 수 있습니다.

자세한 내용은 고급 디버그를 참고하십시오.

관련 문서

• Schema 리소스
• OAuth 디버그