# 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.

Endereço do servidor: `https://mcp.readingjourney.app`

## 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](https://claude.ai/directory/reading-journey) 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 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

1. No Muse, abre **Settings > Connectors**.
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 **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. |
