Kollektiv MCP

Construye y accede a una base de conocimiento personal de LLM desde tu editor o cliente sin necesidad de configurar infraestructura.

GitHub

Prueba este MCPPatrocinado

Documentación

⚠️ OBSOLETO - Kollektiv MCP

🚨 IMPORTANTE: Este servidor MCP experimental ahora está OBSOLETO y se cerrará pronto.

Para actualizaciones, visita kollektiv.sh

Por favor, no uses este servidor para proyectos nuevos.

🧠 Tu base de conocimiento LLM personal (OBSOLETO)

[Descripción original - Ya no se mantiene] Kollektiv MCP te permite construir una base de conocimiento LLM personal en segundos y usarla desde tu editor / cliente favorito. Sin necesidad de configurar infraestructura, fragmentación ni sincronización: solo sube tus datos y comienza a chatear. Compatible con todos los principales clientes MCP de fábrica: Cursor, Windsurf, Claude Desktop, etc.

⚠️ Aviso de obsolescencia

Este servidor MCP experimental está OBSOLETO y se cerrará pronto. Los endpoints del servicio pueden dejar de funcionar en cualquier momento sin previo aviso.

No lo uses para proyectos nuevos ni para uso en producción.

💿 Conexión (OBSOLETO - PUEDE NO FUNCIONAR)

La forma más sencilla de conectarse a Kollektiv MCP es copiar y pegar la siguiente configuración en el archivo mcp.json de tu editor. Todos los clientes (Cursor, Windsurf, Claude Desktop, VSCode, PyCharm) admiten este formato json

{
  "mcpServers": {
    "kollektiv": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ]
    }
  }
}

name:
- kollektiv - puedes darle al servidor cualquier nombre descriptivo
command:
- npx - asegúrate de tener node.js instalado antes de ejecutar este comando
args:
- -y - esto permite que tu shell instale mcp-remote que actualmente se requiere para conectarse a servidores remotos
- mcp-remote - esto permite que tu cliente se conecte a un servidor MCP remoto (en este caso Kollektiv)
- https://mcp.thekollektiv.ai/mcp - es el endpoint al que te estás conectando

Mira una breve demostración a continuación o lee las instrucciones específicas del cliente sobre cómo conectarte.

Connection Demo

Cursor

Abre Cursor y ve a Cursor Settings > MCP > Add new global MCP Server. Pega la configuración anterior y guarda (ctrl/cmd+s).

Cursor Configuration

Si la configuración es exitosa y no te has autenticado antes, debería abrirse una ventana del navegador que te guíe a la página de inicio de sesión.

💡Después de guardar el json puede tomar un tiempo para que Cursor se conecte al MCP. Puede que necesites reiniciar Cursor o darle un poco de tiempo. Si ves 'Client is closed' u otros errores, seguir estos pasos de solución de problemas podría ayudar.

Si la conexión es exitosa, deberías ver Kollektiv MCP en verde en la página de configuración:

Successful Cursor connection

Windsurf

Abre Windsurf y ve a Settings -> Windsurf Settings > MCP Servers > View raw config. Pega la configuración anterior y guarda (ctrl/cmd+s).

Windsurf MCP configuration

Si la configuración es exitosa y no te has autenticado antes, debería abrirse una ventana del navegador que te guíe a la página de inicio de sesión.

💡Windsurf, a diferencia de otros clientes, en mi experiencia requiere reiniciar la aplicación para conectarse correctamente. Si el servidor no se pone en 'verde' después de un tiempo, intenta revisar los pasos de solución de problemas a continuación.

Si la conexión es exitosa, deberías ver Kollektiv MCP en verde en la página de configuración:

Successful Windsurf configuration

Claude for Desktop

Abre Claude Desktop y ve a Settings -> Developer > Edit config. Abre el archivo json en cualquier editor de texto / código, pega la configuración anterior y guarda (ctrl/cmd+s).

Claude Desktop Configuration

Si la configuración es exitosa y no te has autenticado antes, debería abrirse una ventana del navegador que te guíe a la página de inicio de sesión.

