MCP 연동

이 기능이 필요한 사람

먼저 내 상황에 맞는 다음 행동을 확인하세요. 현재 기본 연결 대상은 같은 내부 네트워크의 PC에 설치한 Claude Desktop입니다.

• 1 Dotory 앱 안에서만 사용MCP를 설정하지 않습니다. 기존 AI 채팅과 공유업무 사용에는 이 연결이 필요하지 않습니다.
• 2 운영 담당자에게 Claude Desktop 연결 안내를 받음이 가이드의 준비 상태를 확인한 뒤 ‘자동 추가’를 사용합니다.
• 3 직접 설정하거나 다른 AI 앱에 연결해야 함지원 범위를 먼저 확인해야 합니다. 설정 파일을 임의로 고치지 말고 운영 담당자에게 연결 지원을 요청하세요.

브라우저에서 여는 Claude 웹사이트만으로는 내부 네트워크의 Dotory 서버에 연결할 수 없습니다. Dotory에 로그인한 뒤 왼쪽 도구 모음 아래의 ‘설정’을 열고, 설정 목록에서 ‘MCP 연동’을 선택하면 ‘AI 연동 (MCP)’ 화면이 나타납니다.

연결 전에 꼭 확인하세요

MCP를 연결하면 Claude Desktop이 현재 Dotory 계정으로 업무 자료를 조회하고 일부 내용을 변경할 수 있습니다.

• 1 외부 앱이 처리하는 자료현재 계정이 볼 수 있는 공유업무 자료와 대화, 본인의 개인 대화를 Claude Desktop이 요청할 수 있습니다.
• 2 조회뿐 아니라 변경도 가능보기 권한으로 접근한 업무에서도 메모 작성이나 제목 변경을 요청할 수 있고, 새 최상위 공유업무는 공개 범위로 만들어질 수 있습니다.
• 3 인증 키는 공유 금지연결 코드는 현재 로그인 인증 키 전체를 Claude Desktop 설정 파일에 일반 텍스트로 저장합니다. 파일·코드·화면을 공유하거나 캡처하지 마세요.
• 4 신뢰할 수 있는 내부 네트워크에서만 사용현재 연결은 암호화되지 않습니다. 외부 AI 사용이 허용된 자료인지 소속 조직의 정책도 먼저 확인하세요.

준비 상태 확인하기

‘MCP 연동’ 화면의 ‘준비 상태’에서 ‘도토리 서버 연동 가능’과 ‘Node.js 설치됨’이 모두 보여야 합니다. 이 표시는 연결을 시작할 준비가 됐다는 뜻이며, Claude Desktop 연결 완료 상태는 아닙니다.

• 현재 PC에 Claude Desktop이 설치되어 있고 Dotory와 같은 내부 네트워크에 연결되어 있어야 합니다.
• 서버에 빨간 안내가 보이면 ‘새로고침’을 한 번 누릅니다. 그대로라면 서비스 운영 담당자에게 서버 MCP 기능·네트워크·현재 로그인 상태를 확인해 달라고 요청하세요.
• Node.js는 v20.18.1 이상이어야 합니다. 설치한 뒤 ‘새로고침’을 누르고, 상태가 바뀌지 않으면 Dotory를 완전히 종료한 뒤 다시 실행하세요.

Claude Desktop에 연결하기

준비 상태가 모두 정상이라면 설정 파일을 먼저 열거나 코드를 복사하지 말고 ‘자동 추가’를 사용하세요. 아래 네 단계만 마치면 기본 연결이 끝납니다.

1. 1 준비 상태 확인하기‘도토리 서버 연동 가능’과 ‘Node.js 설치됨’이 모두 보이는지 확인합니다. 빨간 안내가 하나라도 있으면 여기서 멈춥니다.
2. 2 자동 추가 누르기‘Claude Desktop’ 카드에서 ‘자동 추가’를 누릅니다. 기존의 다른 외부 도구 연결은 유지되고, 이전 Dotory 연결이 있으면 현재 계정 정보로 바뀝니다.
3. 3 Claude Desktop 완전히 다시 시작하기창만 닫지 말고 트레이에 남은 Claude Desktop까지 종료한 뒤 다시 실행합니다.
4. 4 조회 요청으로 확인하기Dotory 도구가 보이면 테스트용 공유업무에서 “내가 접근 가능한 공유업무 이름을 보여줘”라고 요청합니다. 공유업무 이름이 정상적으로 나오면 연결이 끝난 것입니다.

연결 코드는 Claude Desktop의 현재 운영체제 사용자 설정 파일에 저장됩니다. Dotory 앱을 다시 설치하거나 백업을 복원해도 이 파일이 자동으로 만들어지거나 다른 PC로 옮겨지지는 않습니다.

{
  "mcpServers": {
    "dotory-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://DOTORY_SERVER:5250/mcp",
        "--allow-http",
        "--header",
        "x-client-key:YOUR_CLIENT_KEY"
      ]
    }
  }
}

문제가 생겼을 때

연결되지 않거나 다시 인증하라는 안내가 나오면 증상에 맞는 항목을 확인하세요.

관련 가이드