RedirectBoss

Gerencie hosts, redirecionamentos, SSL e análises de tráfego a partir do Claude e de outros assistentes de IA.

Ver em redirectboss.comExperimente este MCPPatrocinado

Documentação

Visão Geral

O servidor MCP RedirectBoss permite que assistentes de IA, como o Claude, gerenciem seus redirecionamentos em seu nome. Ele implementa o Model Context Protocol (MCP), um padrão aberto para conectar modelos de IA a ferramentas externas. Quando você autoriza o servidor, o assistente de IA pode listar e modificar hosts e redirecionamentos em sua conta, além de obter análises de tráfego e desempenho por redirecionamento, chamando nossa API pública nos bastidores.

URL do servidor: https://mcp.redirectboss.com/mcp

Autenticação: OAuth 2.1 (código de autorização + PKCE, Documentos de Metadados de ID do Cliente)

Transporte: HTTP Streamable

Requisitos

  • Uma conta RedirectBoss em um plano que inclua acesso à API. Consulte preços para detalhes dos planos.
  • Um cliente MCP que suporte Documentos de Metadados de ID do Cliente (a especificação MCP atual), como Claude, VS Code e ChatGPT. Clientes que ainda não implementam Documentos de Metadados de ID do Cliente não podem se conectar.

Ferramentas Disponíveis

O servidor expõe as ferramentas listadas abaixo. Ferramentas somente leitura são seguras para executar sem confirmação; ferramentas de escrita modificam sua conta; ferramentas destrutivas são irreversíveis e a maioria dos clientes MCP solicitará confirmação antes de executá-las.

Gerenciamento de Hosts

  • list_hosts: lista todos os hosts com status de SSL/DNS (somente leitura)
  • get_host: obtém informações detalhadas de um único host (somente leitura)
  • create_host: adiciona um novo domínio de origem (escrita)
  • update_host: atualiza configurações do host, ex.: tratamento de www (escrita)
  • delete_host: remove um host e desativa seus redirecionamentos (destrutivo)
  • check_dns: executa uma verificação de resolução DNS em tempo real (somente leitura)
  • check_ssl: verifica o status de provisionamento de SSL (somente leitura)
  • enable_ssl: aciona o provisionamento de certificado SSL via Let's Encrypt (escrita)

Gerenciamento de Redirecionamentos

  • list_redirects: lista regras de redirecionamento com filtros (somente leitura)
  • get_redirect: obtém uma única regra de redirecionamento (somente leitura)
  • create_redirect: cria uma nova regra de redirecionamento (escrita)
  • update_redirect: atualiza campos de um redirecionamento existente (escrita)
  • delete_redirect: exclui permanentemente uma regra de redirecionamento (destrutivo)

Análises

  • get_hosts_analytics: resumo por host de contagens de redirecionamentos, acessos e tempo médio de resposta (somente leitura)
  • get_traffic_trends: acessos em toda a conta ao longo do tempo com granularidade diária ou mensal (somente leitura)
  • get_host_traffic_trends: acessos ao longo do tempo limitados a um único host (somente leitura)
  • get_redirect_analytics: total de acessos, tempo médio de resposta e detalhamento diário para um redirecionamento (somente leitura)
  • get_redirect_traffic_trends: acessos ao longo do tempo para um redirecionamento com granularidade configurável (somente leitura)

Escopos de Permissão

Quando você autoriza um cliente MCP, verá uma tela de consentimento listando os escopos que o cliente está solicitando. Cada ferramenta requer um dos seguintes escopos:

  • read:hosts: necessário para list_hosts, get_host, check_dns, check_ssl
  • write:hosts: necessário para create_host, update_host, delete_host, enable_ssl
  • read:redirects: necessário para list_redirects, get_redirect
  • write:redirects: necessário para create_redirect, update_redirect, delete_redirect
  • read:analytics: necessário para get_hosts_analytics, get_traffic_trends, get_host_traffic_trends, get_redirect_analytics, get_redirect_traffic_trends

Os tokens emitidos para um cliente MCP são limitados à sua própria conta. Se uma chamada de ferramenta é bem-sucedida ainda depende do seu plano. Consulte preços para planos que incluem acesso à API.

Início Rápido

Claude.ai e Claude Desktop

Adicione RedirectBoss como um conector personalizado nas configurações do Claude:

  1. Abra as configurações do Claude e navegue até a seção Conectores.
  2. Adicione um novo conector personalizado.
  3. Defina a URL do servidor como https://mcp.redirectboss.com/mcp.
  4. Quando solicitado, faça login na sua conta RedirectBoss e aprove os escopos solicitados na tela de consentimento.

