Servidor MCP do Screvi

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite a assistentes de IA se conectarem a dados externos. O servidor MCP do Screvi dá ao seu assistente acesso aos seus destaques, fontes e artigos salvos, para você fazer perguntas baseadas no que leu, e não no que o modelo lembra pela metade.

O servidor do Screvi fica em https://api.screvi.com/mcp. Ele funciona com qualquer cliente MCP que suporte servidores remotos com OAuth, incluindo Claude (web, desktop e celular), Claude Code, Cursor e ChatGPT.

O acesso via MCP exige uma assinatura ativa ou um período de teste do Screvi.

O que seu assistente pode fazer

Buscar seus destaques por significado, não só por palavras-chave. Filtrar por favoritos, tipo de fonte, nome da fonte, autor ou tag.
Abrir um destaque ou uma fonte com suas tags, notas e todos os destaques daquele livro.
Ler um artigo salvo na íntegra, com seus destaques e notas, e fazer perguntas sobre ele.
Navegar pelas suas tags e buscar os destaques de qualquer uma delas.
Buscar seus artigos salvos por título, autor, domínio, status de leitura, caixa de entrada ou Mais tarde, favoritos, tag ou se você já os destacou.
Trazer destaques aleatórios para uma revisão diária.
Salvar links e capturar destaques (opcional): salvar uma URL na sua caixa, ou guardar como destaque um trecho que o assistente encontrou, com nota e tags.
Marcar tags e organizar (opcional): adicionar ou remover tags, arquivar, favoritar ou mover artigos para Mais tarde, corrigir um título ruim ou buscar de novo um artigo que foi salvo com problemas.

Nada no servidor MCP exclui dados. Toda ação de escrita é reversível pelo aplicativo.

Conectar ao Claude

Vá em claude.ai/settings/connectors e clique em Adicionar conector personalizado.
Dê o nome Screvi e defina a URL do servidor MCP como https://api.screvi.com/mcp. Clique em Adicionar.
O Claude envia você ao Screvi para autorizar. Faça login e clique em Aprovar. A tela de consentimento lista exatamente o que você está concedendo.
Comece uma nova conversa. O Claude agora pode buscar na sua leitura.

Você também pode abrir o conector em qualquer chat pelo botão + e depois Conectores. Para desconectar, remova-o na mesma página de configurações.

Conectar a outros clientes

Qualquer cliente que suporte servidores MCP remotos com OAuth funciona da mesma forma: adicione um servidor com a URL https://api.screvi.com/mcp e conclua o login quando o cliente abrir a página de autorização do Screvi.

Claude Code: claude mcp add --transport http screvi https://api.screvi.com/mcp, depois rode /mcp para fazer login.
Cursor: adicione a URL em Settings > MCP.
ChatGPT: adicione-o como conector em Configurações > Conectores (modo desenvolvedor).

Exemplos de prompts

"O que eu destaquei sobre tomada de decisão?"
"Encontre meus destaques favoritos de Meditações, de Marco Aurélio."
"Mostre os artigos que salvei este mês e ainda não comecei."
"Quais tags eu mais uso? Me dê cinco destaques da maior."
"Arquive todas as newsletters da minha caixa de entrada com mais de duas semanas."
"Este artigo foi salvo como 'Sem título'. Corrija o título."

Ferramentas disponíveis

As ferramentas de leitura funcionam em todas as conexões.

Ferramenta	O que faz
`search`	Busca semântica e por palavras-chave em todos os destaques. Filtros: favoritos, tipo de fonte, fonte ou autor, tag.
`get-highlight`	Um destaque com sua fonte, tags e notas.
`get-source`	Uma fonte (livro, podcast, vídeo) com todos os seus destaques.
`get-article`	O texto completo de um artigo salvo, com suas tags, nota e destaques. Artigos longos chegam em partes.
`list-tags`	Todas as tags com contagens de destaques e artigos.
`get-highlights-by-tag`	Destaques de uma tag, opcionalmente uma amostra aleatória.
`random-highlights`	Uma amostra aleatória de destaques, opcionalmente limitada a favoritos, um tipo, uma tag ou uma fonte.
`search-articles`	Artigos salvos por título, autor, domínio, status de leitura, caixa de entrada ou Mais tarde, favoritos, tag ou número de destaques.

As ferramentas de escrita só funcionam quando a conexão foi aprovada com acesso de escrita. Elas mudam o estado dos artigos, nunca o conteúdo, e nenhuma delas exclui nada.

Ferramenta	O que faz
`save-article`	Salva uma URL na sua caixa, opcionalmente com tags. A página é buscada em segundo plano.
`create-highlight`	Guarda um trecho como destaque, anexado a uma fonte ou artigo se quiser, com nota e tags.
`add-tags`	Marca destaques e/ou artigos com tags. Nomes novos são criados.
`remove-tags`	Remove tags de destaques e/ou artigos.
`update-highlight`	Adiciona ou altera uma nota, favorita ou corrige o texto de um destaque existente.
`update-tag`	Renomeia ou muda a cor de uma tag.
`archive-articles`	Arquiva artigos ou os devolve à caixa de entrada.
`set-articles-later`	Move artigos para Mais tarde ou de volta à caixa de entrada.
`favorite-articles`	Favorita ou desfavorita artigos.
`update-article-details`	Corrige o título ou o resumo de um artigo.
`reparse-article`	Busca de novo um artigo pela URL quando a cópia salva está truncada ou cheia de texto de navegação.

Somente leitura ou leitura e escrita?

Se uma conexão pode alterar algo é decidido quando você a autoriza. A página de consentimento do Screvi mostra o que o cliente pediu: só acesso de leitura, ou leitura mais gerenciamento de artigos. Clientes conectados antes de existir suporte a escrita continuam somente leitura.

Se seu assistente informar "Esta conexão é somente leitura", desconecte o Screvi no cliente e conecte de novo. Aprove a nova solicitação se ela incluir acesso de escrita.

Privacidade e segurança

OAuth 2.0 com PKCE. Você faz login na própria página do Screvi. Sua senha nunca chega ao cliente de IA.
Acesso com escopo. Leitura e escrita são permissões separadas. Nada pode excluir destaques, fontes ou artigos.
Buscado sob demanda. O Screvi retorna só o que uma consulta pede. O Screvi não armazena suas conversas.
Tokens MCP não são logins do app. O token que um cliente de IA possui só funciona no servidor MCP. Ele não consegue entrar no app do Screvi, alterar sua conta nem criar chaves de API.
Revogue a qualquer momento. Abra Configurações > API > Apps de IA ligadas no Screvi para ver cada cliente conectado e desligar um deles. O acesso termina na hora, mesmo que o cliente ainda tenha o token. Remover o conector no cliente de IA também funciona.

Solução de problemas

O conector pede para eu fazer login de novo. As conexões se renovam sozinhas em segundo plano e só expiram após 90 dias sem uso, ou quando você desconecta a app no Screvi. Faça login mais uma vez e a conexão continua.

"Assinatura necessária". O MCP exige um plano ativo ou período de teste. Verifique seu plano na página de preços.

A busca não retorna nada. Destaques novos são indexados alguns minutos depois da importação. Se a biblioteca é recente, espere um pouco e tente de novo.

“O corpo do artigo ainda está sendo buscado”. Artigos salvos pelo MCP são processados em segundo plano. Pergunte de novo alguns segundos depois.

Relacionados

API pública para scripts e integrações personalizadas
Busca semântica com IA para ver como a busca ordena os resultados