Kollektiv | Your private LLM knowledgebase

콜렉티브 MCP

🧠 개인 LLM 지식 기반

Kollektiv MCP를 사용하면 몇 초 만에 개인 LLM 지식 기반을 구축하고 원하는 편집자/클라이언트에서 사용할 수 있습니다. 더 이상 인프라 설정, 청킹, 동기화가 필요 없습니다. 데이터를 업로드하고 채팅을 시작하기만 하면 됩니다. Cursor, Windsurf, Claude Desktop 등 모든 주요 MCP 클라이언트를 기본적으로 지원합니다.

🧪 Kollektiv는 초기 베타 버전입니다. MCP 클라이언트 연결에 문제가 발생하면 먼저 다음 단계 를 시도해 보세요. 그래도 문제가 해결되지 않으면 여기에 문제를 제기해 주세요.

💿 연결

Kollektiv MCP에 연결하는 가장 간단한 방법은 다음 구성을 편집기의 mcp.json 파일에 복사하여 붙여넣는 것입니다. 모든 클라이언트(Cursor, Windsurf, Claude Desktop, VSCode, PyCharm)는 이 json 형식을 지원합니다.

지엑스피1

• 이름:
  • kollektiv - 서버에 설명적인 이름을 지정할 수 있습니까?
• 명령:
  • npx - 이 명령을 실행하기 전에 node.js가 설치되어 있는지 확인하세요.
• 인수:
  • -y - 이를 통해 쉘은 현재 원격 서버에 연결하는 데 필요한 mcp-remote 설치할 수 있습니다.
  • mcp-remote - 이를 통해 클라이언트가 원격 MCP 서버(이 경우 Kollektiv)에 연결할 수 있습니다.
  • https://mcp.thekollektiv.ai/mcp - 연결하려는 엔드포인트입니다.

아래의 짧은 데모를 확인하거나 고객별 지침을 읽어보세요.

커서

커서를 열고 Cursor Settings > MCP > Add new global MCP Server 로 이동합니다. 위 구성을 붙여넣고 저장합니다(ctrl/cmd+s).

구성이 성공했고 이전에 인증한 적이 없다면 브라우저 창이 열리고 로그인 페이지로 이동합니다.

json 저장한 후 Cursor가 MCP에 연결하는 데 시간이 걸릴 수 있습니다. Cursor를 다시 시작하거나 잠시 기다려야 할 수도 있습니다. '클라이언트가 닫혔습니다' 또는 기타 오류가 표시되면 다음 문제 해결 단계를 수행하면 도움이 될 수 있습니다.

연결이 성공하면 설정 페이지에서 Kollektiv MCP가 녹색으로 바뀌는 것을 볼 수 있습니다.

윈드서핑

Windsurf를 열고 Settings -> Windsurf Settings > MCP Servers > View raw config 로 이동합니다. 위 구성을 붙여넣고 저장합니다(ctrl/cmd+s).

구성이 성공했고 이전에 인증한 적이 없다면 브라우저 창이 열리고 로그인 페이지로 이동합니다.

💡Windsurf는 다른 클라이언트와 달리 제 경험상 제대로 연결하려면 앱을 다시 시작해야 합니다. 잠시 후에도 서버가 '녹색'으로 바뀌지 않으면 아래 문제 해결 단계를 시도해 보세요.

연결이 성공하면 설정 페이지에서 Kollektiv MCP가 녹색으로 바뀌는 것을 볼 수 있습니다.

데스크톱용 클로드

Claude Desktop을 열고 Settings -> Developer > Edit config 으로 이동합니다. 텍스트/코드 편집기에서 json 파일을 열고 위 구성을 붙여넣은 후 저장합니다(ctrl/cmd+s).

구성이 성공했고 이전에 인증한 적이 없다면 브라우저 창이 열리고 로그인 페이지로 이동합니다.

💡데스크톱용 Claude를 사용하려면 앱을 다시 시작해야 제대로 연결됩니다. 잠시 후에도 서버가 '녹색'으로 바뀌지 않으면 아래 문제 해결 단계를 시도해 보세요.

연결이 성공하면 설정 페이지에서 Kollektiv MCP가 녹색으로 바뀌는 것을 볼 수 있습니다.

VS 코드

VS Code를 열고 Settings -> MCP: Add server > Command (stdio) 으로 이동합니다.

• 명령:
  • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
• 이름:
  • 서버에 kollektiv 와 같은 설명적인 이름을 지정하세요.

