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.jsonno nível do projeto. Use--scope userpara configuração global.
Configuração do Claude Desktop
Método 1: Interface de Conectores (Recomendado)
- Abra o Claude Desktop
- Vá para Configurações > Conectores
- 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-remoteexecuta 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)
- Abra o ChatGPT Desktop > Configurações > Conectores
- Clique em Avançado, ative o Modo Desenvolvedor
- Clique em Criar e insira a URL do servidor MCP:
- 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
- Vá para ChatGPT > Explorar GPTs > Criar
- Clique na aba Configurar
- 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
- Reinicie o Gemini CLI se já estiver em execução
- Entre no modo de chat digitando
gemini - Digite
/mcppara ver os servidores conectados - Você deve ver
quotewiselistado 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+.
- Instale ou abra o Grok Bot
- 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.
- 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, adicioneAuthorization: Bearer <API key>do painel do desenvolvedor. - 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
pingpara verificar a conectividade - Consulte a Referência de Ferramentas MCP para a lista completa de ferramentas disponíveis