Após a conexão, as ferramentas listadas acima ficam disponíveis para o Claude. Você pode fazer solicitações em linguagem natural como "liste todos os meus hosts", "crie um redirecionamento 301 de /old para https://new.com/new em example.com", "verifique se DNS e SSL estão funcionando para shop.example.com" ou "mostre minhas tendências de tráfego deste mês" e o Claude chamará as ferramentas apropriadas.

Claude Code

Adicione o servidor à configuração MCP de um projeto:

{
    "mcpServers": {
        "redirectboss": {
            "url": "https://mcp.redirectboss.com/mcp"
        }
    }
}

Salve isso como .mcp.json no seu projeto, ou adicione o servidor via claude mcp add. No primeiro uso, o Claude Code abrirá seu navegador para concluir o fluxo de autorização OAuth.

Outros clientes MCP

Os padrões acima (uma URL de servidor para clientes hospedados, ou uma entrada de configuração JSON apontando para https://mcp.redirectboss.com/mcp para clientes estilo CLI) funcionam com qualquer cliente que use o transporte HTTP Streamable e se identifique com um Documento de Metadados de ID do Cliente. Consulte a documentação MCP do seu cliente para os passos exatos de configuração.

Como Funciona a Autorização

A autorização segue o fluxo de código de autorização OAuth 2.1 com PKCE, usando Documentos de Metadados de ID do Cliente para identidade do cliente:

  1. O cliente MCP descobre nosso servidor de autorização via metadados de recurso protegido OAuth publicados pelo servidor MCP.
  2. O cliente se identifica com seu próprio Documento de Metadados de ID do Cliente, uma URL HTTPS que ele controla. Essa URL serve JSON declarando seu nome, seu site e os destinos de redirecionamento que ele pode usar, e é o identificador do cliente; não há nada para o cliente registrar conosco.
  3. Você faz login no RedirectBoss e vê uma tela de consentimento mostrando o nome do cliente e a URL do seu documento de metadados, o destino de redirecionamento para onde você será enviado de volta e os escopos que ele está solicitando. Você pode aprovar ou negar.
  4. Após a aprovação, o cliente troca o código de autorização por um token de acesso limitado à sua conta, provando com PKCE que ele possui o segredo com o qual o fluxo começou.
  5. O token de acesso é incluído em cada solicitação MCP subsequente e validado no lado do servidor. Os tokens de acesso são de curta duração; os clientes mantêm um token de atualização para obter novos sem enviá-lo de volta pelo login.

Verifique a URL do documento de metadados na tela de consentimento antes de aprovar: é a parte da identidade de um cliente que ele não pode falsificar, pois deve servir o documento a partir desse endereço. O nome ao lado é o que o cliente diz ser. Os tokens de acesso são limitados apenas à sua conta, e nenhuma senha ou segredo de longo prazo é enviado ao cliente MCP.

Construindo um cliente MCP? O documento do nosso próprio cliente de monitoramento é um exemplo prático: /.well-known/oauth/mcp-smoke-client.json.

Limites de Taxa

As chamadas MCP compartilham os mesmos limites de taxa que o acesso direto à API:

  • 5.000 solicitações por hora (entre leituras e escritas)
  • 1.000 operações de escrita por dia

Exceder esses limites retorna uma resposta HTTP 429, que o cliente MCP exibirá como erro e tentará novamente após o intervalo de Retry-After.

Revisando e Revogando Acesso

Você pode ver todos os clientes MCP autorizados na sua conta e revogar o acesso a qualquer momento no seu painel em Preferências → Aplicativos Conectados. Revogar um cliente encerra sua autorização para ele: seu token de atualização para de funcionar imediatamente, e qualquer token de acesso já emitido pode levar até 10 minutos para deixar de ser aceito. A revogação se aplica à sua própria conta. Ela não afeta outros usuários que autorizaram o mesmo cliente, e cobre todos os lugares onde você usa esse cliente, pois todos usam a mesma concessão para sua conta. Consulte a seção de Política de Privacidade sobre acesso de terceiros para a política completa.

Solução de Problemas

"Acesso à API não permitido"

Seu plano atual não inclui acesso à API. Consulte nossa página de preços para planos que suportam isso e entre em contato com support@redirectboss.com para alterar seu plano.

Tela de consentimento mostra escopos errados

Os escopos mostrados na tela de consentimento são os que o cliente MCP solicitou. Você pode aprovar um subconjunto se seu cliente suportar, ou recusar a solicitação e relatar o problema ao fornecedor do cliente.

Chamada de ferramenta retorna 403 "escopo insuficiente"

O cliente autorizado não possui o escopo necessário para essa ferramenta, geralmente porque um conjunto mais restrito foi aprovado na tela de consentimento. Reconecte o cliente e aprove os escopos que as ferramentas que você deseja precisam.

Suporte

Dúvidas ou problemas ao integrar o servidor MCP? Envie um e-mail para support@redirectboss.com. Para a API REST subjacente, consulte a referência da API.