MCP 연동

Claude Desktop 같은 외부 AI 도구에서 Dotory 서버 데이터를 검색하고 활용하도록 연결합니다.

MCP 연동

MCP 연동은 외부 AI 도구가 Dotory 서버에 연결해 회사 자료, 공유업무, 도구 정보를 사용할 수 있게 해주는 설정입니다. Dotory 앱 안에서만 AI 채팅을 쓴다면 필수는 아니지만, Claude Desktop 같은 별도 AI 앱에서도 Dotory 데이터를 쓰려면 이 설정이 필요합니다.

💡 사용자는 이 화면의 안내에 따라 설정 코드를 외부 AI 도구에 넣으면 됩니다. 서버 기능 활성화가 필요하면 관리자에게 먼저 요청하세요.

화면 구성

1 준비 상태 — Dotory Chat 서버 MCP 기능과 내 PC의 Node.js 설치 상태를 확인합니다.
2 설정 코드 — 외부 AI 도구의 설정 파일에 넣을 연결 코드입니다.
3 서버 URL — 외부 AI 도구가 연결할 Dotory MCP 주소입니다.
4 인증 키 — Dotory 서버 접근 권한을 확인하는 키입니다. 외부에 공개하지 마세요.
5 Claude Desktop — 설정 파일을 열거나, 현재 설정 코드를 자동으로 추가합니다.

연동 전 준비

MCP 연동은 사용자 PC와 Dotory Chat 서버가 모두 준비되어 있어야 동작합니다. 설정 화면의 ‘준비 상태’에서 두 항목을 먼저 확인하세요.

1 Dotory Chat 서버 MCP 기능 — 준비 상태에 ‘서버에서 MCP 기능을 켜야 합니다’가 보이면 사용자가 직접 해결할 수 없습니다. 관리자에게 Dotory Chat 서버의 MCP 기능을 켜 달라고 요청하세요.
2 Node.js 설치 — 내 PC에 Node.js가 필요합니다. 화면에 ‘설치가 필요합니다’ 또는 ‘v20.18.1 이상 설치가 필요합니다’가 보이면 nodejs.org에서 최신 LTS 버전을 설치하세요.
3 새로고침 — 서버 설정을 켰거나 Node.js를 설치한 뒤에는 Dotory를 다시 열고 ‘새로고침’을 눌러 준비 상태가 정상인지 확인합니다.

⚠️ Node.js 설치 후에도 상태가 바뀌지 않으면 PC를 재시작하거나 Dotory 앱을 완전히 종료한 뒤 다시 실행해 보세요.

Claude Desktop 연결

Claude Desktop을 기준으로 하면, Dotory 화면의 설정 코드를 Claude 설정 파일에 넣고 앱을 다시 실행하면 됩니다.

1 준비 상태 확인 — ‘Dotory Chat 서버 연동 가능’과 ‘Node.js 설치됨’이 보이는지 확인합니다.
2 설정 코드 복사 — ‘설정 코드’ 영역 오른쪽의 ‘복사’를 눌러 전체 코드를 복사합니다.
3 설정 파일 열기 — ‘Claude Desktop’ 영역의 ‘설정 파일 열기’를 누릅니다. Windows에서는 보통 메모장으로 설정 파일이 열립니다.
4 설정 코드 붙여넣기 — 설정 파일에 복사한 코드를 넣고 저장합니다. 이미 다른 MCP 설정이 있으면 기존 `mcpServers` 안에 `dotory-chat` 항목을 추가해야 합니다.
5 Claude Desktop 재시작 — Claude Desktop을 완전히 종료한 뒤 다시 실행합니다. 창만 닫는 것이 아니라 트레이에 남아 있으면 종료 후 다시 켜야 합니다.

💡 ‘자동 추가’를 누르면 Dotory가 Claude 설정 파일의 `mcpServers`에 현재 설정 코드를 자동으로 합칩니다. 수동 편집이 어렵다면 ‘자동 추가’를 먼저 사용하세요.

설정 코드 이해

설정 코드는 외부 AI 도구가 Dotory MCP 서버로 접속할 때 필요한 실행 명령입니다. 실제 서버 URL과 인증 키는 사용자마다 다르므로 반드시 Dotory 화면에서 복사한 값을 사용하세요.

설정 코드 예시

{
  "mcpServers": {
    "dotory-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://Dotory Chat서버주소:5250/mcp",
        "--allow-http",
        "--header",
        "x-client-key:내-인증-키"
      ]
    }
  }
}

1 command: npx — Node.js에 포함된 실행 도구입니다. 그래서 Node.js 설치가 필요합니다.
2 mcp-remote@latest — Claude Desktop이 원격 MCP 서버에 연결할 때 사용하는 도구입니다.
3 서버 URL — Dotory 서버 주소 뒤에 `/mcp`가 붙은 주소입니다. 화면의 값을 그대로 사용하세요.
4 x-client-key — Dotory에서 발급된 인증 키입니다. 다른 사람에게 공유하지 마세요.

연동 확인

1 Dotory에서 확인 — ‘새로고침’을 눌러 서버가 ‘연동 가능’으로 표시되는지 확인합니다. ‘지원 도구’가 보이면 사용할 수 있는 Dotory 도구 목록도 확인할 수 있습니다.
2 Claude에서 확인 — Claude Desktop 재시작 후 도구 목록에 Dotory 관련 도구가 보이는지 확인합니다.
3 간단히 테스트 — Claude에서 “Dotory에서 내가 접근 가능한 공유업무를 확인해줘”처럼 Dotory 데이터를 사용하는 요청을 해봅니다.

자주 묻는 질문

MCP 연동을 꼭 해야 하나요?

아니요. Dotory 앱 안에서 기본 기능만 사용한다면 MCP 연동은 필요하지 않습니다. Claude Desktop 같은 외부 AI 도구에서 Dotory 데이터를 사용하려는 경우에만 설정하세요.

‘서버에서 MCP 기능을 켜야 합니다’가 보이면 어떻게 하나요?

사용자가 직접 켤 수 있는 항목이 아닙니다. 관리자에게 Dotory Chat 서버의 MCP 기능 활성화와 외부 도구 접근 허용 여부를 확인해 달라고 요청하세요.

Node.js를 설치했는데도 설치가 필요하다고 나와요.

Dotory 앱을 완전히 종료한 뒤 다시 실행하거나 PC를 재시작해 보세요. 그래도 같다면 Node.js 버전이 20.18.1 이상인지 확인하세요.

설정 코드를 어디에 넣어야 하나요?

Claude Desktop을 쓰는 경우 ‘설정 파일 열기’를 눌러 열린 설정 파일에 넣습니다. 기존 설정이 없다면 전체 코드를 넣고, 기존 `mcpServers`가 있다면 그 안에 `dotory-chat` 항목을 추가합니다.

인증 키를 다른 사람에게 보내도 되나요?

보내지 않는 것이 원칙입니다. 인증 키는 Dotory 서버 접근에 사용되므로 필요한 담당자에게만 안전한 방식으로 공유해야 합니다.