💡Claude for Desktop requiere reiniciar la aplicación para conectarse correctamente. Si el servidor no se pone en 'verde' después de un tiempo, intenta revisar los pasos de solución de problemas a continuación.

Si la conexión es exitosa, deberías ver Kollektiv MCP en verde en la página de configuración:

Successful Claude For Desktop

VS Code

Abre VS Code y ve a Settings -> MCP: Add server > Command (stdio):

command:
- npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
name:
- dale a tu servidor un nombre descriptivo como kollektiv

Tu configuración settings.json debería verse similar a esto:

{
  "chat.mcp.discovery.enabled": true,
  "chat.mcp.enabled": true,
  "mcp": {
    "servers": {
      "kollektiv": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.thekollektiv.ai/mcp"
        ]
      }
    }
  }
}

VS Code Configuration

Próximos pasos:

Haz clic en Start para conectarte al servidor MCP
- si no estás autenticado, serás llevado a la página de autenticación
Recuerda agregar "chat.mcp.enabled": true, en tu settings.json
Cambia al modo Agent

💡VS Code requiere que inicies manualmente tu servidor, agregues chat.mcp.enabled y cambies al modo Agent para usar MCP. Si no ves las herramientas MCP en el modo Agent, intenta revisar los pasos de solución de problemas a continuación.

Si la conexión es exitosa, deberías ver las herramientas expuestas por Kollektiv MCP.

Successful VS Code Connection

Cline

Abre Cline, haz clic en MCP Servers > Edit Configuration y agrega la siguiente configuración a tu cline_mcp_settings.json:

{
  "mcpServers": {
    "kollektiv": {
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ],
      "transportType": "stdio",
      "disabled": false
    }
  }
}

Nota: las conexiones directas a servidores remotos que admiten Authorization aún no son compatibles con Cline.

Si la conexión es exitosa, serás llevado al flujo de autenticación. Después de iniciar sesión, deberías ver Kollektiv MCP habilitado en Cline.

Cline Configuration

Otros (PyCharm, Claude Code)

La mayoría de los clientes MCP siguen el mismo formato .json y deberían funcionar con pasos de configuración similares a los clientes mencionados anteriormente:

Copia y pega la configuración en la configuración json de tu cliente
Reinicia la aplicación
Autentícate si aún no lo has hecho
Kollektiv MCP debería ponerse en verde y estar disponible en el modo chat / agente

El éxito de tu conexión depende de muchos factores, incluyendo pero no limitado a:

qué tan fuerte querían los desarrolladores de un cliente en particular admitir conexiones MCP
si el cliente admite la última especificación MCP con soporte Oauth

Si estás experimentando problemas, revisar estos simples pasos de solución de problemas podría ayudar.

Clientes compatibles

He validado que la conexión funciona con los siguientes clientes MCP:

Cursor ✅
Windsurf ✅
Claude Desktop ✅
VS Code ✅
Cline ✅

Otros clientes MCP deberían ser compatibles en teoría, pero en la práctica las cosas podrían ser un poco diferentes. Si tienes un cliente al que realmente quieres conectarte, ¡házmelo saber!

🎮 Uso

Herramientas disponibles

/query_documents — Envía una pregunta a los documentos que has subido a Kollektiv y recibe una respuesta basada en las fuentes de tus documentos.
/list_documents — Devuelve una lista de tus documentos sincronizados junto con metadatos básicos.
Consejo profesional: Incluye la frase "use Kollektiv MCP" para que el cliente sepa que debe llamar a estas herramientas.

Consejos de uso

Siempre agrega "use Kollektiv MCP" — Esto le dice al cliente qué servidor MCP usar.
Espera a que el documento esté Disponible — Después de la subida, toma 1–2 minutos antes de que el documento pueda ser consultado.
Reformula las consultas cuando sea necesario — Si el cliente genera una consulta deficiente, edítala o reescríbela tú mismo.

❓ Solución de problemas y soporte

Este servidor MCP usa Cloudflare Agents SDK así como otras bibliotecas para proporcionar la forma más moderna para que los usuarios se conecten y usen servidores MCP. Por otro lado, los clientes MCP aún no han implementado soporte para las 2 piezas críticas:

