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.json a nivel de proyecto. Usa --scope user para la configuración global.

Configuración de Claude Desktop

Método 1: Interfaz de Conectores (Recomendado)

  1. Abre Claude Desktop
  2. Ve a Configuración > Conectores
  3. 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-remote ejecuta 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)

  1. Abre ChatGPT Desktop > Configuración > Conectores
  2. Haz clic en Avanzado, activa Modo Desarrollador
  3. Haz clic en Crear e ingresa la URL del servidor MCP:
  4. 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

  1. Ve a ChatGPT > Explorar GPTs > Crear
  2. Haz clic en la pestaña Configurar
  3. 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

  1. Reinicia Gemini CLI si ya está en ejecución
  2. Entra en modo chat escribiendo gemini
  3. Escribe /mcp para ver los servidores conectados
  4. Deberías ver quotewise listado 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+.

  1. Instala o abre Grok Bot
  2. 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.
  3. 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, agrega Authorization: Bearer <API key> desde el panel de desarrollador.
  4. 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 ping para verificar la conectividad
  • Consulta la Referencia de herramientas MCP para la lista completa de herramientas disponibles