Documentação

Servidor MCP

Permissão da conta necessária

O acesso MCP só está disponível quando já está incluído no direito de uso atual da conta conectada ao Savebase.

O Savebase disponibiliza um Model Context Protocol (MCP) servidor para IA buscar e ler favoritos. Pergunte ao Claude, ChatGPT ou Cursor algo como "O que eu salvei sobre treino com kettlebell?" e consultará sua biblioteca diretamente.

Visão geral

MCP é um padrão aberto que permite conectar aplicativos de IA a fontes de dados externas. O Savebase implementa um endpoint HTTP compatível com MCP que dá ao seu assistente de IA acesso somente de leitura a seus favoritos, pastas e tags.

Para o ChatGPT, instale o publicado Plugin do Savebase. Para Claude, Cursor, VS Code e outros clientes MCP, use este endereço de servidor:

text
https://mcp.savebase.space/mcp

Entre com sua conta como em qualquer app, sem copiar chaves API ou tokens. MCP é só leitura: não adiciona, altera ou exclui nada da biblioteca.

Requisitos

  • Uma conta Savebase cujos direitos de acesso atuais incluam o MCP
  • O plugin publicado do Savebase para ChatGPT ou um cliente compatível com MCP, como Claude, Cursor ou VS Code

Claude (web, computador, celular)

1

Abrir conectores do Claude

Em claude.ai ou no app desktop, vá a Configurações → Conectores.
2

Adicionar um conector personalizado

Clique em Adicionar conector personalizado, dê o nome de Savebasee cole https://mcp.savebase.space/mcp.
3

Conecte e faça login

Clique em Adicionar → Conectar, entre com sua conta Savebase e autorize. As ferramentas do Savebase agora estão disponíveis nas suas conversas.

Funciona no celular também

Um conector remoto adicionado no claude.ai pode ser usado no Claude para iOS e Android, embora novos servidores não possam ser adicionados diretamente pelo Claude Mobile. Veja a documentação da Anthropic: notas atuais de suporte MCP remoto.

Claude Code

1

Adicione o servidor

Execute o seguinte no terminal. Remova --scope user se quiser apenas no projeto atual.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

Autenticar

Inicie o Claude Code e execute /mcp. Uma janela do navegador é aberta — faça login e autorize.
3

Verificar

Executar claude mcp list. O Savebase deve aparecer como conectado.

Cursor

1

Abrir sua configuração de MCP

Ir para Configurações → MCP → Adicionar novo servidorou edite ~/.cursor/mcp.json diretamente.
2

Adicione o servidor do Savebase

Adicione a entrada abaixo. Observe que não há headers bloco — autenticação ocorre no navegador.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Recarregar e autorizar

Recarregue o Cursor. O servidor aparecerá exigindo login — clique nele, entre e aprove.

Importante para usuários do Cursor

Sempre selecione HTTP como tipo de servidor, não SSE. Apague a entrada antiga SSE, adicione como HTTP e reinicie o Cursor.

ChatGPT

1

Abrir o plugin do Savebase

Visite o site oficial Página do plugin do Savebase no catálogo no ChatGPT.
2

Instalar e entrar

Selecione o botão de mais para instalar o Savebase. Quando solicitado, entre com sua conta Savebase e aprove o acesso somente de leitura à biblioteca.
3

Usar o Savebase em uma conversa

Inicie uma nova conversa no ChatGPT Work e invoque o Savebase com @Savebaseou escolha no campo de mensagem quando quiser que o ChatGPT pesquise na sua biblioteca.

Sem necessidade de configuração por desenvolvedor

O plugin público substitui o antigo modo de desenvolvedor e a configuração MCP personalizada do ChatGPT. A URL do servidor MCP acima continua sendo usada por outros clientes compatíveis.

VS Code

1

Adicione o servidor

Abra a paleta de comandos e execute MCP: adicionar servidor, escolha HTTPe cole https://mcp.savebase.space/mcp.
2

Ou edite a configuração diretamente

Adicionar a .vscode/mcp.json no espaço de trabalho:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Entrar

Inicie o servidor pela visualização MCP. Uma janela do navegador será aberta para login; aprove o acesso e as ferramentas aparecerão no modo agente do Copilot Chat.

Gerenciamento de aplicativos conectados

Todos os aplicativos em que você faz login aparecem em Configurações → Servidor MCP → Aplicativos conectados, com a data em que você conectou e a última vez em que leu sua biblioteca. Clique em Desconectar para revogar o acesso imediatamente.

O que um app pode ver

Os aplicativos conectados recebem acesso somente para leitura aos seus favoritos, notas, transcrições, nomes de pastas e tags. Eles nunca veem sua senha e não podem modificar sua biblioteca.

