Servidor MCP da Lyra

O que é MCP?

MCP (Model Context Protocol) é uma especificação aberta da Anthropic pra assistentes de IA chamarem ferramentas em servidores remotos de forma padronizada. Pense em USB-C pra LLMs: qualquer cliente fala com qualquer servidor.

A Lyra roda um servidor MCP em https://lyrasearch.com/mcp. Ele expõe ferramentas para consultas que respeitam a privacidade (um domínio específico está bloqueado ou Clean?), alternativas curadas, busca filtrada, links de instalação, mensagens prontas pra compartilhar e as suas listas pessoais. As listas oficiais de bloqueio e Clean são privadas, então o MCP nunca as devolve por inteiro, só respostas item a item. Ferramentas públicas (só leitura) funcionam sem autenticação; suas listas e dados de compra são liberados entrando com OAuth (um clique, sem chave pra copiar).

Por que isso existe

A extensão da Lyra bloqueia o ruído de fast-fashion dentro do navegador do usuário. O servidor MCP pega as mesmas listas curadas e as torna programáveis na camada dos agentes:

• "Claude, a shein.com está na lista de bloqueio da Lyra?" → resposta sim/não na hora, com categoria
• "Sugira alternativas sustentáveis pra tênis casual" → até N marcas curadas
• "Busque conjuntos de facas de cozinha mas pule dropshipping ruim" → URL do DDG/Google já filtrada
• "Adicione esta marca que descobri à minha lista Clean pessoal" → sincronizado em todos os meus dispositivos
• "Como instalo a Lyra no Android?" → link direto da Play Store

Uma fonte de verdade, servida em todo lugar.

Ferramentas disponíveis

Públicas — sem login (cota diária grátis)

• check_domain
• suggest_alternatives
• get_stats
• search_with_lyra
• get_install_links
• get_share_message

Suas listas — leitura e escrita (entre com OAuth)

• list_personal
• get_my_block_list
• get_my_clean_list
• submit_block_domain
• submit_clean_brand
• add_personal_block / remove_personal_block
• add_personal_clean / remove_personal_clean

Seus dados de compra e planejamento — leitura, e escritas que mostram aviso em tempo real + Desfazer no app Lyra (entre com OAuth)

• get_recurring_purchases
• get_monthly_essentials
• get_shopping_plan
• list_future_purchases
• add_to_plan / remove_from_plan

Só no dispositivo (página, abas, favoritos e histórico). Ações que agem no mundo externo — comprar, enviar, submeter — NÃO ficam aqui; sempre exigem sua confirmação expressa na tela, no Lyra.

• get_current_page
• list_tabs
• get_favorites
• get_history
• list_page_tools
• call_page_tool

Configurar · Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lyra": {
      "url": "https://lyrasearch.com/mcp",
      "headers": {
        "Authorization": "Bearer lyra_YOUR_LICENSE_KEY_HERE"
      }
    }
  }
}

Ferramentas públicas (só leitura) funcionam sem cabeçalho. Pras suas listas e dados de compra, conecte com OAuth (login em um clique na sua conta Lyra — sem chave pra copiar): o cliente abre a Lyra, você aprova, pronto. A chave Bearer manual de /billing é só pra scripts/CLIs que não conseguem abrir um navegador.

Configurar · Cursor / Zed / Continue

Esses editores suportam MCP via HTTP streaming. Adicione isso na configuração MCP do seu editor:

{
  "lyra": {
    "transport": "http",
    "url": "https://lyrasearch.com/mcp"
  }
}

Configurar · ChatGPT (conector MCP ou GPT personalizado)

O ChatGPT agora fala MCP: no Modo Desenvolvedor / Conectores, adicione a URL do servidor https://lyrasearch.com/mcp e autorize com OAuth (um clique, sem chave). Se o seu plano não mostrar conectores MCP, envolva nossa spec OpenAPI 3 como Action de GPT customizado.

Teste rápido (curl)

Lista todas as ferramentas sem autenticação:

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Verifica um domínio:

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
    "name":"check_domain",
    "arguments":{"domain":"shein.com","locale":"pt-BR"}
  }}'

Submete um domínio pra bloquear (com chave de licença):

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lyra_YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
    "name":"submit_block_domain",
    "arguments":{"domain":"newpredator.com","reason":"dropshipping low-quality"}
  }}'

Idiomas

Toda ferramenta aceita um argumento locale. Valores suportados: en, pt-BR, es, zh-CN, zh-TW, hi, ar, fr, bn, ru, id, ur, de, ja, vi, tr, ko, it, pl, nl, he.

Quando omitido, o servidor usa en como padrão. Os rótulos de categoria na resposta são traduzidos; nomes de marca e identificadores de domínio permanecem canônicos.

Ecossistema

A Lyra tem quatro formas de uso — todas nas mesmas listas curadas:

• Extensão (Chrome, Edge, Brave): filtra em tempo real dentro do navegador
• DNS (Lyra Safe DNS): limpa todos os apps do aparelho
• App (Android, iPhone, Mac, PC): o navegador nativo da Lyra
• Site (lyrasearch.com): a Lyra Search na web, com login