Referência da API

Conectar o servidor MCP do RedReplier

O RedReplier expõe um servidor MCP hospedado que envolve a mesma API REST pública. Use-o quando um cliente de IA precisar gerenciar sites, palavras-chave, menções, prévias de cobrança e configurações de alerta diretamente.

URL MCP: https://mcp.redreplier.com/mcp

Autenticação

Aponte o seu cliente MCP para o URL e inicie sessão quando o navegador abrir. O servidor responde a pedidos não autenticados com um 401 e um cabeçalho WWW-Authenticate, e os clientes compatíveis com OAuth (Claude Code, Claude Desktop, ChatGPT, Cursor) abrem o início de sessão do RedReplier por conta própria. Não há chave de API para colar.

Prefere uma chave? Agentes sem interface e clientes sem OAuth podem, em vez disso, enviar um token de API do RedReplier no cabeçalho Authorization. O servidor resolve a conta a partir desse token.

Configuração do cliente

Comando único para o Claude Code:

claude mcp add --transport http redreplier https://mcp.redreplier.com/mcp

Configuração completa para qualquer cliente MCP:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp"
    }
  }
}

Alternativa com chave de API, para agentes sem interface e clientes sem OAuth:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp",
      "headers": {
        "Authorization": "Bearer redreplier_your_key"
      }
    }
  }
}

Ferramentas

FerramentaArgumentosRetorna
list_websitesSem argumentos{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, opcional name, keywords, descriptionWebsite
update_websitewebsiteId, opcional name, descriptionWebsite
delete_websitewebsiteId{ deleted: true }
analyze_websiteurl{ description: string }
add_keywordswebsiteId, keywordsWebsite
edit_keywordkeywordId, valueKeyword
disable_keywordkeywordIdKeyword
enable_keywordkeywordIdKeyword
delete_keywordkeywordId{ deleted: true }
activate_pending_keywordsSem argumentos{ websites: Website[] }
preview_activate_pendingSem argumentosprévia de cobrança de palavras-chave
preview_keyword_billingdesiredKeywordCountprévia de cobrança de palavras-chave
keyword_change_usageSem argumentosuso de edição de palavras-chave
list_mentionsopcional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offsetMention[] paginado
count_mentionsopcional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsSem argumentosconfigurações de alerta
update_alert_settingsenabled, opcional cadenceMinutesconfigurações de alerta

Notas

Comece com list_websites para que o cliente conheça os valores disponíveis de websiteId e keywordId. Chame preview_activate_pending antes de activate_pending_keywords, porque a ativação pode acionar um upgrade pago do plano.

Solução de problemas

  • Um 401 num pedido sem token é o desafio OAuth e é esperado. O seu cliente deve abrir uma janela de início de sessão. Um 401 com token significa que o token Bearer está mal formado, expirado, revogado ou não começa por redreplier_.
  • Erros 404 geralmente significam que o ID pertence a outro grupo de conta ou foi excluído.
  • Para ações pagas, pré-visualize primeiro e peça confirmação da cobrança antes de ativar palavras-chave pendentes.