O Savebase só envia dados quando uma solicitação faz o assistente conectado consultar o servidor MCP; ele não envia sua biblioteca em segundo plano para aplicativos conectados nem a usa para treinar um modelo do Savebase. Quando os dados chegam a um assistente, passam a valer os termos de privacidade e uso de dados daquele provedor. Veja a Política de Privacidade do Savebase para a lista completa do que um app recebe.

Avançado: token de acesso manual

Alguns clientes MCP antigos não conseguem entrar pelo navegador e precisam de um token enviado em um cabeçalho. Para eles, abra Configurações → Servidor MCP → Avançado, insira um rótulo e clique em Gerar token. O token começa com sb- e vale até ser revogado.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Segurança do token

O Savebase nunca armazena seu token original, apenas um hash SHA-256. Ele aparece uma única vez ao ser gerado, então copie-o imediatamente. Revogue-o quando quiser em Configurações → Servidor MCP.

Ferramentas disponíveis

Após a conexão, seu assistente de IA terá acesso a estas nove ferramentas. Todas apenas leem dados — nenhuma pode alterar algo na sua biblioteca.

FerramentaDescrição
search_bookmarksBusque por palavra-chave em títulos, conteúdo, notas, autores, URLs e transcrições de vídeo. A busca pode ser limitada a campos específicos e filtrada por plataforma, pasta, tag, criador, período ou existência de transcrição.
list_bookmarksNavegue sem palavra-chave, com filtros opcionais de plataforma, pasta, etiqueta e data
list_recent_bookmarksO que salvou hoje, nesta semana, neste mês ou nos últimos 7 ou 30 dias
get_bookmarkDetalhes completos de um favorito, com tags, pastas e prévia da transcrição
get_bookmark_transcriptLeia a transcrição de um vídeo longo em partes, sem precisar carregar tudo de uma vez
find_bookmark_by_urlConfira se um link já está salvo. Ignora parâmetros de rastreamento como utm_source.
list_foldersListar suas pastas, incluindo os níveis de aninhamento
list_tagsListar todas as suas tags
get_library_statsTotais, divisão por plataforma, pastas e tags mais usadas e atividade recente de salvamento

Exemplos de prompts

Experimente perguntar ao seu assistente de IA:

  • "O que eu salvei sobre treino com kettlebell?"
  • "Mostre tudo o que salvei do Reddit no mês passado."
  • "Encontre o vídeo salvo em que alguém explica como configurar um Cloudflare Worker."
  • "Eu já salvei este link?" — cole uma URL
  • "Encontre todos os favoritos na minha pasta 'Inspiração de design'."
  • "Quais artigos marquei com 'AI'?"
  • "Faça uma análise da minha biblioteca — quantidade, origens e principais etiquetas."
  • "Resuma os posts que salvei na semana passada."

Buscando o que foi dito em um vídeo

Se você transcreveu um vídeo salvo, seu conteúdo falado também pode ser pesquisado. Uma pergunta como "como faço X" pode encontrar uma etapa explicada em voz alta em um clipe que você salvou meses atrás.

Solução de problemas

ProblemaSolução
O Savebase não está disponível no ChatGPTAbra o plugin Savebase publicado, instale e inicie uma nova conversa no ChatGPT Work. Não é mais necessário criar um aplicativo personalizado no modo Desenvolvedor.
O aplicativo nunca pede para você entrarConfira se a URL é exatamente https://mcp.savebase.space/mcp — um erro de digitação impede o cliente de achar o login.
"Acesso ao MCP indisponível" ao fazer loginEntre com uma conta cujo acesso atual inclua MCP ou fale com o suporte do Savebase se acreditar que a permissão está incorreta.
"Esta solicitação expirou"Solicitações de autorização são válidas por 10 minutos. Reinicie a conexão no seu aplicativo de IA.
A conexão parou de funcionarConfira se o aplicativo ainda aparece em Configurações → Servidor MCP → Aplicativos conectados. Se estiver desconectado, reconecte pelo aplicativo.
O servidor mostra “errored” no CursorExclua a entrada antiga do Savebase em Configurações do Cursor → MCP. Adicione-a novamente como Tipo: HTTP (não SSE) e reinicie completamente o Cursor.
Ferramentas não aparecemReinicie seu cliente de IA após adicionar a configuração. Alguns clientes exigem uma reinicialização completa para detectar novos servidores MCP.
Nenhum resultadoVerifique se há favoritos salvos na sua biblioteca do Savebase. O servidor MCP pesquisa apenas seus próprios dados.
Token manual perdidoOs tokens são exibidos apenas uma vez. Revogue o antigo em Configurações → Servidor MCP → Avançado e gere outro.

Etapas rápidas de recuperação

Se não estiver funcionando: (1) Desconecte o Savebase no seu aplicativo de IA, (2) remova-o em Configurações → Servidor MCP → Aplicativos conectados, (3) adicione o conector novamente e entre, (4) reinicie completamente o cliente de IA.