Quotewise Quote MCP

Pesquisa semântica de citações - 600 mil citações com transparência de fonte

Documentação

Configuração do MCP

Dê ao seu assistente de IA acesso a 626 mil citações com transparência de fonte.

O que você poderá fazer:

  • Pesquisar citações por significado, não apenas por palavras-chave
  • Ver as fontes de cada citação via QuoteSightings
  • Funciona com Claude Code, Claude Desktop, ChatGPT, Codex CLI, Gemini CLI, Grok Bot e qualquer cliente MCP

Na maioria dos clientes: um comando. Arquivo de configuração do Claude Desktop: 2 minutos.

[!success] Sucesso Não é necessário cadastro para começar. Acesso anônimo: 20 solicitações/dia. Para limites maiores, crie uma chave de API ou autentique-se via fluxo de dispositivo OAuth (solicitado no primeiro uso).

Configuração Rápida (Qualquer Cliente)

npx @quotewise/mcp setup

Assistente interativo que gera a configuração para o seu cliente. Ou escolha seu cliente abaixo.

Configuração do Claude Code

Execute este comando no seu terminal:

claude mcp add --transport http quotewise https://mcp.quotewise.io/

Verifique com claude mcp list ou /mcp dentro de uma sessão.

[!info] Informação Isso adiciona o Quotewise ao seu .mcp.json no nível do projeto. Use --scope user para configuração global.

Configuração do Claude Desktop

Método 1: Interface de Conectores (Recomendado)

  1. Abra o Claude Desktop
  2. Vá para Configurações > Conectores
  3. Adicione a URL do servidor MCP:

Método 2: Arquivo de Configuração

Adicione ao seu arquivo de configuração usando a ponte mcp-remote:

{
  "mcpServers": {
    "quotewise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quotewise.io/"]
    }
  }
}

Requer Node.js 18+. Autenticação via fluxo de dispositivo OAuth na primeira conexão.

[!info] Informação O Claude Desktop não suporta servidores HTTP remotos diretamente no arquivo de configuração. A ponte mcp-remote executa um processo local stdio que faz proxy para o servidor remoto.

Onde está o arquivo de configuração?

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

[!warning] Aviso Nota: Após editar o arquivo de configuração, reinicie o Claude Desktop para que as alterações tenham efeito.

Saiba mais: Conectar a Servidores MCP Remotos (documentação oficial)

Configuração do ChatGPT

Disponível para contas Pro, Plus, Business, Enterprise e Education.

Conectores (Recomendado)

  1. Abra o ChatGPT Desktop > Configurações > Conectores
  2. Clique em Avançado, ative o Modo Desenvolvedor
  3. Clique em Criar e insira a URL do servidor MCP:
  4. Em cada novo chat: clique em + > Mais > Modo Desenvolvedor para ativar Alternativa: Ações Personalizadas do GPT (para criar GPTs personalizados)

Adicione pesquisa semântica de citações com transparência de fonte a qualquer GPT personalizado. Seu GPT encontrará citações por significado e mostrará as fontes de cada resultado.

Etapa 1: Crie seu GPT

  1. Vá para ChatGPT > Explorar GPTs > Criar
  2. Clique na aba Configurar
  3. Em Ações, clique em Criar nova ação

Etapa 2: Escolha a Autenticação

[!warning] Aviso Escolha a autenticação correta: GPT público? Use OAuth. GPT privado (somente você)? Use Chave de API.

Cada usuário autentica com sua própria conta Quotewise.

ID do Cliente

Use your HTTPS client metadata document URL
Clientes MCP usam Documentos de Metadados de ID de Cliente (CIMD).

Segredo do Cliente

Deixe vazio (cliente público)

URL de Autorização

https://quotewise.io/oauth/authorize

URL do Token

https://quotewise.io/oauth/token

Escopo

quotes:read

Método de Troca de Token

Padrão (solicitação POST)

Chave de API (somente GPTs privados)

Use apenas para GPTs privados onde você controla o acesso.

Tipo de Autenticação

Chave de API

Chave de API

Sua chave de API Quotewise

Cabeçalho de Autenticação

Authorization

Nome do Cabeçalho Personalizado

Bearer

Etapa 3: Importar Esquema OpenAPI

Clique em Importar da URL e insira:

Etapa 4: Política de Privacidade

Insira a URL da nossa política de privacidade:

Etapa 5: Instruções do GPT

Copie estas instruções no prompt do sistema do seu GPT para evitar alucinações e garantir transparência de fonte:

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.

Consulte a documentação de autenticação da OpenAI para mais detalhes sobre a configuração OAuth.

Configuração do Codex CLI

Execute este comando no seu terminal:

codex mcp add quotewise --url https://mcp.quotewise.io/

Verifique com codex mcp list.

