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

Ferramenta	Argumentos	Retorna
`list_workspaces`	Sem argumentos	`{ workspaces: Workspace[] }`
`list_websites`	Sem 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`	Sem argumentos	uso de edição de palavras-chave
`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`	Sem argumentos	configurações de alerta
`update_alert_settings`	`enabled`, opcional `cadenceMinutes`	configurações de alerta

Notas

Um login OAuth pode alcançar vários workspaces. Chame list_workspaces para listá-los e passe o id no argumento opcional workspaceId que todas as outras ferramentas aceitam. Sem workspaceId, as ferramentas agem no workspace padrão.

Comece com list_websites para que o cliente conheça os valores disponíveis de websiteId e keywordId. Palavras-chave acima do limite do plano ficam em PENDING até uma vaga ser liberada. Desativar ou excluir uma palavra-chave ativa, ou excluir um site, libera uma vaga, e a palavra-chave pendente mais antiga que caiba ocupa esse lugar. Só o usuário pode mudar o plano, no app do RedReplier. delete_keyword funciona com palavras-chave em qualquer status e também apaga as menções delas, então confirme com o usuário antes.

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_.
Um 403 com code: workspace_access_denied significa que este login não alcança esse workspaceId; escolha um em list_workspaces. Um 403 com code: subscription_required significa que o plano do workspace não inclui acesso à API. Um 403 com code: permission_denied significa que seu papel nesse workspace não tem redreplier.write, que Admin e Editor têm; peça a um admin do workspace um papel que tenha.
Erros 404 geralmente significam que o ID pertence a outro grupo de conta ou foi excluído.
Uma palavra-chave que continua em PENDING não cabe no plano. Peça ao usuário para mudar o plano no app do RedReplier, ou desative ou exclua outra palavra-chave.