Lucid MCP 서버를 사용하여 Lucid를 AI 도구와 통합하세요

Lucid에 AI 툴 연결

Lucid 팀 또는 기업 계정을 사용 중이라면 먼저 Lucid 관리자가 MCP 액세스 활성화를 해야 합니다. AI 툴 관리자 또한 해당 AI 툴 설정 내에서 통합을 승인해야 할 수 있습니다.

Lucid MCP 서버는 모든 MCP 클라이언트와 호환됩니다. Lucid를 일반적인 AI 툴에 연결하는 방법에 대한 자세한 내용은 아래에 링크된 마켓플레이스 목록 및 문서를 참조하세요.

• Claude 
  • 이 Claude 디렉터리 등록 정보를 사용하여 커넥터를 설치합니다.
  • 자세한 설정 단계는 Lucid를 Claude에 연결 문서에서 확인하세요.
• Claude Code

  • Claude Code에 연결하려면 터미널에서 아래 코드를 실행한 다음, Claude Code에서 /mcp를 실행하여 Lucid 권한을 부여합니다.

    claude mcp add --transport http lucid 
    https://mcp.lucid.app/mcp

• Cursor
  • 이 Cursor의 마켓플레이스 등록 정보를 사용하여 커넥터를 설치합니다.
  • 자세한 설정 단계는 Lucid를 Cursor에 연결 문서를 참조하세요.
• ChatGPT 또는 Codex
  • 이 ChatGPT 플러그인 목록을 사용하여 커넥터를 설치하세요.
  • 자세한 설정 단계는 Lucid를 ChatGPT 또는 Codex에 연결 문서를 참조하세요.
• GitHub 또는 VS Code Copilot
  • 이 GitHub MCP 레지스트리 등록 정보를 사용하여 커넥터를 설치합니다.
  • 자세한 설정 단계는 Lucid를 VS Code Copilot에 연결 문서에서 확인하세요.
• Slack
  • 이 Slack 마켓플레이스 등록 정보를 사용하여 커넥터를 설치합니다.
  • 자세한 설정 단계는 Lucid를 Slackbot에 연결 문서에서 확인해 보세요.
• Glean
  • 이 Glean 커넥터 목록을 사용하여 커넥터를 설치하세요.

기타 MCP 클라이언트

Lucid MCP 서버는 여기에 나열된 툴뿐만 아니라 MCP를 지원하는 모든 툴 또는 게이트웨이에 연결할 수 있습니다. 일반적인 예는 다음과 같습니다.

• Microsoft Copilot Studio
• GitHub Copilot CLI
• Gemini CLI
• Devin

기업 게이트웨이

• Cequence AI Gateway
• Natoma

사용하는 AI 툴이 위 목록에 없으면 아래 서버 URL과 JSON 구성을 사용하여 수동으로 연결을 설정하세요.

서버 URL 및 JSON 구성

서버 URL

Lucid MCP 서버는 아래 나열된 클라이언트를 포함하여 모든 MCP 클라이언트와 호환됩니다. 설정 과정은 사용하는 클라이언트에 따라 다르지만, Lucid MCP를 설정하는 데 필요한 서버 URL은 동일합니다.

• https://mcp.lucid.app/mcp
  • 이 URL은 브라우저에서 방문하기 위한 것이 아닙니다. AI 툴을 Lucid의 MCP 서버에 연결할 때 사용하는 매개변수입니다.

Lucid는 보안 요구 사항과 AI 도구에 부여하려는 데이터 접근 권한에 따라 다양한 MCP 서버 구성을 제공합니다:

• Lucid 저장소 MCP 서버: 프로세스 액셀러레이터 저장소의 콘텐츠만 참조하려면 이 서버에 연결하세요.
  • https://mcp.lucid.app/mcp/repositories
• Lucid 읽기 전용 MCP 서버: AI 도구에 Lucid 데이터에 대한 검색 및 보기 전용 권한을 제공합니다.
  • https://mcp.lucid.app/mcp/readonly

JSON 구성 요구 사항

일부 AI 도구는 MCP 서버에 연결하려면 JSON 구성 파일을 직접 편집해야 할 수 있습니다.

AI 도구가 HTTP 전송 방식을 지원하는 경우 이 JSON 구성을 사용하세요:

