Reading Journeydocs
Português (Portugal)

Docs

Conector para assistentes

Liga o ChatGPT, o Claude ou o Meta Muse à tua biblioteca do Reading Journey e pede-lhe para adicionar livros, marcá-los como terminados, classificá-los ou planear as tuas Próximas leituras. A configuração demora cerca de dois minutos e o conector é gratuito.

Antes de começares

  • Uma conta Reading Journey. Podes iniciar sessão com a Apple, com o Google ou com e-mail e palavra-passe, ou criar uma conta durante a configuração.
  • Usa o mesmo método de início de sessão que usas na app, para que o assistente se ligue à biblioteca que já tens.
  • Claude (web, apps para computador e para telemóvel), ChatGPT ou Meta Muse.
  • Não precisas do RJ+, nem de ter a app instalada para fazer a ligação.

Ligar o Claude

O Reading Journey está no diretório de conectores do Claude, por isso não tens de colar nada.

  1. Abre o Reading Journey no diretório do Claude e clica em Connect to Claude.
  2. Na página do Reading Journey, escolhe Continuar com a Apple ou Continuar com o Google, ou inicia sessão com o teu e-mail e palavra-passe.
  3. Confirma o que o Claude vai poder fazer e clica em Permitir. Voltas automaticamente ao Claude.
  4. Numa conversa, abre o menu +, escolhe Connectors e confirma que o Reading Journey está ativado. Depois é só pedir.

Nos planos Team e Enterprise, primeiro um proprietário ativa o conector em Organization settingsConnectors; depois, cada membro liga-o com a sua própria conta Reading Journey. Depois de ligado na web, também funciona nas apps do Claude para telemóvel.

Ligar o Meta Muse

  1. No Muse, abre SettingsConnectors.
  2. Escolhe Add custom connector e cola https://mcp.readingjourney.app.
  3. Na página do Reading Journey, inicia sessão da mesma forma que na app, confirma as permissões e escolhe Permitir.

Os menus do Muse podem mudar de uma versão para outra; se não encontrares Connectors, consulta a ajuda da Meta sobre conectores personalizados.

Experimenta

Abre uma conversa nova e pede, por exemplo:

  • "Adiciona Piranesi de Susanna Clarke ao meu Reading Journey como Quero Ler e põe-no nas Próximas leituras."
  • "O que tenho nas Próximas leituras? Troca o terceiro por The Left Hand of Darkness."
  • "Acabei Tomorrow, and Tomorrow, and Tomorrow ontem. Marca-o como terminado e dá-lhe 4,5 estrelas."
  • "Cria uma coleção chamada Clube de Leitura 2026 e adiciona todos os livros Quero Ler de autores japoneses."
  • "Que livros estou a ler neste momento e quais pus em pausa?"
  • "Vou desistir de Infinite Jest. Marca-o como não terminado."
  • "Recomenda-me três livros de cozy fantasy que ainda não tenha e adiciona o que eu escolher."

Depois abre o Reading Journey e as tuas alterações estão lá. Se a app já estiver aberta, sai dela e volta para sincronizar.

O que um assistente pode e não pode fazer

Pode Não pode
Ver e alterar os teus livros, estados, classificações, coleções, Próximas leituras, notas, críticas e registos do diário Ver as tuas fotos ou localizações exatas
Adicionar livros, mudar o estado, classificá-los, registar progresso e definir objetivos Eliminar uma coleção, um objetivo, uma leitura ou um livro com histórico de leitura sem te perguntar primeiro
Gerir as Próximas leituras e o Top 4, criar e preencher coleções, adicionar fotos quando pedes Alterar a tua conta, a subscrição ou as definições

A página de permissões que vês ao fazer a ligação diz o mesmo: o assistente pode ler e alterar as tuas notas, críticas e registos do diário, e pode adicionar, substituir ou remover fotos quando pedes, mas nunca as consegue ver. Fizeste a ligação antes de 1 de novembro de 2026? Volta a ligar para lhe dares este acesso.

