Kollektiv MCP

Construa e acesse uma base de conhecimento pessoal para LLM diretamente do seu editor ou cliente, sem necessidade de configurar infraestrutura.

GitHub
61
Experimente este MCPPatrocinado

Documentação

⚠️ OBSOLETO - Kollektiv MCP

🚨 IMPORTANTE: Este servidor MCP experimental está agora OBSOLETO e será desativado em breve.

Para atualizações, visite kollektiv.sh

Por favor, não use este servidor para novos projetos.

TypeScript Runtime Auth Supabase Build codecov License

🧠 Sua base de conhecimento LLM pessoal (OBSOLETO)

[Descrição Original - Não mantida mais] Kollektiv MCP permite que você crie uma base de conhecimento LLM pessoal em segundos e a use a partir do seu editor / cliente favorito. Sem necessidade de configuração de infraestrutura, chunking, sincronização - basta enviar seus dados e começar a conversar. Suporta todos os principais clientes MCP prontos para uso - Cursor, Windsurf, Claude Desktop, etc.

⚠️ Aviso de Obsolescência

Este servidor MCP experimental está OBSOLETO e será desativado em breve. Os endpoints do serviço podem parar de funcionar a qualquer momento sem aviso prévio.

Não use isso para novos projetos ou uso em produção.

💿 Conexão (OBSOLETO - PODE NÃO FUNCIONAR)

A maneira mais simples de conectar ao Kollektiv MCP é copiar e colar a seguinte configuração no arquivo mcp.json do seu editor. Todos os clientes (Cursor, Windsurf, Claude Desktop, VSCode, PyCharm) suportam este formato json

{
  "mcpServers": {
    "kollektiv": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ]
    }
  }
}
  • name:
    • kollektiv - você pode dar ao servidor qualquer nome descritivo
  • command:
    • npx - certifique-se de ter o node.js instalado antes de executar este comando
  • args:
    • -y - isso permite que seu shell instale mcp-remote que atualmente é necessário para conectar a servidores remotos
    • mcp-remote - isso permite que seu cliente se conecte a um servidor MCP remoto (neste caso Kollektiv)
    • https://mcp.thekollektiv.ai/mcp - é o endpoint ao qual você está se conectando

Confira uma demonstração curta abaixo ou leia instruções específicas do cliente sobre como conectar.

Connection Demo

Cursor

Abra o Cursor e vá para Cursor Settings > MCP > Add new global MCP Server. Cole a configuração acima e salve (ctrl/cmd+s).

Cursor Configuration

Se a configuração for bem-sucedida e você não tiver autenticado antes, uma janela do navegador deve abrir guiando você para a página de login.

💡Após salvar o json, pode levar um tempo para o Cursor conectar ao MCP. Você pode precisar reiniciar o Cursor ou dar um pouco de tempo. Se você vir 'Client is closed' ou outros erros, seguir estas etapas de solução de problemas pode ajudar.

Se a conexão for bem-sucedida, você deve ver o Kollektiv MCP ficar verde na página de configurações:

Successful Cursor connection

Windsurf

Abra o Windsurf e vá para Settings -> Windsurf Settings > MCP Servers > View raw config. Cole a configuração acima e salve (ctrl/cmd+s).

Windsurf MCP configuration

Se a configuração for bem-sucedida e você não tiver autenticado antes, uma janela do navegador deve abrir guiando você para a página de login.

💡Windsurf, ao contrário de outros clientes, na minha experiência requer uma reinicialização do aplicativo para conectar corretamente. Se o servidor não ficar 'verde' após um tempo, tente revisar as etapas de solução de problemas abaixo.

Se a conexão for bem-sucedida, você deve ver o Kollektiv MCP ficar verde na página de configurações:

Successful Windsurf configuration

Claude for Desktop

Abra o Claude Desktop e vá para Settings -> Developer > Edit config. Abra o arquivo json em qualquer editor de texto / código, cole a configuração acima e salve (ctrl/cmd+s).

Claude Desktop Configuration

Se a configuração for bem-sucedida e você não tiver autenticado antes, uma janela do navegador deve abrir guiando você para a página de login.

