Claude Desktop 연결하기

Claude Desktop은 OAuth가 아닌 stdio 방식으로 연결합니다. 설정 파일을 편집한 뒤 npx -y slima-mcp@0을 실행하면 됩니다.

연결 순서

1 · SLIMA_API_TOKEN 발급받기

가장 빠른 방법은 npx slima-mcp@0 auth를 실행하는 것입니다. 브라우저가 자동으로 열리고, 로그인하면 토큰이 ~/.slima/credentials.json에 자동으로 저장됩니다.

수동으로 받고 싶다면 Account → API tokens 에서 토큰을 발급받으세요.

2 · Claude Desktop 설정 파일 찾기

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

파일이 없다면 직접 새로 만들면 됩니다.

3 · 설정 파일에 Slima 추가하기

설정 파일을 열고 아래 내용을 추가합니다.

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"]
    }
  }
}

토큰을 평문으로 적을 필요는 없습니다. slima-mcp CLI가 ~/.slima/credentials.json에서 자동으로 토큰을 읽어옵니다.

4 · Claude Desktop 재시작

새로고침만으로는 부족합니다. 앱을 완전히 종료한 뒤 다시 실행하십시오.

5 · 연결 확인

새 채팅을 열면 입력창 옆에 「🔌 slima」 아이콘이 보입니다. 이렇게 입력해보세요.

내 Slima 책 목록을 보여줘

여러 개의 MCP 서버를 함께 사용할 때

이미 다른 MCP 서버(예: filesystem-mcp)를 쓰고 있다면 이렇게 합쳐서 적습니다.

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/docs"]
    }
  }
}

고급: 평문 토큰 (권장하지 않음)

여러 계정을 함께 쓰는 등의 이유로 ~/.slima/credentials.json을 사용하기 어렵다면 다음과 같이 설정할 수 있습니다.

"slima": {
  "command": "npx",
  "args": ["-y", "slima-mcp@0"],
  "env": { "SLIMA_API_TOKEN": "slima_..." }
}

이 방식은 설정 파일 안에 토큰이 평문으로 그대로 남습니다. ~/.slima/credentials.json에 두고 chmod 600으로 권한을 잠그는 쪽이 더 안전합니다.

관련 문서

• SLIMA_API_TOKEN 발급받기
• slima-mcp CLI 명령어
• 연결이 안 될 때 문제 해결