servidores MCP remotos
autorización de servidores MCP

En caso de que experimentes problemas de conexión, por favor revisa los siguientes pasos de solución de problemas que deberían ayudarte a conectarte al servidor MCP.

Soporte

Si necesitas soporte adicional, abre un issue en GitHub o contacta a support@thekollektiv.ai

Solución de problemas de conexión

Si estás recibiendo el error Invalid Authorization Request como se muestra a continuación o no puedes conectarte por otra razón, intenta seguir los pasos a continuación que deberían solucionar el problema.

Authorization Error

Asegúrate de conectarte al endpoint correcto:
- Usa https://mcp.thekollektiv.ai/mcp como endpoint MCP.
Limpia la caché de mcp-remote:
- Qué hace esto:
  - Elimina la caché de la biblioteca mcp-remote que se usa para conectarse al servidor remoto desde un cliente que no admite conexiones remotas
- Cómo:
  - Ejecuta el siguiente comando en tu terminal

# MacOS
rm -rf ~/.mcp-auth  

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"

Limpia los datos del navegador y las cookies:
- Qué hace esto:
  - Elimina las cookies del navegador que se usan para almacenar información de autenticación al iniciar sesión en Kollektiv.
- Cómo:
  - Abre la configuración de tu navegador y elimina los datos de navegación de las últimas horas

⚠️ Nota: esto te cerrará la sesión de todas las sesiones activas, incluida Kollektiv. Solo haz esto si estás atascado en un flujo de inicio de sesión roto.

Reinicia tu cliente MCP e intenta reconectarte al servidor MCP:
- Qué hace esto:
  - Los clientes MCP (Cursor, Windsurf, etc.) a menudo almacenan en caché la configuración de conexión / ajustes de ejecuciones anteriores que podrían interferir con la autenticación.
- Cómo:
  - Reinicia tu editor / cliente
  - Intenta reconectarte al servidor MCP

Usando MCP Inspector

Para fines de depuración, puedes usar MCP Inspector para conectarte al servidor Kollektiv MCP.

npx @modelcontextprotocol/inspector

Selecciona transporte SSE o Streamable HTTP

SSE: conéctate al servidor en https://mcp.thekollektiv.ai/sse
Streamable HTTP: conéctate al servidor en https://mcp.thekollektiv.ai/mcp

🛠️ Detalles de implementación (para los 🤓)

Si solo estás aquí por Kollektiv, omite esto. Esta sección es para desarrolladores y constructores curiosos sobre cómo funciona.

Kollektiv MCP es parte de un sistema modular que permite a los usuarios configurar RAG sobre sus datos en segundos, sin necesidad de gestionar infraestructura, pipelines o configuraciones de modelos.

Consiste en tres servicios implementados de forma independiente:

Servidor MCP (Cloudflare Worker)
https://mcp.thekollektiv.ai
Actúa como una puerta de enlace segura para que los clientes interactúen con datos indexados a través del Protocolo de Contexto de Modelo. Admite OAuth.
Frontend (React + Vite Worker)
https://thekollektiv.ai
Una interfaz de usuario limpia y mínima para subir y gestionar su contenido.
Backend (FastAPI)
https://api.thekollektiv.ai
Maneja la ingesta de fuentes, validación y orquestación de un pipeline RAG.

🔐 Seguridad

Kollektiv MCP implementa varias medidas de seguridad:

El inicio de sesión ocurre a través del flujo estándar OAuth 2.1 "Authorization Code" impulsado por Supabase; solo se almacenan cookies de corta duración, HttpOnly, Secure — ninguna contraseña toca este servidor.
Todo el tráfico se sirve exclusivamente a través de HTTPS mediante el edge de Cloudflare, y cada solicitud POST sensible lleva un token CSRF/transacción de un solo uso.
El backend se ejecuta dentro del sandbox de Cloudflare Workers (sin sistema de archivos local, sin procesos de larga duración), reduciendo drásticamente la superficie de ataque.

Para pautas de divulgación detalladas, consulta SECURITY.md.

🪪 Licencia

Publicado bajo la Licencia Apache 2.0 — soporte comercial o licencias alternativas: azuev@outlook.com