Referência das ferramentas

Nunca és tu a chamar as ferramentas: pedes por palavras tuas e o assistente escolhe uma. Todas as ferramentas funcionam apenas na tua própria biblioteca.

Ferramenta Tipo O que faz
list_books Leitura Lista os teus livros com estado, classificação, Próximas leituras e coleções; pode filtrar por estado, coleção ou palavras
get_book Leitura Um livro com as datas de cada leitura, a tua classificação, as coleções e a posição nas Próximas leituras
list_collections Leitura As tuas coleções e quantos livros tem cada uma
get_next_up Leitura Os livros das tuas Próximas leituras, por ordem
add_book Escrita Adiciona um livro (Quero Ler por predefinição); nunca duplica um que já tenhas
set_status Escrita Começa, pausa, termina ou abandona um livro, ou marca-o como Quero Ler
rate_book Escrita Classifica a leitura atual de 0,25 a 5 estrelas, ou apaga a classificação
set_next_up Escrita Põe um livro ainda não começado nas Próximas leituras
remove_from_next_up Escrita Tira um livro das Próximas leituras
create_collection Escrita Cria uma coleção
add_to_collection Escrita Põe um livro numa coleção
remove_from_collection Escrita, pergunta primeiro Tira um livro de uma coleção; o livro continua na biblioteca
remove_book Escrita, pergunta primeiro Elimina um livro que só adicionaste; nunca um com histórico de leitura, classificação, registo no diário, progresso, lugar no Top 4, nota ou foto da capa

Para programadores: os scopes OAuth são mcp (ler e alterar; o que Permitir concede), library:read e library:write. Uma ligação mantém a sessão iniciada enquanto a usas; ao fim de 60 dias sem uso, volta a ligar.

Limites e segurança

  • Antes de remover um livro ou de o tirar de uma coleção, o assistente tem instruções para te perguntar.
  • Se alterares alguma coisa no telemóvel, a tua alteração prevalece sobre a do assistente.
  • Os assistentes têm instruções para nunca seguir instruções escritas em títulos de livros, nomes de autores ou nomes de coleções.
  • Cada ligação pode ler a tua biblioteca 60 vezes por minuto e alterá-la 30 vezes por minuto.
  • O conector não conta como dispositivo, por isso não afeta a sincronização da conta gratuita.

Desligar

Remove o conector no assistente: no Claude, em CustomizeConnectors, seleciona Reading Journey e escolhe Remove; no Muse, em SettingsConnectors. Eliminar a tua conta Reading Journey desliga todos os assistentes. Terminar sessão na app não.

Resolução de problemas

O que vês O que fazer
"Este e-mail e esta palavra-passe não correspondem a nenhuma conta." Verifica se há gralhas ou repõe a palavra-passe na app com Esqueceste-te da palavra-passe?. Se usas a Apple ou o Google na app, escolhe antes Continuar com a Apple ou Continuar com o Google.
O assistente vê uma biblioteca vazia Iniciaste sessão com um método diferente do da app. Desliga, volta a ligar e usa o mesmo método.
"Confirma primeiro o teu e-mail e depois inicia sessão." Abre o e-mail de confirmação que te enviámos e inicia sessão novamente.
"Esta página expirou." Volta ao assistente e liga o Reading Journey novamente.
O fornecedor rejeitou o registo da app Esse assistente ainda não é compatível. O Claude, o ChatGPT e o Meta Muse são.
As alterações não aparecem na app Confirma que a app tem sessão iniciada na mesma conta, depois sai dela e volta. Numa conta gratuita, as alterações chegam ao dispositivo que sincroniza.
"…can only be removed in the Reading Journey app." O livro tem histórico de leitura; elimina-o na página do livro, na app.

Da documentação pública do Reading Journey.Página inicial do Reading JourneyPrivacidadeTermosApoio