Assistentes de IA (MCP)

O Bookworm tem um servidor MCP — o padrão aberto que os assistentes de IA usam para conversar com outros apps. Depois de conectar, você pode dizer ao seu assistente coisas como “li 40 páginas de Duna hoje” ou “coloca os livros desse artigo na minha lista Quero Ler”, e ele atualiza sua conta do Bookworm por você.

Cada assistente se conecta com uma chave pessoal própria, então dá para ver quando cada um foi usado pela última vez e desconectar qualquer um a qualquer momento.

Conectando um Assistente

1. Na web, vá em Configurações, abra a aba Integrações e toque em Configurar no card Assistentes de IA (MCP) — ou acesse direto app.bookwormtracker.com/ai-assistants.
2. Em Nova chave, preencha o Nome do assistente (por exemplo, “Claude Code”) e toque em Criar chave.
3. Copie a sua chave. Os comandos que aparecem embaixo dela já vêm com a chave — copie o do seu assistente.

Cuidado

A chave aparece uma vez só. Trate como uma senha: quem tiver ela consegue ler e alterar sua biblioteca. Se vazar, revogue e crie outra.

Claude Code

Rode no terminal, trocando YOUR_BOOKWORM_KEY pela sua chave:

claude mcp add --transport http --scope user bookworm https://api.bookwormtracker.com/api/mcp --header "Authorization: Bearer YOUR_BOOKWORM_KEY"

Cursor e outros clientes

A maioria dos outros clientes usa uma configuração em JSON. Adicione isto nas configurações de MCP do seu cliente (no Cursor, ~/.cursor/mcp.json):

{
  "mcpServers": {
    "bookworm": {
      "url": "https://api.bookwormtracker.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_BOOKWORM_KEY" }
    }
  }
}

Dica

Crie uma chave por assistente. Assim você desconecta um sem quebrar os outros.

Nota

Ainda não dá para adicionar o Bookworm como conector de dentro do claude.ai ou do ChatGPT — eles exigem um fluxo de login que o Bookworm ainda não tem. Use um assistente que permita configurar o cabeçalho de autorização, como os de cima.

O Que um Assistente Pode Fazer

• Ver sua biblioteca, suas listas e estatísticas, e buscar livros.
• Adicionar livros à biblioteca e mudar status, nota, resenha e página atual.
• Registrar sessões de leitura com as páginas que você leu.
• Criar listas de leitura e adicionar ou remover livros delas.
• Iniciar, pausar e encerrar o cronômetro de leitura — o mesmo que aparece no app, então uma sessão iniciada pelo assistente aparece no seu celular na hora.

Um assistente não consegue apagar livros, listas nem sessões. Tirar um livro de uma lista mantém ele na sua biblioteca.

Gerenciando Suas Chaves

Toda chave que você cria aparece em Assistentes conectados, com a última vez que foi usada. Toque no ícone de lixeira e confirme em Revogar para desconectar aquele assistente na hora.

Cuidado

Revogar não tem volta. Para reconectar o assistente, crie uma chave nova e atualize a configuração dele.

Premium

Assistentes de IA são um recurso Premium. Se a sua assinatura acabar, as chaves param de funcionar na hora — não precisa revogar, e elas voltam a funcionar se você assinar de novo.

Gratuito vs Premium

	Gratuito	Premium
Conectar assistentes de IA	—	✓
Chaves pessoais	—	Até 5