구성 settings.json 은 다음과 유사해야 합니다.

다음 단계:

• 시작을 클릭하여 MCP 서버에 연결합니다.
  • 인증되지 않은 경우 인증 페이지로 이동합니다.
• settings.json 에 "chat.mcp.enabled": true,
• 에이전트 모드로 전환

💡VS Code에서는 MCP를 사용하려면 서버를 수동으로 시작 하고 chat.mcp.enabled 추가한 후 에이전트 모드로 전환해야 합니다. 에이전트 모드에서 MCP 도구가 표시되지 않으면 아래 문제 해결 단계를 시도해 보세요.

연결에 성공하면 Kollektiv MCP에서 제공하는 도구가 표시됩니다.

클라인

Cline을 열고 MCP Servers > Edit Configuration 클릭한 후 다음 구성을 cline_mcp_settings.json 에 추가합니다.

참고: 인증을 지원하는 원격 서버에 대한 직접 연결은 아직 Cline에서 지원되지 않습니다.

연결이 성공하면 인증 절차로 이동합니다. 로그인 후 Cline에서 Kollektiv MCP가 활성화된 것을 확인할 수 있습니다.

기타(PyCharm, Claude Code)

대부분의 MCP 클라이언트는 동일한 .json 형식을 따르며 이전에 언급한 클라이언트와 유사한 구성 단계로 작동해야 합니다.

1. 클라이언트의 json 구성에 구성을 복사하여 붙여넣습니다.
2. 앱을 다시 시작하세요
3. 아직 인증하지 않았다면 인증하세요
4. Kollektiv MCP는 친환경적으로 바뀌어야 하며 채팅/에이전트 모드에서 사용할 수 있어야 합니다.

연결의 성공은 다음을 포함하되 이에 국한되지 않는 여러 요인에 따라 달라집니다.

• 특정 클라이언트의 강력한 개발자가 MCP 연결을 지원하기를 원하는 방식
• 클라이언트가 Oauth 지원과 함께 최신 MCP 사양을 지원하는지 여부

문제가 발생하는 경우, 다음의 간단한 문제 해결 단계를 거치면 도움이 될 수 있습니다.

지원되는 클라이언트

다음 MCP 클라이언트에 대한 연결이 작동하는지 검증했습니다.

• 커서 ✅
• 윈드서핑 ✅
• 클로드 데스크탑 ✅
• VS 코드 ✅
• 클라인 ✅

다른 MCP 클라이언트도 이론적으로는 지원 될 수 있지만 , 실제로는 상황이 약간 다를 수 있습니다. 꼭 연결하고 싶은 클라이언트가 있다면 알려주세요!

🎮 사용법

사용 가능한 도구

• /query_documents — Kollektiv에 업로드한 문서에 대한 질문을 제출하면 문서의 출처를 기반으로 답변을 받습니다.
• /list_documents — 기본 메타데이터와 함께 동기화된 문서 목록을 반환합니다.
• 전문가 팁: "Kollektiv MCP 사용"이라는 문구를 포함시켜 클라이언트가 이 도구를 호출하도록 하세요.

사용 팁

• 항상 "Kollektiv MCP 사용"을 추가합니다 . 이는 클라이언트에게 어떤 MCP 서버를 사용해야 하는지 알려줍니다.
• 문서가 사용 가능할 때까지 기다리세요 . 업로드 후 문서를 쿼리할 수 있을 때까지 1~2분이 걸립니다.
• 필요한 경우 쿼리를 다시 작성하세요 . 클라이언트가 생성한 쿼리가 만족스럽지 않으면 직접 편집하거나 다시 작성하세요.

❓ 문제 해결 및 지원

이 MCP 서버는 Cloudflare Agents SDK 및 기타 라이브러리를 사용하여 사용자가 MCP 서버에 연결하고 사용할 수 있는 가장 현대적인 방법을 제공합니다. 반면 MCP 클라이언트는 아직 다음 두 가지 핵심 기능에 대한 지원을 구현하지 않았습니다.

• 원격 MCP 서버
• MCP 서버 권한 부여

연결 문제가 발생할 경우 다음 문제 해결 단계를 따라 MCP 서버에 연결하세요.

지원하다

추가 지원이 필요하면 GitHub 이슈를 열거나 support@thekollektiv.ai 로 문의하세요.

연결 문제 해결

