Referência do servidor MCP #

O Revolink suporta o Model Context Protocol (MCP): um padrão aberto que permite que assistentes de IA (Claude, Cursor, Windsurf e outros) interajam com serviços externos como ferramentas.

Depois de configurado, o seu assistente de IA pode criar links, atualizar regras de roteamento e consultar análises sem que você precise sair do chat.

Endpoint #

POST https://api.revolink.link/apiv1/mcp

Transporte: Streamable HTTP (sem estado, uma requisição por chamada de ferramenta).

Autenticação #

O MCP do Revolink suporta duas formas de conexão. Escolha a que combina com o seu caso:

Método 1: chave de API #

Gere uma chave em Perfil → Integrações, ative as permissões (scopes) de MCP de que precisa e informe-a na configuração do seu cliente. Veja Configuração abaixo para as instruções de cada cliente.

Erros:

Método 2: OAuth 2.0 #

Para clientes como o claude.ai (web) que suportam OAuth: não é preciso chave. Você aprova o acesso uma vez e o cliente cuida de tudo automaticamente.

Como conectar (claude.ai na web):

1. Vá em Settings → Integrations no claude.ai.
2. Clique em Add MCP server.
3. Cole: https://api.revolink.link/apiv1/mcp
4. Clique em Connect: você será redirecionado ao Revolink para aprovar o acesso.
5. Pronto. As ferramentas do Revolink já estão disponíveis no seu chat.

Para revogar o acesso a qualquer momento: Perfil → Aplicativos conectados → Revogar.

Permissões do MCP #

As permissões do MCP são independentes das permissões normais da API. Uma chave pode ter acesso total à API e nenhum ao MCP, ou o contrário. Permissões (scopes) disponíveis:

Na autenticação por chave de API, as permissões são configuradas por chave em Perfil → Integrações → MCP no aplicativo.

No OAuth, as permissões são solicitadas pelo cliente e aprovadas pelo usuário durante o fluxo de consentimento.

Configuração #

Chave de API: passo a passo #

1. Vá em Perfil → Integrações no aplicativo Revolink.
2. Clique em Criar chave de API.
3. Dê um nome à chave (por ex. Claude MCP).
4. Em MCP, ative as permissões que quer conceder. Cada permissão pode ser ativada de forma independente.
5. Clique em Criar e copie a chave: ela é exibida apenas uma vez.

Uma chave com MCP ativado mas sem permissões de MCP selecionadas será rejeitada no endpoint do MCP com um erro 403.

Configure o seu cliente de IA (chave de API) #

{
  "mcpServers": {
    "revolink": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.revolink.link/apiv1/mcp",
        "--header",
        "X-Api-Key:YOUR_API_KEY"
      ]
    }
  }
}

claude mcp add --transport http revolink https://api.revolink.link/apiv1/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

{
  "mcpServers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "revolink": {
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "${input:revolinkApiKey}"
      }
    }
  },
  "inputs": [
    {
      "id": "revolinkApiKey",
      "type": "promptString",
      "description": "Revolink API Key",
      "password": true
    }
  ]
}

{
  "context_servers": {
    "revolink": {
      "settings": {
        "url": "https://api.revolink.link/apiv1/mcp",
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

Configure o seu cliente de IA (OAuth) #

https://api.revolink.link/apiv1/mcp

Espaços de trabalho: seleção automática #

Você nunca precisa informar um ID de espaço de trabalho manualmente. Quando você envia uma requisição sem escolher um espaço de trabalho, o servidor devolve uma lista dos seus espaços de trabalho disponíveis. A IA escolhe o certo com base no contexto e continua a operação automaticamente. Do seu ponto de vista isso é invisível: basta descrever o que precisa em linguagem natural.

Ferramentas disponíveis #

list_links #

Retorna uma lista paginada dos links de um espaço de trabalho.

Permissão necessária: links:read

get_link #

Retorna todos os detalhes de um link, incluindo as regras de roteamento.

Permissão necessária: links:read

create_link #

Cria um novo link inteligente com regras de roteamento.

Permissão necessária: links:write

Exemplo de pedido:

«Crie um link chamado "Product Hunt Launch" que envie visitantes de computador para a landing page de desktop e visitantes de celular para a landing page mobile.»

update_link #

Atualiza um link existente. Inclua apenas os campos que quer alterar.

Permissão necessária: links:write

Os mesmos parâmetros de create_link, além de:

Quando rules é informado, todo o array de regras é substituído. Inclua todas as regras que quer manter, não só as alteradas. A IA busca internamente os IDs das regras existentes antes de atualizar.

delete_link #

Exclui um link de forma permanente.

Permissão necessária: links:delete

bulk_create_links #

Cria vários links em uma única requisição. Sujeito à cota de links do plano.

Permissão necessária: links:bulk

A resposta inclui os arrays created (bem-sucedidos) e failed (com falha, com o motivo), então é possível um sucesso parcial.

get_link_analytics #

Retorna as análises de cliques de um link, detalhadas por país, dispositivo, navegador, SO, regra de roteamento e variante A/B.

Permissão necessária: analytics:read

get_workspace_analytics #

Retorna as análises de cliques agregadas de todos os links de um espaço de trabalho.

Permissão necessária: analytics:read

Objeto de regra #

Todo link deve ter pelo menos uma regra. Exatamente uma regra deve ter isDefault: true: é a reserva quando as condições de nenhuma outra regra são atendidas. A regra padrão não pode ter nenhuma condição.

Objeto de teste A/B #

Quando abTest.enabled é true, os cliques são divididos entre as variantes de acordo com os pesos. As regras de roteamento ainda se aplicam primeiro: a divisão A/B só acontece para os visitantes que correspondem a uma determinada regra.

Variante:

Tratamento de erros #

O servidor MCP retorna erros JSON-RPC padrão. Os erros no nível da ferramenta usam estes códigos:

Erros no nível HTTP (antes de a ferramenta ser chamada):

Exemplos de chamadas de ferramentas #

Liste seus links:

«Mostre todos os links do meu espaço de trabalho com a tag summer-sale.»

Crie um link com segmentação geográfica:

«Crie um link chamado "App Download". Envie usuários de iOS para a App Store, os de Android para o Google Play e todos os outros para o site.»

Atualize as regras de roteamento:

«Atualize o link 664a1b2c…: adicione uma regra que redirecione visitantes da Alemanha para https://de.example.com.»

Obtenha as análises da semana passada:

«Quais foram os principais países do link 664a1b2c… na semana passada?»