💡Claude for Desktop requer uma reinicialização do aplicativo para conectar corretamente. Se o servidor não ficar 'verde' após um tempo, tente revisar as etapas de solução de problemas abaixo.

Se a conexão for bem-sucedida, você deve ver o Kollektiv MCP ficar verde na página de configurações:

Successful Claude For Desktop

VS Code

Abra o VS Code e vá para Settings -> MCP: Add server > Command (stdio):

  • command:
    • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
  • name:
    • dê ao seu servidor um nome descritivo como kollektiv

Sua configuração settings.json deve ficar semelhante a esta:

{
  "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 passos:

  • Clique em Start para conectar ao Servidor MCP
    • se você não estiver autenticado - você será levado à página de autenticação
  • Lembre-se de adicionar "chat.mcp.enabled": true, no seu settings.json
  • Mude para o modo Agent

💡VS Code requer que você inicie manualmente seu servidor, adicione chat.mcp.enabled e mude para o modo Agent para usar MCP. Se você não vir as ferramentas MCP no modo Agent, tente revisar as etapas de solução de problemas abaixo.

Se a conexão for bem-sucedida, você deve ver as ferramentas expostas pelo Kollektiv MCP.

Successful VS Code Connection

Cline

Abra o Cline, clique em MCP Servers > Edit Configuration e adicione a seguinte configuração ao seu cline_mcp_settings.json:

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

Nota: conexões diretas a servidores remotos que suportam Autorização ainda não são suportadas pelo Cline.

Se a conexão for bem-sucedida, você será levado ao fluxo de autenticação. Após fazer login, você deve ver o Kollektiv MCP habilitado no Cline.

Cline Configuration

Outros (PyCharm, Claude Code)

A maioria dos clientes MCP segue o mesmo formato .json e deve funcionar com etapas de configuração semelhantes aos clientes mencionados anteriormente:

  1. Copie e cole a configuração no arquivo de configuração json do seu cliente
  2. Reinicie o aplicativo
  3. Autentique se ainda não tiver feito
  4. Kollektiv MCP deve ficar verde e estar disponível no modo chat / agente

O sucesso da sua conexão depende de muitos fatores, incluindo, mas não se limitando a:

  • o quão forte os desenvolvedores de um cliente específico quiseram suportar conexões MCP
  • se o cliente suporta a especificação MCP mais recente com suporte a Oauth

Se você estiver enfrentando problemas, seguir estas simples etapas de solução de problemas pode ajudar.

Clientes suportados

Validei que a conexão funciona com os seguintes clientes MCP:

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

Outros clientes MCP devem ser suportados em teoria, mas na prática as coisas podem ser um pouco diferentes. Se você tem um cliente ao qual realmente deseja conectar - me avise!

🎮 Uso

Ferramentas Disponíveis

  • /query_documents — Envie uma pergunta aos documentos que você enviou ao Kollektiv e receba uma resposta baseada nas fontes dos seus documentos.
  • /list_documents — Retorna uma lista dos seus documentos sincronizados juntamente com metadados básicos.
  • Dica profissional: Inclua a frase "use Kollektiv MCP" para que o cliente saiba chamar essas ferramentas.

Dicas de Uso

  • Sempre adicione "use Kollektiv MCP" — Isso informa ao cliente qual servidor MCP usar.
  • Aguarde o documento ficar Disponível — Após o upload, leva de 1 a 2 minutos antes que o documento possa ser consultado.
  • Reformule as consultas quando necessário — Se o cliente gerar uma consulta ruim, edite ou reescreva você mesmo.

❓ Solução de Problemas e Suporte

Este servidor MCP usa o Cloudflare Agents SDK, bem como outras bibliotecas, para fornecer a maneira mais moderna para os usuários se conectarem e usarem servidores MCP. Por outro lado, os clientes MCP ainda precisam implementar suporte para as 2 peças críticas:

  • servidores MCP remotos
  • autorização de servidor MCP

Caso você enfrente problemas de conexão, siga as seguintes etapas de solução de problemas que devem ajudá-lo a conectar ao servidor MCP.

Suporte

Se você precisar de suporte adicional, abra uma issue no GitHub ou entre em contato pelo e-mail support@thekollektiv.ai

Solução de Problemas de Conexão

Se você estiver recebendo o erro Invalid Authorization Request como abaixo ou não conseguir conectar por outro motivo, tente seguir as etapas abaixo que devem corrigir o problema.

Authorization Error

  1. Certifique-se de estar conectando ao endpoint correto:

    • Use https://mcp.thekollektiv.ai/mcp como endpoint MCP.

  2. Limpe o cache do mcp-remote:

    • O que isso faz:
      • Remove o cache da biblioteca mcp-remote que é usada para conectar ao servidor remoto a partir de um cliente que não suporta conexões remotas
    • Como:
      • Execute o seguinte comando no seu terminal
# MacOS
rm -rf ~/.mcp-auth  

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"
  1. Limpe os dados e cookies do seu navegador:
    • O que isso faz:
      • Remove os cookies do navegador que são usados para armazenar informações de autenticação ao fazer login no Kollektiv.
    • Como:
      • Abra as configurações do seu navegador e exclua os dados de navegação das últimas horas

⚠️ Nota: isso fará você sair de todas as sessões ativas, incluindo Kollektiv. Só faça isso se estiver preso em um fluxo de login quebrado.

  1. Reinicie seu cliente MCP e tente reconectar ao servidor MCP:
    • O que isso faz:
      • Clientes MCP (Cursor, Windsurf, etc.) frequentemente armazenam em cache configurações de conexão / configuração de execuções anteriores que podem interferir na autenticação.
    • Como:
      • Reinicie seu editor / cliente
      • Tente reconectar ao servidor MCP

Usando o MCP Inspector

Para fins de depuração, você pode usar o MCP Inspector para conectar ao servidor Kollektiv MCP.

npx @modelcontextprotocol/inspector

Selecione o transporte SSE ou Streamable HTTP

  • SSE: conecte ao servidor em https://mcp.thekollektiv.ai/sse
  • Streamable HTTP: conecte ao servidor em https://mcp.thekollektiv.ai/mcp

🛠️ Detalhes de Implementação (para os 🤓)

Se você está aqui apenas pelo Kollektiv - pule esta seção. Esta seção é para desenvolvedores e construtores curiosos sobre como funciona.

Kollektiv MCP faz parte de um sistema modular que permite aos usuários configurar RAG sobre seus dados em segundos — sem a necessidade de gerenciar infraestrutura, pipelines ou configurações de modelo.

Consiste em três serviços implantados independentemente:

  • Servidor MCP (Cloudflare Worker)
    https://mcp.thekollektiv.ai
    Atua como um gateway seguro para clientes interagirem com dados indexados via Protocolo de Contexto de Modelo. Suporta OAuth.

  • Frontend (React + Vite Worker)
    https://thekollektiv.ai
    Uma interface de usuário limpa e minimalista para enviar e gerenciar seu conteúdo.

  • Backend (FastAPI)
    https://api.thekollektiv.ai
    Lida com ingestão de fontes, validação e orquestração de um pipeline RAG.

🔐 Segurança

Kollektiv MCP implementa várias medidas de segurança:

  • O login acontece via fluxo padrão OAuth 2.1 "Authorization Code" alimentado por Supabase; apenas cookies de curta duração, HttpOnly, Secure são armazenados—nenhuma senha jamais toca este servidor.

  • Todo o tráfego é servido exclusivamente via HTTPS através da borda da Cloudflare, e toda solicitação POST sensível carrega um token CSRF/transacional de uso único.

  • O backend roda dentro do sandbox do Cloudflare Workers (sem sistema de arquivos local, sem processos de longa duração), reduzindo drasticamente a superfície de ataque.

    Para diretrizes detalhadas de divulgação, veja SECURITY.md.

🪪 Licença

Lançado sob a Licença Apache 2.0 — suporte comercial ou licenciamento alternativo: azuev@outlook.com