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, workspaces 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

Herramienta	Argumentos	Devuelve
`list_workspaces`	Sin argumentos	`{ workspaces: Workspace[] }`
`list_websites`	Sin argumentos	`{ websites: Website[] }`
`get_website`	`websiteId`	`Website`
`create_website`	`url`, opcional `name`, `keywords`, `description`	`Website`
`update_website`	`websiteId`, opcional `name`, `description`	`Website`
`delete_website`	`websiteId`	`{ deleted: true }`
`analyze_website`	`url`	`{ description: string }`
`add_keywords`	`websiteId`, `keywords`	`Website`
`edit_keyword`	`keywordId`, `value`	`Keyword`
`disable_keyword`	`keywordId`	`Keyword`
`enable_keyword`	`keywordId`	`Keyword`
`delete_keyword`	`keywordId`	`{ deleted: true }`
`keyword_change_usage`	Sin argumentos	uso de edición de palabras clave
`list_mentions`	opcional `websiteId`, `statuses`, `scoreBuckets`, `includeLowRelevance`, `minScore`, `keywords`, `sources`, `sort`, `from`, `to`, `limit`, `offset`	`Mention[]` paginado
`count_mentions`	opcional `websiteId`, `statuses`, `scoreBuckets`, `includeLowRelevance`, `minScore`, `keywords`, `sources`, `from`, `to`	`{ total: number }`
`update_mention_status`	`mentionId`, `status`	`Mention`
`explain_mention`	`mentionId`	`Mention \| null`
`get_alert_settings`	Sin argumentos	configuración de alertas
`update_alert_settings`	`enabled`, opcional `cadenceMinutes`	configuración de alertas

Notas

Un inicio de sesión OAuth puede llegar a varios workspaces. Llama a list_workspaces para listarlos y pasa el id como el argumento opcional workspaceId que acepta cualquier otra herramienta. Sin workspaceId, las herramientas actúan en el workspace predeterminado.

Empieza con list_websites para que el cliente conozca los valores disponibles de websiteId y keywordId. Las palabras clave que superan el límite del plan quedan en PENDING hasta que se libera una plaza. Desactivar o eliminar una palabra clave activa, o eliminar un sitio web, libera una plaza, y la palabra clave pendiente más antigua que quepa la ocupa. Solo el usuario puede cambiar el plan, en la app de RedReplier. delete_keyword funciona con palabras clave en cualquier estado y también borra sus menciones, así que confirma con el usuario antes.

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_.
Un 403 con code: workspace_access_denied significa que este inicio de sesión no puede acceder a ese workspaceId; elige uno de list_workspaces. Un 403 con code: subscription_required significa que el plan del workspace no incluye acceso a la API. Un 403 con code: permission_denied significa que tu rol en ese workspace no tiene redreplier.write, que tienen Admin y Editor; pide a un admin del workspace un rol que lo tenga.
Los errores 404 normalmente indican que el ID pertenece a otro grupo de cuenta o fue eliminado.
Una palabra clave que sigue en PENDING no cabe en el plan. Pide al usuario que cambie el plan en la app de RedReplier, o desactiva o elimina otra palabra clave.