Referencia de API

Conectar el servidor MCP de RedReplier

RedReplier expone un servidor MCP alojado que envuelve la misma API REST pública. Úsalo cuando un cliente de IA deba gestionar sitios web, palabras clave, menciones, vistas previas de facturación y configuración de alertas directamente.

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

Autenticación

Apunta tu cliente MCP a la URL e inicia sesión cuando se abra el navegador. El servidor responde a las solicitudes sin autenticar con un 401 y un encabezado WWW-Authenticate, y los clientes compatibles con OAuth (Claude Code, Claude Desktop, ChatGPT, Cursor) abren el inicio de sesión de RedReplier por sí solos. No hay clave de API que pegar.

¿Prefieres una clave? Los agentes sin interfaz y los clientes sin OAuth pueden enviar en su lugar un token de API de RedReplier en el encabezado Authorization. El servidor resuelve la cuenta desde ese token.

Configuración del cliente

Comando de una línea para Claude Code:

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

Configuración completa para cualquier cliente MCP:

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

Alternativa con clave de API, para agentes sin interfaz y clientes sin OAuth:

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

Herramientas

HerramientaArgumentosDevuelve
list_websitesSin 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_keywordsSin argumentos{ websites: Website[] }
preview_activate_pendingSin argumentosvista previa de facturación de palabras clave
preview_keyword_billingdesiredKeywordCountvista previa de facturación de palabras clave
keyword_change_usageSin argumentosuso de edición de palabras clave
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_settingsSin argumentosconfiguración de alertas
update_alert_settingsenabled, opcional cadenceMinutesconfiguración de alertas

Notas

Empieza con list_websites para que el cliente conozca los valores disponibles de websiteId y keywordId. Llama a preview_activate_pending antes de activate_pending_keywords, porque la activación puede disparar una mejora de plan de pago.

Solución de problemas

  • Un 401 en una solicitud sin token es el desafío de OAuth y es lo esperado. Tu cliente debería abrir una ventana de inicio de sesión. Un 401 con token significa que el token Bearer está mal formado, caducado, revocado o no empieza con redreplier_.
  • Los errores 404 normalmente indican que el ID pertenece a otro grupo de cuenta o fue eliminado.
  • Para acciones de pago, previsualiza primero y pide confirmación del cargo antes de activar palabras clave pendientes.