Quotewise Quote MCP
Búsqueda semántica de citas: 600,000 citas con transparencia de fuente
Documentación
Configuración de MCP
Dale a tu asistente de IA acceso a 626K citas con transparencia de fuentes.
Lo que podrás hacer:
- Buscar citas por significado, no solo por palabras clave
- Ver las fuentes de cada cita a través de QuoteSightings
- Funciona con Claude Code, Claude Desktop, ChatGPT, Codex CLI, Gemini CLI, Grok Bot y cualquier cliente MCP
La mayoría de los clientes: un solo comando. Archivo de configuración de Claude Desktop: 2 minutos.
[!success] Éxito No necesitas registrarte para comenzar. Acceso anónimo: 20 solicitudes/día. Para límites más altos, crea una clave API o autentícate mediante el flujo OAuth de dispositivo (se te solicitará en el primer uso).
Configuración rápida (cualquier cliente)
npx @quotewise/mcp setup
Asistente interactivo que genera la configuración para tu cliente. O elige tu cliente a continuación.
Configuración de Claude Code
Ejecuta este comando en tu terminal:
claude mcp add --transport http quotewise https://mcp.quotewise.io/
Verifica con claude mcp list o /mcp dentro de una sesión.
[!info] Información Esto agrega Quotewise a tu
.mcp.jsona nivel de proyecto. Usa--scope userpara la configuración global.
Configuración de Claude Desktop
Método 1: Interfaz de Conectores (Recomendado)
- Abre Claude Desktop
- Ve a Configuración > Conectores
- Agrega la URL del servidor MCP:
Método 2: Archivo de Configuración
Agrega a tu archivo de configuración usando el puente mcp-remote:
{
"mcpServers": {
"quotewise": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.quotewise.io/"]
}
}
}
Requiere Node.js 18+. Autenticación mediante flujo OAuth de dispositivo en la primera conexión.
[!info] Información Claude Desktop no admite servidores HTTP remotos directamente en el archivo de configuración. El puente
mcp-remoteejecuta un proceso local stdio que actúa como proxy al servidor remoto.
¿Dónde está el archivo de configuración?
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Linux:
~/.config/Claude/claude_desktop_config.json
[!warning] Advertencia Nota: Después de editar el archivo de configuración, reinicia Claude Desktop para que los cambios surtan efecto.
Aprende más: Conectarse a servidores MCP remotos (documentación oficial)
Configuración de ChatGPT
Disponible para cuentas Pro, Plus, Business, Enterprise y Education.
Conectores (Recomendado)
- Abre ChatGPT Desktop > Configuración > Conectores
- Haz clic en Avanzado, activa Modo Desarrollador
- Haz clic en Crear e ingresa la URL del servidor MCP:
- En cada chat nuevo: haz clic en + > Más > Modo Desarrollador para activarlo Alternativa: Acciones personalizadas de GPT (para crear GPTs personalizados)
Agrega búsqueda semántica de citas con transparencia de fuentes a cualquier GPT personalizado. Tu GPT encontrará citas por significado y mostrará las fuentes de cada resultado.
Paso 1: Crea tu GPT
- Ve a ChatGPT > Explorar GPTs > Crear
- Haz clic en la pestaña Configurar
- En Acciones, haz clic en Crear nueva acción
Paso 2: Elige la autenticación
[!warning] Advertencia Elige la autenticación correcta: ¿GPT público? Usa OAuth. ¿GPT privado (solo tú)? Usa Clave API.
Cada usuario se autentica con su propia cuenta de Quotewise.
ID de cliente
Use your HTTPS client metadata document URL
Los clientes MCP usan Documentos de Metadatos de ID de Cliente (CIMD).
Secreto de cliente
Déjalo vacío (cliente público)
URL de autorización
https://quotewise.io/oauth/authorize
URL de token
https://quotewise.io/oauth/token
Alcance
quotes:read
Método de intercambio de token
Predeterminado (solicitud POST)
Clave API (solo GPTs privados)
Úsala solo para GPTs privados donde controles el acceso.
Tipo de autenticación
Clave API
Clave API
Tu clave API de Quotewise
Encabezado de autenticación
Authorization
Nombre de encabezado personalizado
Bearer
Paso 3: Importa el esquema OpenAPI
Haz clic en Importar desde URL e ingresa:
Paso 4: Política de privacidad
Ingresa la URL de nuestra política de privacidad:
Paso 5: Instrucciones del GPT
Copia estas instrucciones en el mensaje del sistema de tu GPT para prevenir alucinaciones y garantizar la transparencia de fuentes:
You help users find quotes from 500K+ quotes with source transparency via Quotewise.
## CRITICAL RULE
NEVER invent quotes. ALWAYS use Quotewise API. If search returns no results, say "I couldn't find a quote matching that." Don't fabricate or guess.
## Semantic Search (Primary Tool)
Use \`quotes_list\` with \`q\` parameter. This searches by MEANING, not keywords.
User describes what they want → you search that description → semantic vectors find conceptual matches.
Examples:
- "courage during uncertainty" finds Mandela, Roosevelt, etc.
- "persistence pays off" finds Edison, Jordan, etc.
- "question authority" finds Thoreau, Douglass, etc.
## Finding Specific Authors
1. \`originator_search\` → find author by name
2. \`originator_quotes\` → get their quotes
## Random Discovery
\`quote_random\` when users want inspiration without a specific topic.
## Similar Quotes
\`quote_similar\` (by quote ID) or \`quote_similar_by_text\` when users want more like a quote they like.
## Presenting Results
- ALWAYS show author name
- ALWAYS mention source/work if available (QuoteSightings provides this)
- Offer to find similar quotes or more from same author
## Why This Matters
People search quotes for different reasons—presentations, inspiration, research, personal use. Quotewise provides source transparency via QuoteSightings. Show users the evidence so they can decide for themselves.
Consulta la documentación de autenticación de OpenAI para más detalles sobre la configuración de OAuth.
Configuración de Codex CLI
Ejecuta este comando en tu terminal:
codex mcp add quotewise --url https://mcp.quotewise.io/
Verifica con codex mcp list.
Configuración de Gemini CLI
Método 1: Línea de comandos (Recomendado)
Ejecuta este comando en tu terminal:
gemini mcp add --transport http quotewise https://mcp.quotewise.io/
Método 2: Configuración manual
Edita el archivo settings.json directamente:
{
"mcpServers": {
"quotewise": {
"httpUrl": "https://mcp.quotewise.io/"
}
}
}
Autenticación mediante flujo OAuth de dispositivo en la primera conexión.
¿Dónde está el archivo de configuración?
macOS / Linux:
~/.gemini/settings.json
Windows:
%HOMEPATH%\.gemini\settings.json
Verifica la conexión
- Reinicia Gemini CLI si ya está en ejecución
- Entra en modo chat escribiendo
gemini - Escribe
/mcppara ver los servidores conectados - Deberías ver
quotewiselistado con estado Conectado
Intenta preguntar: "Obtén una cita sobre la persistencia"
Configuración de Cursor
OAuth sin encabezado funciona. Agrega la URL pública; el host abre un navegador para iniciar sesión en Quotewise.
https://mcp.quotewise.io/mcp
Configuración de Grok Bot
Quotewise Daily es un bot público del Marketplace de Grok Bot: un compañero de escritorio de citas con una selección diaria estable durante el día, búsqueda semántica, atribución y fuentes de colecciones.
Requiere un plan elegible de Cursor, SuperGrok o X Premium+.
- Instala o abre Grok Bot
- Abre la lista de Quotewise Daily en el Marketplace y haz clic en Agregar a Grok Bot: Enlace directo permanente (estable entre republicaciones). También puedes explorar el Marketplace; la búsqueda puede ir con retraso, así que prefiere el enlace directo.
- Si faltan herramientas, agrega Quotewise como MCP remoto personalizado (
https://mcp.quotewise.io/mcp). El acceso anónimo funciona con el límite diario. Para límites más altos, agregaAuthorization: Bearer <API key>desde el panel de desarrollador. - Intenta preguntar: hoy, sobre …, quién dijo … o de la colección.
Prefiere MCP en lugar de inventar citas. Cada respuesta debe enlazar profundamente a https://quotewise.io/q/{short_code}/.
MCP remoto personalizado
OAuth sin encabezado no se completa hoy porque Grok Bot no publica un Documento de Metadatos de ID de Cliente. Esa es una limitación del host Grok Bot, no una entrada faltante en la lista de permitidos de Quotewise (grokbot://mcp/oauth/callback ya está aceptado).
Personalización funcional: URL pública, más un encabezado qw_ Bearer opcional para una sesión iniciada.
{
"url": "https://mcp.quotewise.io/mcp",
"headers": {
"Authorization": "Bearer qw_YOUR_TOKEN"
}
}
Crea un token qw_ en el panel de desarrollador. Omite el encabezado para acceso anónimo (20 solicitudes/día). El OAuth con código de dispositivo solo lo inician los clientes que eligen ese permiso; Grok Bot no lo hace.
Otros clientes MCP
Cualquier cliente MCP que admita servidores HTTP remotos puede conectarse usando esta configuración:
{
"mcpServers": {
"quotewise": {
"url": "https://mcp.quotewise.io/"
}
}
}
El formato exacto de configuración varía según el cliente. La URL es siempre https://mcp.quotewise.io/.
Cursor IDE y Claude completan OAuth sin encabezado en un navegador local. Grok Bot MCP personalizado no lo hace; usa la URL pública más un encabezado qw_ Bearer opcional. Algunos clientes CLI inician el flujo OAuth de dispositivo en el primer uso.
Solución de problemas
Conexión rechazada o tiempo de espera agotado
- Verifica que puedas acceder a
https://mcp.quotewise.io/desde tu red - Los firewalls corporativos pueden bloquear la conexión
- Para el método de archivo de configuración de Claude Desktop, asegúrate de que Node.js 18+ esté instalado (requerido por
mcp-remote)
Token de autenticación inválido
- Los tokens de API usan el prefijo
qw_. Regenera tu clave en el panel de desarrollador - Cursor IDE y Claude abren un navegador para OAuth sin encabezado. Grok Bot MCP personalizado no lo hace; pasa
Authorization: Bearer qw_…en su lugar - Algunos clientes CLI inician el flujo OAuth de dispositivo. Si se te solicita, abre la URL e ingresa el código mostrado
- El acceso anónimo (20 solicitudes/día) funciona sin ninguna autenticación
Límite de velocidad excedido
Las herramientas no aparecen
- Después de agregar la configuración del servidor, reinicia tu cliente MCP
- Usa la herramienta
pingpara verificar la conectividad - Consulta la Referencia de herramientas MCP para la lista completa de herramientas disponibles