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.
- Abre o Reading Journey no diretório do Claude e clica em Connect to Claude.
- 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.
- Confirma o que o Claude vai poder fazer e clica em Permitir. Voltas automaticamente ao Claude.
- 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 settings›Connectors; 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
- No Muse, abre Settings›Connectors.
- Escolhe Add custom connector e cola
https://mcp.readingjourney.app. - 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 Customize›Connectors, seleciona Reading Journey e escolhe Remove; no Muse, em Settings›Connectors. 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