SF book

Conecta Agentes de IA

Dale superpoderes a tu IA. Conecta Claude, ChatGPT o Gemini a la biblioteca de SansFiction.

Información rápida

Endpoint MCP

https://sansfiction.com/api/mcp

Autenticación

OAuth 2.1 mediante Supabase. La búsqueda pública es anónima; el acceso a la biblioteca personal requiere consentimiento.

Capacidades

Instrucciones de configuración

Claude Code / Escritorio

La forma más fácil de conectarse usando la CLI de Claude.

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

Luego verifica que funciona:

claude mcp list

Token Manual (Claude/Cursor)

Token de acceso para API y Agente

Un solo token para la API REST (Authorization: Bearer … en /api/v1) y para clientes MCP que no soportan OAuth.

Tokens activos

Cargando tokens...

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

Se recomienda OAuth cuando esté disponible. Los tokens manuales están limitados a tu cuenta.

API REST (v1)

¿Prefieres HTTP simple en lugar de MCP? Cada capacidad está disponible como API REST bajo /api/v1, autenticada con el mismo token de acceso. Ideal para agentes, scripts y “skills” de 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 personal — token de portador

Lee y actualiza tu propia 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

Especificación completa legible por máquina: /openapi.json · Habilidad de agente: SKILL.md

Ejemplos de prompts

"Encuentra libros de Brandon Sanderson publicados en 2023."

"Obtén detalles de 'Project Hail Mary' incluyendo el número de páginas."

"Autoriza SansFiction para mi cuenta."

"Lista mis libros que estoy leyendo actualmente."

"Registra progreso: 'Dune' está ahora en la página 150."

"Mueve 'Dungeon Crawler Carl' a terminados."

"Muéstrame colecciones con 'Fantasy' en el nombre."

"Muestra mis estadísticas de lectura mensuales."

Solución de problemas

¿Fallo de conexión?

Asegúrate de que tu cliente de IA pueda acceder a internet. El servidor MCP de SansFiction está alojado en https://sansfiction.com/api/mcp y requiere HTTPS.

401 No autorizado

Intentaste acceder a una herramienta privada sin consentimiento de OAuth. Inicia el flujo de OAuth y aprueba el acceso.

Lista de herramientas vacía

Verifica que ingresaste la URL correcta sin espacios al final ni rutas adicionales. Debe terminar con /api/mcp.