Graphlit

Graphlit 플랫폼을 위한 모델 컨텍스트 프로토콜 (MCP) 서버

개요

모델 컨텍스트 프로토콜 (MCP) 서버는 MCP 클라이언트와 Graphlit 서비스 간의 통합을 가능하게 합니다. 이 문서는 설정 과정을 설명하고 클라이언트 사용의 기본 예시를 제공합니다.

Slack, Discord, 웹사이트, Google Drive, 이메일, Jira, Linear 또는 GitHub에서 무엇이든 Graphlit 프로젝트로 수집한 다음, Cursor, Windsurf, Goose 또는 Cline과 같은 MCP 클라이언트 내에서 관련 지식을 검색하고 조회할 수 있습니다.

Graphlit 프로젝트는 모든 개발자 및 제품 관리 도구 전반에 걸쳐 검색 가능하고 RAG 준비가 된 지식 베이스 역할을 합니다.

문서(PDF, DOCX, PPTX 등)와 HTML 웹 페이지는 수집 시 Markdown으로 추출됩니다. 오디오 및 비디오 파일은 수집 시 텍스트로 변환됩니다.

웹 크롤링 및 웹 검색이 MCP 도구로 내장되어 있어 Firecrawl, Exa 등과 같은 다른 도구를 별도로 통합할 필요가 없습니다.

MCP 서버 사용 사례와 기능에 대한 자세한 내용은 블로그에서 확인할 수 있습니다.

Goose MCP 클라이언트와 함께 Graphlit MCP 서버를 사용하는 방법에 대한 최신 YouTube 동영상을 시청하세요.

MCP 서버 사용에 관한 질문이 있으시면 Discord 커뮤니티에 참여하여 #mcp 채널에 게시해 주세요.

도구

조회

• 콘텐츠 쿼리
• 컬렉션 쿼리
• 피드 쿼리
• 대화 쿼리
• 관련 소스 조회
• 유사 이미지 조회
• 이미지 시각적 설명

RAG

• LLM 대화 프롬프트

추출

• 텍스트에서 구조화된 JSON 추출

퍼블리싱

• 오디오로 퍼블리싱 (ElevenLabs 오디오)
• 이미지로 퍼블리싱 (OpenAI 이미지 생성)

수집

• 파일
• 웹 페이지
• 메시지
• 게시물
• 이메일
• 이슈
• 텍스트
• 메모리 (단기)

데이터 커넥터

• Microsoft Outlook 이메일
• Google Mail
• Notion
• Reddit
• Linear
• Jira
• GitHub Issues
• Google Drive
• OneDrive
• SharePoint
• Dropbox
• Box
• GitHub
• Slack
• Microsoft Teams
• Discord
• Twitter/X
• 팟캐스트 (RSS)

웹

• 웹 크롤링
• 웹 검색 (팟캐스트 검색 포함)
• 웹 매핑
• 페이지 스크린샷

알림

• Slack
• 이메일
• Webhook
• Twitter/X

작업

• 프로젝트 구성
• 컬렉션 생성
• 컬렉션에 콘텐츠 추가
• 컬렉션에서 콘텐츠 제거
• 컬렉션 삭제
• 피드 삭제
• 콘텐츠 삭제
• 대화 삭제
• 피드 완료 여부 확인
• 콘텐츠 완료 여부 확인

열거

• Slack 채널 목록
• Microsoft Teams 팀 목록
• Microsoft Teams 채널 목록
• SharePoint 라이브러리 목록
• SharePoint 폴더 목록
• Linear 프로젝트 목록
• Notion 데이터베이스 목록
• Notion 페이지 목록
• Dropbox 폴더 목록
• Box 폴더 목록
• Discord 길드 목록
• Discord 채널 목록
• Google 캘린더 목록
• Microsoft 캘린더 목록

리소스

• 프로젝트
• 콘텐츠
• 피드
• 컬렉션 (콘텐츠의)
• 워크플로우
• 대화
• 사양

사전 준비 사항

시작하기 전에 다음 사항을 확인하세요:

