Cleve

npx add-mcp 'https://app.cleve.ai/mcp'

Cleve MCP

Traga seu workspace Cleve para seu agente de IA. Encontre documentos e conhecimento de projeto relevantes, leia o material de origem e use-o como contexto para seu trabalho. Capture ideias e resultados como novos documentos, atualize documentos existentes e organize o conhecimento em pastas. Quando quiser compartilhar algo publicamente, crie um resumo com um link somente leitura que outras pessoas possam abrir.

Este repositório contém a configuração pública de integração da Cleve, habilidades de agente reutilizáveis e identidade visual. Ele se conecta ao servidor MCP hospedado existente; não contém o backend do aplicativo Cleve nem executa outro servidor.

Conexão

• Endpoint MCP: https://app.cleve.ai/mcp
• Transporte: HTTP Streamable
• Autenticação: OAuth; entre com uma conta Cleve gratuita e aprove a conexão. Nenhuma chave de API separada é necessária.
• Documentação: Guia do desenvolvedor Cleve MCP

Use um workspace pessoal ou compartilhado disponível para sua conta conectada. As habilidades resolvem o destino e passam o workspace explicitamente. Um seletor de workspace sozinho não é uma garantia de isolamento no lado do servidor.

Cursor

A raiz plugin.json e mcp.json usam o formato portátil Agent Plugins suportado pelo Cursor. As quatro habilidades são descobertas a partir de skills/.

Para um teste local, copie os arquivos de plugin deste repositório para ~/.cursor/plugins/local/cleve/, depois recarregue o Cursor e verifique em Customize o servidor MCP e as habilidades da Cleve. Um symlink para um repositório fora do diretório local de plugins não é suportado. Autentique a conexão MCP antes de testar uma leitura. Este repositório ainda não foi testado dentro do Cursor.

Para configuração somente MCP, adicione esta entrada à sua configuração MCP existente do Cursor, preservando outros servidores:

{
  "mcpServers": {
    "cleve": {
      "url": "https://app.cleve.ai/mcp"
    }
  }
}

Consulte Preparação e revisão do Cursor para as verificações de publicação restantes.

O repositório público a ser usado para a submissão ao Cursor é cleve-ai/mcp. Hospedar este repositório não publica por si só uma listagem no Cursor Marketplace.

A Cleve chama o conteúdo do workspace de docs. Nomes MCP existentes como cleve_read_note, campos de entrada como noteId e URLs /notes/ permanecem compatíveis.

Habilidades reutilizáveis

• save: salva um resumo útil da conversa disponível como um novo documento privado.
• share: cria um resumo da conversa com um link público somente leitura após estabelecer a intenção de compartilhamento público.
• recall: busca e lê documentos Cleve relevantes e explica os resultados com fontes; sem gravações.
• update: incorpora novas decisões e próximos passos no documento existente pretendido usando edições estreitas; sem documento duplicado de fallback.

Invoque as habilidades pelo seletor do host (os nomes podem ter namespace) ou peça naturalmente:

• “Salve as decisões e próximos passos desta conversa na Cleve.”
• “Traga contexto relevante da Cleve sobre o roadmap do produto e explique o que já decidimos.”
• “Atualize o documento Cleve vinculado acima com nossos próximos passos acordados. Não crie outro documento.”
• “Crie um link público somente leitura para um resumo desta conversa. Deixe de fora detalhes privados.”

As habilidades descrevem fluxos de trabalho; instalar ou conectar sozinho não salva, edita ou publica nada. Elas dependem das ferramentas MCP da Cleve expostas pelo host conectado. Uma conexão MCP simples não instala automaticamente essas habilidades.

Smithery

Publique o endpoint hospedado existente pelo fluxo de URL do Smithery. Nenhuma implantação de repositório ou segundo servidor é necessária. O Smithery escaneia as ferramentas do servidor e pode solicitar autorização OAuth para concluir o escaneamento. As habilidades neste repositório não são incluídas automaticamente em uma listagem MCP baseada em URL.

Consulte a listagem Cleve no Smithery e as notas de conexão do Smithery. A listagem do endpoint hospedado é separada deste repositório e não instala essas habilidades automaticamente.

Privacidade e suporte

Envie apenas para a Cleve o conteúdo que o usuário pedir para salvar ou editar. Nunca inclua senhas, tokens, instruções ocultas ou arquivos de código-fonte locais não relacionados em resumos de conversa. Salvar e editar não autorizam a alteração do acesso público. Links de resumo público podem ser lidos e redistribuídos por qualquer pessoa com o link.

• Suporte · Privacidade · Termos
• Contato: support@cleve.ai
• Vídeo de demonstração
• Identidade visual: assets/cleve-icon-square.svg é um SVG quadrado, somente ícone. assets/cleve-icon-square-white.svg e assets/cleve-icon-square-white.png são a mesma arte quadrada em uma placa de fundo branco sólido. assets/directory-logo.png é o PNG quadrado do diretório fornecido.

Verificações e status de publicação

Com o Bun instalado, execute bun test. Essas verificações validam o pacote local e seus limites de caminho/credenciais. Elas não comprovam execução autenticada de ferramentas, preservação de formatação, acesso a links públicos sem login ou aceitação no marketplace.

O repositório público de integração é cleve-ai/mcp. Nenhuma submissão ao Cursor Marketplace foi feita para este pacote, e testes autenticados dentro do Cursor permanecem pendentes. Não adicione credenciais de revisores, dados de workspace privado ou links seguros de compartilhamento de credenciais a este repositório. Publicar esses arquivos não implanta nem altera o servidor MCP hospedado.

Licença

A configuração de integração, habilidades, documentação e testes são licenciados sob MIT. Os logotipos da Cleve e outros arquivos sob assets/ são excluídos; nenhum direito de marca registrada é concedido. O serviço Cleve hospedado e seu backend não são licenciados por este repositório. Consulte escopo da licença para os limites.

Verificações de lançamento

Consulte manutenção de distribuição para o contrato sincronizado, verificações e processo de lançamento por diretório.