SF book

Conecte Agentes de IA

Dê superpoderes à sua IA. Conecte Claude, ChatGPT ou Gemini à biblioteca SansFiction.

Informações rápidas

Endpoint MCP

https://sansfiction.com/api/mcp

Autenticação

OAuth 2.1 via Supabase. A busca pública é anônima; o acesso à biblioteca pessoal requer consentimento.

Recursos

Instruções de Configuração

CClaude Code / Desktop

A maneira mais fácil de conectar usando a CLI do Claude.

claude mcp add --transport http sansfiction https://sansfiction.com/api/mcp

Então verifique se funciona:

claude mcp list

Token Manual (Claude/Cursor)

Token de acesso para API e Agente

Um token para tanto a API REST (Authorization: Bearer … em /api/v1) quanto clientes MCP que não suportam OAuth.

Tokens ativos

Carregando tokens...

{ "mcpServers": { "sansfiction": { "type": "http", "url": "https://sansfiction.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

OAuth é recomendado quando disponível. Tokens manuais são limitados à sua conta.

API REST (v1)

Prefere HTTP simples em vez de MCP? Todos os recursos estão disponíveis como API REST sob /api/v1, autenticada com o mesmo token de acesso. Ótimo para agentes, scripts e “skills” do Claude/OpenAI.

curl "https://sansfiction.com/api/v1/catalog/search?q=dune&limit=5"

• GET /api/v1/catalog/search?q=
• GET /api/v1/catalog/books/{bookId}
• GET /api/v1/catalog/series/{seriesId}
• GET /api/v1/catalog/collections

Biblioteca pessoal — token de portador

Leia e atualize sua própria biblioteca.

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://sansfiction.com/api/v1/library/books?status=reading"

• GET/POST /api/v1/library/books
• PATCH/DELETE /api/v1/library/books/{id}
• GET /api/v1/library/collections
• GET /api/v1/library/stats

Especificação completa legível por máquina: /openapi.json · Skill de agente: SKILL.md

Exemplos de Prompts

"Encontre livros de Brandon Sanderson publicados em 2023."

"Obtenha detalhes de 'Project Hail Mary' incluindo contagem de páginas."

"Autorize SansFiction para minha conta."

"Liste meus livros que estou lendo atualmente."

"Registre progresso: 'Dune' está agora na página 150."

"Mova 'Dungeon Crawler Carl' para concluído."

"Mostre-me coleções com 'Fantasy' no nome."

"Mostre minhas estatísticas mensais de leitura."

Solução de Problemas

Falha na Conexão?

Garanta que seu cliente de IA possa acessar a internet. O servidor MCP da SansFiction está hospedado em https://sansfiction.com/api/mcp e requer HTTPS.

401 Não Autorizado

Você tentou acessar uma ferramenta privada sem consentimento OAuth. Dispare o fluxo OAuth e aprove o acesso.

Lista de Ferramentas Vazia

Verifique se você digitou a URL correta sem espaços no final ou caminhos extras. Ela deve terminar com /api/mcp.