Configuração do Gemini CLI

Método 1: Linha de Comando (Recomendado)

Execute este comando no seu terminal:

gemini mcp add --transport http quotewise https://mcp.quotewise.io/

Método 2: Configuração Manual

Edite o arquivo settings.json diretamente:

{
  "mcpServers": {
    "quotewise": {
      "httpUrl": "https://mcp.quotewise.io/"
    }
  }
}

Autenticação via fluxo de dispositivo OAuth na primeira conexão.

Onde está o arquivo de configuração?

macOS / Linux:

~/.gemini/settings.json

Windows:

%HOMEPATH%\.gemini\settings.json

Verifique a Conexão

  1. Reinicie o Gemini CLI se já estiver em execução
  2. Entre no modo de chat digitando gemini
  3. Digite /mcp para ver os servidores conectados
  4. Você deve ver quotewise listado com status Conectado

Tente perguntar: "Obtenha uma citação sobre persistência"

Configuração do Cursor

OAuth sem cabeçalho funciona. Adicione a URL pública; o host abre um navegador para o login do Quotewise.

https://mcp.quotewise.io/mcp

Configuração do Grok Bot

Quotewise Daily é um bot público do Grok Bot Marketplace — um colega de mesa de citações com seleção diária estável, busca semântica, atribuição e feeds de coleções.

Requer um plano elegível Cursor, SuperGrok ou X Premium+.

  1. Instale ou abra o Grok Bot
  2. Abra a listagem do Quotewise Daily no Marketplace e clique em Adicionar ao Grok Bot: Link direto permanente (estável entre republicações). Você também pode navegar no Marketplace; a busca pode estar desatualizada, então prefira o link direto.
  3. Se as ferramentas estiverem ausentes, adicione o Quotewise como um MCP remoto personalizado (https://mcp.quotewise.io/mcp). O acesso anônimo funciona com o limite diário. Para limites maiores, adicione Authorization: Bearer <API key> do painel do desenvolvedor.
  4. Tente perguntar: hoje, sobre …, quem disse …, ou da coleção.

Prefira MCP em vez de inventar citações. Cada resposta deve ter link direto para https://quotewise.io/q/{short_code}/.

MCP remoto personalizado

O OAuth sem cabeçalho não é concluído hoje porque o Grok Bot não publica um Documento de Metadados de ID de Cliente. Isso é uma limitação do host Grok Bot, não uma entrada ausente na lista de permissões do Quotewise (grokbot://mcp/oauth/callback já é aceito).

Personalização funcional: URL pública, mais um cabeçalho qw_ Bearer opcional para uma sessão autenticada.

{
  "url": "https://mcp.quotewise.io/mcp",
  "headers": {
    "Authorization": "Bearer qw_YOUR_TOKEN"
  }
}

Crie um token qw_ no painel do desenvolvedor. Omita o cabeçalho para acesso anônimo (20 solicitações/dia). OAuth com código de dispositivo só é iniciado por clientes que escolhem essa concessão; o Grok Bot não.

Outros Clientes MCP

Qualquer cliente MCP que suporte servidores HTTP remotos pode se conectar usando esta configuração:

{
  "mcpServers": {
    "quotewise": {
      "url": "https://mcp.quotewise.io/"
    }
  }
}

O formato exato da configuração varia por cliente. A URL é sempre https://mcp.quotewise.io/.

Cursor IDE e Claude concluem o OAuth sem cabeçalho em um navegador local. O MCP personalizado do Grok Bot não; use a URL pública mais um cabeçalho qw_ Bearer opcional. Alguns clientes CLI iniciam o fluxo de dispositivo OAuth no primeiro uso.

Solução de Problemas

Conexão recusada ou timeout

  • Verifique se você consegue acessar https://mcp.quotewise.io/ da sua rede
  • Firewalls corporativos podem bloquear a conexão
  • Para o método de arquivo de configuração do Claude Desktop, garanta que o Node.js 18+ esteja instalado (necessário pelo mcp-remote)

Token de autenticação inválido

  • Tokens de API usam o prefixo qw_. Regere sua chave no painel do desenvolvedor
  • Cursor IDE e Claude abrem um navegador para OAuth sem cabeçalho. O MCP personalizado do Grok Bot não; passe Authorization: Bearer qw_… em vez disso
  • Alguns clientes CLI iniciam o fluxo de dispositivo OAuth. Se solicitado, abra a URL e insira o código exibido
  • Acesso anônimo (20 solicitações/dia) funciona sem qualquer autenticação

Limite de taxa excedido

Ferramentas não aparecendo

  • Após adicionar a configuração do servidor, reinicie seu cliente MCP
  • Use a ferramenta ping para verificar a conectividade
  • Consulte a Referência de Ferramentas MCP para a lista completa de ferramentas disponíveis