연결 방식 선택하기: Web vs 로컬

어떤 방식으로 연결할지는 사용하는 AI 도구에 따라 결정됩니다. 웹 도구는 OAuth, 로컬 도구는 stdio 방식으로 연결합니다.

두 가지 경로

Web (OAuth)

• 대상: claude.ai, ChatGPT (웹)
• 설정: 도구에서 "Custom MCP server" 추가, URL은 https://mcp.slima.ai/mcp
• 인증: OAuth로 Slima 로그인 페이지에 이동 → 권한 부여
• 필요 없음: 로컬 소프트웨어, 토큰, npm

자세히 보기: Claude.ai에서 연결하기 · ChatGPT에서 연결하기

로컬 (stdio)

• 대상: Claude Desktop, Cursor, Gemini CLI, VS Code
• 설정: npx -y slima-mcp@0 실행, 토큰을 config에 입력
• 인증: API 토큰 (한 번 설정하면 오래 사용 가능)
• 필요: node.js 설치

자세히 보기: Claude Desktop · Cursor · Gemini CLI · VS Code

어떻게 선택하나요

사용 중인 AI 도구가 결정합니다. 대부분의 경우 선택의 여지가 없습니다:

도구	사용 방식
claude.ai	Web
ChatGPT 웹	Web
Claude Desktop	stdio
Cursor	stdio
Gemini CLI	stdio
VS Code MCP	stdio

도구가 두 방식을 모두 지원하는 경우(드물지만) — Web은 더 간단하고, stdio는 더 유연합니다.

보안 모델

Web OAuth

• 매번 OAuth 절차로 재인증합니다
• Slima는 토큰을 Cloudflare KV에 PKCE와 함께 저장합니다
• 승인된 앱에서 권한을 취소할 수 있습니다

로컬 stdio

• 토큰은 한 번 발급되어 ~/.slima/credentials.json (chmod 600)에 저장됩니다
• Account → API tokens에서 권한을 취소할 수 있습니다
• 장시간 안정적으로 연결되는 환경에 적합합니다

관련 문서

• Slima MCP란 무엇인가
• API 토큰 받기