아래와 같이 잘못된 권한 요청 오류가 발생하거나 다른 이유로 연결할 수 없는 경우 아래 단계를 따라 문제를 해결해보세요.

1. 올바른 엔드포인트에 연결했는지 확인하세요 .
   • MCP 엔드포인트로 https://mcp.thekollektiv.ai/mcp 사용합니다.
2. mcp-remote 캐시 정리 :
   • 이것이 하는 일:
     • 원격 연결을 지원하지 않는 클라이언트에서 원격 서버에 연결하는 데 사용되는 mcp-remote 라이브러리의 캐시를 제거합니다.
   • 어떻게:
     • 터미널에서 다음 명령을 실행하세요.

3. 브라우저 데이터 및 쿠키를 지우세요 .
   • 이것이 하는 일:
     • Kollektiv에 로그인할 때 인증 정보를 저장하는 데 사용되는 브라우저 쿠키를 제거합니다.
   • 어떻게:
     • 브라우저 설정을 열고 지난 몇 시간 동안의 검색 데이터를 삭제하세요.

⚠️ 참고: 이 작업을 수행하면 Kollektiv를 포함한 모든 활성 세션에서 로그아웃됩니다. 로그인 흐름이 제대로 작동하지 않는 경우에만 이 작업을 수행하세요.

4. MCP 클라이언트를 다시 시작하고 MCP 서버에 다시 연결을 시도하세요.
   • 이것이 하는 일:
     • MCP 클라이언트(Cursor, Windsurf 등)는 이전 실행의 연결/구성 설정을 캐시하는 경우가 많은데, 이는 인증을 방해할 수 있습니다.
   • 어떻게:
     • 편집기/클라이언트를 다시 시작하세요
     • MCP 서버에 다시 연결해보세요

MCP Inspector 사용

디버깅 목적으로 MCP Inspector를 사용하여 Kollektiv MCP 서버에 연결할 수 있습니다.

SSE 또는 Streamable HTTP 전송을 선택하세요

• SSE: https://mcp.thekollektiv.ai/sse 의 서버에 연결합니다.
• 스트리밍 가능한 HTTP: https://mcp.thekollektiv.ai/mcp 의 서버에 연결하세요

🛠️ 구현 세부 정보(🤓용)

Kollektiv만 보려고 오신 거라면 이 부분은 건너뛰세요. 이 섹션은 Kollektiv의 작동 방식이 궁금한 개발자와 개발자를 위한 것입니다.

Kollektiv MCP는 사용자가 인프라, 파이프라인 또는 모델 구성을 관리할 필요 없이 몇 초 만에 데이터에 대한 RAG를 설정할 수 있게 해주는 모듈식 시스템의 일부입니다.

이는 독립적으로 배포되는 세 가지 서비스로 구성됩니다.

• MCP 서버(Cloudflare Worker)
  https://mcp.thekollektiv.ai
  클라이언트가 모델 컨텍스트 프로토콜을 통해 인덱스된 데이터와 상호 작용할 수 있는 보안 게이트웨이 역할을 합니다. OAuth를 지원합니다.
• 프런트엔드(React + Vite Worker)
  https://thekollektiv.ai
  콘텐츠를 업로드하고 관리하기 위한 깔끔하고 최소한의 사용자 인터페이스입니다.
• 백엔드(FastAPI)
  https://api.thekollektiv.ai
  RAG 파이프라인의 소스 수집, 검증 및 오케스트레이션을 처리합니다.

🔐 보안

Kollektiv MCP는 여러 가지 보안 조치를 구현합니다.

• 로그인은 Supabase가 제공하는 표준 OAuth 2.1 "인증 코드" 흐름을 통해 이루어집니다. 단기간 동안만 사용되는 HttpOnly``Secure 쿠키만 저장됩니다. 비밀번호는 이 서버에 절대 접근하지 않습니다.
• 모든 트래픽은 Cloudflare의 edge를 통해 HTTPS로만 제공되며, 모든 민감한 POST 요청에는 일회성 CSRF/트랜잭션 토큰이 전달됩니다.
• 백엔드는 Cloudflare Workers 샌드박스 내부에서 실행되므로(로컬 파일 시스템 없음, 장기 실행 프로세스 없음) 공격 표면이 크게 줄어듭니다.자세한 공개 지침은 SECURITY.md를 참조하세요.

🪪 라이센스

Apache License 2.0에 따라 출시됨 - 상업적 지원 또는 대체 라이선스: azuev@outlook.com