Servidor MCP: ChatGPT, Claude e outras apps de IA

O servidor MCP do Rankfender conecta os seus projetos a apps de IA como Claude, ChatGPT, Claude Code e Cursor. MCP (Model Context Protocol) é o padrão aberto que esses apps usam para chamar outros softwares. O assistente pode ler o seu projeto e, se você permitir, fazer alterações, sempre depois de perguntar a você.

Quem pode usar

Projetos cujo proprietário tem o plano Professional, Business ou Agencies. Os membros da equipe usam o plano do proprietário: proprietários, administradores e editores podem permitir alterações; visualizadores só podem ler. Veja Planos.

Conectar um app de IA

Use o mesmo URL em todos os apps. O app abre uma página de login do Rankfender e depois uma página de consentimento onde você escolhe os projetos (todos, incluindo os futuros, ou só os que marcar), se o app pode fazer alterações e se também pode publicar no seu site.

https://app.rankfender.com/mcp

Claude (claude.ai e Claude Desktop)

1. Abra Customize → Connectors e clique em Add custom connector. O Claude Desktop tem a mesma página.
2. Cole o URL acima e clique em Add.
3. Entre no Rankfender quando o Claude pedir (o Claude Desktop abre a página no seu navegador), escolha os seus projetos e o que o Claude pode fazer, e clique em «Permitir».
4. Em uma conversa, ative o Rankfender no menu de ferramentas (tools menu). Nos planos Team e Enterprise, um proprietário primeiro o adiciona em Organization settings → Connectors (Add → Custom → Web), e depois cada membro clica em Connect. O plano Free permite um conector personalizado.

ChatGPT

1. No chatgpt.com, abra Plugins, clique em + e escolha Add custom MCP server.
2. Dê o nome Rankfender, cole o URL acima como Server URL e escolha OAuth.
3. Aceite o aviso e crie-o como plugin; depois entre no Rankfender, escolha os seus projetos e o que o ChatGPT pode fazer, e clique em «Permitir».
4. Em uma conversa, digite @ e escolha Rankfender. Em um espaço de trabalho, pode ser preciso que um administrador permita servidores MCP personalizados.

Claude Code

Adicione o servidor (acrescente --scope user para usá-lo em todos os projetos), depois digite /mcp no Claude Code, escolha rankfender e Authenticate. O seu navegador abre a página de login do Rankfender.

claude mcp add --transport http rankfender https://app.rankfender.com/mcp

Cursor e outros apps MCP

Adicione o Rankfender a ~/.cursor/mcp.json (todos os projetos) ou a .cursor/mcp.json (um projeto). O Cursor encontra a página de login sozinho: entre no Rankfender, escolha os seus projetos e clique em «Permitir». Qualquer outro app compatível com servidores MCP remotos (streamable HTTP) com login OAuth funciona da mesma forma com o URL acima.

{
  "mcpServers": {
    "rankfender": { "url": "https://app.rankfender.com/mcp" }
  }
}

Com uma chave de API de projeto (só leitura)

Para apps que não conseguem fazer login, use uma chave de API de projeto em Configurações → Integrações (veja A sua chave de API). Uma chave dá acesso só de leitura ao seu único projeto, seja qual for a função do usuário. Envie-a como Authorization: Bearer ou no cabeçalho X-Rankfender-Key.

claude mcp add --transport http rankfender https://api.rankfender.com/functions/v1/mcp \
  --header "Authorization: Bearer rfk_your_key"

O que o app pode fazer

• Só leitura, a não ser que «Permitir que … faça estas alterações» tenha sido marcado na página de consentimento. Publicar exige uma terceira opção, «Permitir que … publique no seu site», desmarcada por padrão. Para mudar qualquer uma delas, conecte o app de novo.
• As alterações exigem direitos de proprietário, administrador ou editor no projeto. Visualizadores e chaves de API só podem ler.
• Ações pagas e ações com avisos (uma palavra-chave fora da intenção, um artigo que já mira uma palavra-chave quase idêntica) respondem primeiro com o custo, o saldo do proprietário e os avisos, sem mudar nada. O app precisa chamar de novo com confirm: true depois que você concordar.
• Nada é apagado. Remover uma palavra-chave, um concorrente ou uma pergunta acompanhada só a oculta e pode ser desfeito; os artigos só podem ser tirados do calendário; o texto editado mantém a versão anterior.
• Sem a opção de publicação, o seu site não muda: um artigo editado só chega a ele quando alguém clica em «Atualizar no seu site» no Rankfender.
• Cada número vem com a data de medição e a fonte. No get_portfolio, valores com mais de 30 dias são marcados como desatualizados.

Publicar no seu site

• publish_article publica um artigo, ou atualiza um já publicado com o texto mais recente (o mesmo que «Atualizar no seu site» no app do Rankfender). Exige as duas opções.
• Usa o site conectado no Rankfender: WordPress (plugin do Rankfender) ou Modern Web (webhook).
• A primeira chamada diz o que vai acontecer, em qual site, e o custo (cerca de 1 crédito, pela verificação de publicação). Nada é enviado até o app chamar de novo com confirm: true.
• A verificação de publicação do Rankfender roda primeiro, como no app do Rankfender. Se ela retiver o artigo, nada é publicado: o app recebe os motivos e um link para corrigi-los no Rankfender. «Publicar mesmo assim» continua só no app do Rankfender.
• Nunca despublica. Depois de publicar, a resposta dá o URL publicado ou diz que a página ainda não está no ar.

Ferramentas de leitura

As ferramentas de leitura não usam créditos e nunca medem nada de novo. Quando você vê vários projetos, o app passa o id ou o domínio do projeto para cada ferramenta.

Ferramentas de alteração

As ferramentas de alteração só aparecem se «Permitir que … faça estas alterações» tiver sido marcado; publish_article também exige «Permitir que … publique no seu site». O app pergunta a você antes de cada uma. Os créditos saem da conta do proprietário do projeto. Os números abaixo são as estimativas atuais do Rankfender; cada ferramenta paga informa a estimativa exata e o saldo antes de agir.

Prompts prontos para usar

O servidor oferece quatro prompts que guiam o app pelas ferramentas. Os apps compatíveis com prompts MCP os mostram no seu menu de prompts.

Enviar uma tarefa do Planejamento para um app de IA

No quadro de Planejamento, «Enviar para a IA» em uma tarefa abre o Claude ou o ChatGPT com um prompt pronto, ou o copia para o Claude Code ou o Cursor. O app lê a tarefa com get_task, faz o trabalho com as ferramentas do Rankfender (perguntando a você antes de cada alteração) e depois a marca como concluída com update_task_status. Se a caixa do chat abrir vazia, cole: o prompt já está copiado. Aparece nos projetos cujo proprietário tem o plano Professional ou superior.

Limites

Desconexão, dados e suporte

Para parar um app, abra Configurações da conta → Chaves API → Aplicações de IA ligadas e clique em Desligar: ele perde o acesso na hora, e os seus projetos e dados ficam como estão. O Rankfender só envia dados do projeto ao app que você conectou, quando ele chama uma ferramenta; a política de privacidade descreve o que é armazenado. Dúvidas ou problemas: support@rankfender.com ou a página de suporte.

Solução de problemas