"Lucid Software": {
"type": "http",
"url": "https://mcp.lucid.app/mcp"
}

AI 툴이 HTTP 전송 방식을 지원하지 않는 경우 HTTP 요청을 Lucid의 MCP 서버로 전달하는 로컬 서버를 실행해야 합니다. 이는 mcp-remote Node.js 패키지를 사용하여 수행할 수 있습니다. 컴퓨터에 Node.js가 설치되어 있는지 확인한 후 다음 JSON 구성을 사용하세요.

"Lucid Software": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.lucid.app/mcp"]
}

API 키로 인증하기

Lucid MCP 서버는 기본적으로 OAuth를 사용하므로 AI 툴이 처음 연결될 때 사용자가 액세스를 승인해야 합니다. 해당 승인을 해줄 사람이 없는 상태에서 실행되는 자동 프로세스의 경우, 팀 및 기업 사용자는 대신 API 키를 사용하여 인증할 수 있습니다. API 키를 사용한 인증을 설정하려면 다음 단계를 따르세요.

1. Lucid 개발자 포털에서 API 키를 생성하세요.
2. 인증에 API 키를 사용하도록 MCP 클라이언트를 설정하세요.
3. MCP 클라이언트는 해당 키에 부여된 권한을 사용하여 자동으로 인증하며, 런타임 시 별도의 로그인이나 승인 프롬프트가 필요하지 않습니다.

관리자용: 계정의 MCP 서버 사용 활성화 또는 비활성화

팀 계정과 기업 계정의 관리자는 계정 사용자들에게 Lucid MCP 서버 액세스 부여 여부를 제어할 수 있습니다.

계정에서 MCP 액세스를 활성화하거나 비활성화하려면 다음 단계를 따르세요.

Lucid MCP 서버에서 사용할 수 있는 작업

Lucid MCP 서버 설정이 완료되면 AI 툴에 프롬프트를 입력하여 Lucid에서 다양한 작업을 할 수 있습니다. Lucid MCP 서버에 더 많은 사용 사례가 추가됨에 따라 새로운 기능을 사용하려면 AI 툴에서 다시 인증해야 할 수도 있습니다.

현재 다음과 같은 사용 사례가 지원됩니다:

Lucid MCP 서버 문제 해결

AI 툴의 커넥터 목록에 Lucid가 표시되지 않습니다. 
팀 및 기업 Lucid 계정의 경우 관리자가 먼저 MCP 액세스를 활성화해야 합니다. AI 툴이 조직 전체 요금제에 속해 있는 경우 해당 측 관리자도 연결을 승인해야 할 수 있습니다.

AI 툴을 Lucid에 연결했지만 문서를 찾을 수 없습니다.
Lucid MCP 서버는 사용자가 열 수 있는 권한이 있는 문서에만 접근할 수 있으며, Lucid 계정 외부 사용자가 소유한 문서는 볼 수 없습니다. 먼저 Lucid에서 문서를 열 수 있는지 확인하세요.

새로운 Lucid MCP 서버 기능이 발표되었지만, 내 AI 툴에서는 작동하지 않습니다. 
새로운 기능을 사용하려면 새로 인증을 받아야 합니다. AI 툴에서 Lucid 커넥터를 연결 해제한 다음 다시 연결하세요.

연결이 중단되었습니다. 
Lucid 관리자가 MCP 액세스를 차단했거나 인증 세션이 만료되었을 수 있습니다. AI 툴에서 Lucid 커넥터를 다시 연결하세요. 그래도 연결이 되지 않으면 Lucid 관리자에게 문의하세요.

자주 하는 질문(FAQ)

Lucid MCP 서버는 어떻게 작동하나요?
Lucid MCP 서버는 https://mcp.lucid.app/mcp에서 사용할 수 있는 원격 서비스입니다. 스트리밍 가능한 HTTP 전송 프로토콜, 클라이언트 ID 메타데이터 문서(CIMD), 동적 클라이언트 등록(DCR)을 사용하여 클라이언트 액세스를 안전하게 관리합니다. 인증은 OAuth 2.0을 통해 처리되므로 Lucid 사용자가 MCP 서버를 승인하여 AI 툴과 통합할 수 있습니다. 설정 중에 사용자는 다음과 같이 서로 다른 두 가지 승인 단계를 완료합니다.

