# Conector de assistente

Conecte o ChatGPT, o Claude ou o Meta Muse à sua biblioteca do Reading Journey e peça para ele adicionar livros, marcar como concluídos, avaliar ou planejar suas Próximas leituras. A configuração leva uns dois minutos e o conector é grátis.

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

## Antes de começar

- Uma conta do Reading Journey. Você pode entrar com Apple, Google ou e-mail e senha, ou criar uma conta durante a configuração.
- Use o mesmo método de login que você usa no app, para o assistente se conectar à sua biblioteca de sempre.
- **Claude** (web, desktop e apps para celular), ChatGPT ou **Meta Muse**.
- Não precisa de RJ+ nem de ter o app instalado para conectar.

## Conectar o Claude

O Reading Journey está no diretório de conectores do Claude, então não é preciso colar nada.

1. Abra o [Reading Journey no diretório do Claude](https://claude.ai/directory/reading-journey) e clique em **Connect to Claude**.
2. Na página do Reading Journey, escolha **Continuar com a Apple** ou **Continuar com o Google**, ou entre com seu e-mail e senha.
3. Confira o que o Claude vai poder fazer e clique em **Permitir**. Você volta para o Claude.
4. Em uma conversa, abra o menu **+**, escolha **Connectors** e confira se o Reading Journey está ativado. Aí é só pedir.

Nos planos Team e Enterprise, primeiro um proprietário ativa o conector em **Organization settings > Connectors**; depois, cada membro se conecta com a própria conta do Reading Journey. Depois de conectado na web, ele também funciona nos apps do Claude para celular.

## Conectar o Meta Muse

1. No Muse, abra **Settings > Connectors**.
2. Escolha **Add custom connector** e cole `https://mcp.readingjourney.app`.
3. Na página do Reading Journey, entre do mesmo jeito que no app, confira as permissões e escolha **Permitir**.

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

## Experimente

Abra uma conversa nova e peça, por exemplo:

- "Adicione Piranesi, da Susanna Clarke, ao meu Reading Journey como Quero Ler e coloque em Próximas leituras."
- "O que tem nas minhas Próximas leituras? Troque o terceiro por A Mão Esquerda da Escuridão."
- "Ontem terminei Amanhã, Amanhã, e Ainda Outro Amanhã. Marque como concluído e dê 4,5 estrelas."
- "Crie uma coleção chamada Clube do Livro 2026 e coloque nela todos os livros de autores japoneses que estão em Quero Ler."
- "Quais livros estou lendo agora e quais estão pausados?"
- "Vou abandonar Graça Infinita. Marque como não terminado."
- "Me recomende três fantasias aconchegantes (cozy fantasy) que eu ainda não tenho e adicione a que eu escolher."

Depois, abra o Reading Journey e suas alterações vão estar lá. Se o app já estiver aberto, saia dele e volte para sincronizar.

## O que um assistente pode e não pode fazer

| Pode | Não pode |
| --- | --- |
| Ver e alterar seus livros, status, avaliações, coleções, Próximas leituras, anotações, resenhas e registros do diário | Ver suas fotos ou suas localizações exatas |
| Adicionar livros, mudar o status, avaliar, registrar o progresso e definir metas | Excluir uma coleção, uma meta, uma leitura ou um livro com histórico de leitura sem perguntar antes |
| Gerenciar Próximas leituras e o Top 4, criar e preencher coleções, adicionar fotos quando você pedir | Alterar sua conta, sua assinatura ou suas configurações |

A página de permissões que aparece na hora de conectar diz o mesmo: o assistente pode ler e alterar suas anotações, resenhas e registros do diário, e pode adicionar, substituir ou remover fotos quando você pedir, mas nunca vê-las. Conectou antes de 1º de novembro de 2026? Conecte de novo para dar esse acesso.

## Referência das ferramentas

Você nunca chama as ferramentas diretamente: você pede com suas palavras e o assistente escolhe uma. Todas as ferramentas funcionam só na sua própria biblioteca.

| Ferramenta | Tipo | O que faz |
| --- | --- | --- |
| `list_books` | Leitura | Lista seus livros com status, avaliação, Próximas leituras e coleções; pode filtrar por status, coleção ou palavras |
| `get_book` | Leitura | Um livro com as datas de cada leitura, sua avaliação, coleções e posição em Próximas leituras |
| `list_collections` | Leitura | Suas coleções e quantos livros cada uma tem |
| `get_next_up` | Leitura | Seus livros de Próximas leituras, em ordem |
| `add_book` | Escrita | Adiciona um livro (como Quero Ler, por padrão); nunca duplica um que você já tem |
| `set_status` | Escrita | Começa, pausa, conclui ou abandona um livro, ou marca como Quero Ler |
| `rate_book` | Escrita | Avalia a leitura atual de 0,25 a 5 estrelas, ou apaga a avaliação |
| `set_next_up` | Escrita | Coloca um livro ainda não começado em Próximas leituras |
| `remove_from_next_up` | Escrita | Tira um livro de Próximas leituras |
| `create_collection` | Escrita | Cria uma coleção |
| `add_to_collection` | Escrita | Coloca um livro em uma coleção |
| `remove_from_collection` | Escrita, pergunta antes | Tira um livro de uma coleção; o livro continua na biblioteca |
| `remove_book` | Escrita, pergunta antes | Exclui um livro que você só adicionou; nunca um com histórico de leitura, avaliação, registro no diário, progresso, lugar no Top 4, anotação ou foto de capa |

Para desenvolvedores: os escopos OAuth são `mcp` (leitura e alteração; é o que Permitir concede), `library:read` e `library:write`. A conexão continua ativa enquanto você usa; depois de 60 dias sem uso, conecte de novo.

## Limites e segurança

- Antes de remover um livro ou tirar um livro de uma coleção, o assistente é instruído a perguntar a você.
- Se você mudar algo no celular, a sua alteração prevalece sobre a do assistente.
- Os assistentes são instruídos a nunca seguir instruções escritas em títulos de livros, nomes de autores ou nomes de coleções.
- Cada conexão pode ler sua biblioteca 60 vezes por minuto e alterá-la 30 vezes por minuto.
- O conector não conta como dispositivo, então não afeta a sincronização do plano gratuito.

## Desconectar

Remova o conector no assistente: no Claude, em **Customize > Connectors**, selecione o Reading Journey e escolha **Remove**; no Muse, em **Settings > Connectors**. Excluir sua conta do Reading Journey desconecta todos os assistentes. Sair da conta no app, não.

## Solução de problemas

| O que aparece | O que fazer |
| --- | --- |
| "Esse e-mail e essa senha não correspondem a nenhuma conta." | Confira se não há erro de digitação ou redefina a senha no app com **Esqueceu a senha?**. Se você usa Apple ou Google no app, escolha **Continuar com a Apple** ou **Continuar com o Google**. |
| O assistente vê uma biblioteca vazia | Você entrou com um método diferente do que usa no app. Desconecte, conecte de novo e use o mesmo método. |
| "Confirme seu e-mail primeiro e depois entre." | Abra o e-mail de confirmação que enviamos e entre de novo. |
| "Esta página expirou." | Volte ao assistente e conecte o Reading Journey de novo. |
| O provedor recusou o registro do app | Esse assistente ainda não é compatível. O Claude, o ChatGPT e o Meta Muse são. |
| As alterações não aparecem no app | Confira se o app está conectado à mesma conta, depois saia dele e volte. Em uma conta gratuita, as alterações chegam ao dispositivo que sincroniza. |
| "…só pode ser removido no app Reading Journey." | O livro tem histórico de leitura; exclua-o pela página do livro no app. |