• 시스템에 Node.js가 설치되어 있어야 합니다 (권장 버전 18.x 이상).
• API 설정 대시보드에 접근할 수 있는 Graphlit 플랫폼의 활성 계정.

구성

Graphlit MCP 서버는 인증 및 구성을 위해 설정할 수 있는 환경 변수를 지원합니다:

• GRAPHLIT_ENVIRONMENT_ID: 환경 ID.
• GRAPHLIT_ORGANIZATION_ID: 조직 ID.
• GRAPHLIT_JWT_SECRET: JWT 토큰 서명을 위한 JWT 시크릿.

이 값들은 Graphlit 플랫폼의 API 설정 대시보드에서 확인할 수 있습니다.

설치

VS Code를 통한 설치

빠른 설치를 위해 아래의 원클릭 설치 버튼 중 하나를 사용하세요:

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P을 누르고 Preferences: Open User Settings (JSON)을 입력하여 이 작업을 수행할 수 있습니다.

선택적으로, 워크스페이스의 .vscode/mcp.json이라는 파일에 추가할 수도 있습니다. 이렇게 하면 다른 사람과 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에는 mcp 키가 필요하지 않습니다.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "organization_id",
        "description": "Graphlit Organization ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "environment_id",
        "description": "Graphlit Environment ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "jwt_secret",
        "description": "Graphlit JWT Secret",
        "password": true
      }
    ],
    "servers": {
      "graphlit": {
        "command": "npx",
        "args": ["-y", "graphlit-mcp-server"],
        "env": {
          "GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}",
          "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}",
          "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}"
        }
      }
    }
  }
}

Windsurf를 통한 설치

Windsurf IDE 애플리케이션에 graphlit-mcp-server를 설치하려면 Cline이 NPX를 사용해야 합니다:

npx -y graphlit-mcp-server

mcp_config.json 파일은 다음과 유사하게 구성되어야 합니다:

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Cline을 통한 설치

Cline IDE 애플리케이션에 graphlit-mcp-server를 설치하려면 Cline이 NPX를 사용해야 합니다:

npx -y graphlit-mcp-server

cline_mcp_settings.json 파일은 다음과 유사하게 구성되어야 합니다:

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Cursor를 통한 설치

Cursor IDE 애플리케이션에 graphlit-mcp-server를 설치하려면 Cursor가 NPX를 사용해야 합니다:

npx -y graphlit-mcp-server

mcp.json 파일은 다음과 유사하게 구성되어야 합니다:

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 graphlit-mcp-server를 자동으로 설치하려면:

npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude

수동 설치

모든 MCP 클라이언트 애플리케이션에서 Graphlit MCP 서버를 사용하려면 다음을 사용하세요:

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

선택적으로 Slack, Google Email, Notion과 같은 데이터 커넥터의 자격 증명을 구성할 수 있습니다. GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID 및 GRAPHLIT_JWT_SECRET만 필수입니다.

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
                "SLACK_BOT_TOKEN": "your-slack-bot-token",
                "DISCORD_BOT_TOKEN": "your-discord-bot-token",
                "TWITTER_TOKEN": "your-twitter-token",
                "GOOGLE_EMAIL_REFRESH_TOKEN": "your-google-refresh-token",
                "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id",
                "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret",
                "LINEAR_API_KEY": "your-linear-api-key",
                "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat",
                "JIRA_EMAIL": "your-jira-email",
                "JIRA_TOKEN": "your-jira-token",
                "NOTION_API_KEY": "your-notion-api-key"
            }
        }
    }
}

참고: Windows에서 'npx'를 실행할 때는 명령 프롬프트를 통해 명시적으로 npx를 호출해야 할 수 있습니다.

"command": "C:\\Windows\\System32\\cmd.exe /c npx"

지원

Graphlit API 문서를 참조하세요.

Graphlit MCP 서버에 대한 지원이 필요하면 GitHub 이슈를 제출해 주세요.

Graphlit 플랫폼에 대한 추가 지원은 Discord 커뮤니티에 참여해 주세요.