• 서버 인증: Lucid MCP 서버를 신뢰할 수 있는 서비스로 확인하고 등록합니다.
• 권한 범위 승인: MCP 서버에 Lucid 제품 내 사용자 문서, 데이터 및 계정 작업에 대한 액세스 권한을 부여합니다.

Lucid MCP 서버가 사용자의 계정 또는 데이터와 상호 작용하기 전에 인증과 범위 승인이 모두 필요합니다.

Lucid MCP 서버가 프로세스 액셀러레이터 저장소에서 정보를 가져올 수 있나요?

Lucid MCP 서버는 프로세스 액셀러레이터 저장소의 정보에 접근할 수 있지만, 저장소 문서에만 국한되지는 않습니다.  하지만 Lucid 저장소 MCP 서버 는 검색 도구가 저장소만 검색하고 저장소 문서를 가져오도록 제한합니다.

기업 관리자가 특정 AI 클라이언트에 대한 액세스를 제한할 수 있나요?
Lucid MCP 서버에 대한 액세스 권한을 부여하면 사용자가 모든 AI 클라이언트에 연결할 수 있습니다. 계정에서 특정 AI 툴에 대한 액세스를 제한해야 하는 경우 계정 수준에서 MCP를 비활성화해야 합니다.

Lucid MCP 서버는 어떤 정보에 액세할 수 있나요?
Lucid MCP 서버는 계정 내에서 액세스 권한이 있는 모든 Lucid 문서(제목, 내용, 코멘트, 메타데이터 포함)에 액세스할 수 있습니다. 단, 계정 외부 사용자가 소유하거나 생성한 문서에는 접근할 수 없습니다.

Lucid MCP 서버는 내 데이터를 어떻게 사용하나요?
Lucid MCP 서버는 단순 중계 역할만 수행하며, 문서 내용이나 사용자 프롬프트, 쿼리를 저장하지 않습니다. 사용자의 자격 증명은 Lucid 계정 외부로 절대 공유되지 않습니다. Lucid MCP 서버 사용은 당사자 간에 체결된 서비스 계약 또는 https://lucid.co/tos에서 확인할 수 있는 Lucid의 표준 서비스 약관을 따릅니다.

Lucid MCP 서버로 어떤 유형의 다이어그램을 만들 수 있나요? 
Lucid MCP 서버는 플로우차트, 조직도, 시퀀스 다이어그램, 개체 관계 다이어그램 등 Lucid에서 지원하는 모든 유형의 다이어그램을 생성할 수 있습니다. 

서버에서 데이터를 기반으로 다이어그램을 자동으로 생성할 수는 있지만(예: 직원 목록을 조직도로 변환), 정적 버전만 생성합니다. 소스 데이터가 변경될 때 자동으로 업데이트되는 데이터 연동 다이어그램은 생성할 수 없습니다. 

Lucid MCP 서버는 표준 텍스트-AI 연결과 어떻게 다른가요?
MCP 서버는 복잡한 다이어그램과 텍스트를 LLM용으로 설계된 구조로 변환하는 문서 처리 형식을 사용합니다. 따라서 요약을 요청하면 AI는 표준 텍스트-AI 연결보다 문서 내 계층 구조와 관계를 더 잘 이해합니다.

내 계정의 사용자가 Lucid MCP 서버에 연결하는 시점을 추적할 방법이 있나요? 
예. 계정에 Enterprise Shield 추가 기능이 있는 경우 가능합니다. 사용자가 Lucid MCP 서버를 통해 AI 도구를 인증하거나 다시 인증할 때마다 Lucid는 클라이언트 이름과 연결 세부 정보가 포함된 감사 이벤트를 기록합니다. 더 자세한 정보는 Enterprise Shield 추가 기능 개요 문서에서 확인할 수 있습니다.

리소스

이 기능에 관한 더 자세한 정보는 아래의 추가 자료에서 살펴볼 수 있습니다. 리소스는 영어로만 제공됩니다.

커뮤니티 게시물

Lucid 모델 컨텍스트 프로토콜(MCP) 서버 소개

외부 리소스

MCP 서버에 대해 자세히 알아보려면 이 외부 문서를 확인하세요:

• 모델 컨텍스트 프로토콜(MCP)이란 무엇인가요?

이 문서에 관한 피드백 공유