Guia

Ligar o Claude Code e o Cursor ao WordPress

O Claude Code e o Cursor ligam-se ao AlphaBridge com um token. O plugin cria-o e mostra um comando pronto para o Claude Code e uma configuração para o Cursor.

Antes de começar

Do que precisa.

  • Um site WordPress com o AlphaBridge. WordPress 6.5 e PHP 8.0 ou mais recente. Para começar, basta o plugin gratuito.
  • Uma conta de administrador. Cria a ligação em «Definições → AlphaBridge MCP».
  • Claude Code ou Cursor. O Claude Code liga-se diretamente ao endpoint. O Cursor executa a configuração pronta, que exige Node.js 18 ou mais recente.
Passo a passo

Em 6 passos.

Instale o AlphaBridge

Adicione o plugin a partir do painel do WordPress, como qualquer outro plugin, e ative-o.

Escolha o seu cliente

Abra «Definições → AlphaBridge MCP». Em «Ligue o seu assistente de IA», escolha «Cursor», ou «Outro» para o Claude Code.

Crie a ligação

Clique em «Criar ligação». Em «Nome, utilizador, acesso, expiração (opcional)», pode dar-lhe um nome, limitar o acesso e definir uma expiração. Sem alterações, fica com acesso total, em seu nome, e sem expiração.

Copie logo o comando ou a configuração

O plugin mostra agora o Bearer token, o «Comando para o Claude Code» e a «Configuração para o Cursor». As versões mais antigas mostram uma única configuração para ambos. Copie já o que o seu cliente precisa. O token só é mostrado por inteiro uma vez.

Adicione-a ao seu cliente

Claude Code: na pasta do seu projeto, execute o «Comando para o Claude Code» do plugin. Já contém o seu endpoint e o seu token. Se o plugin ainda não mostrar esse comando, execute o comando claude mcp add abaixo com o seu endpoint e o seu token. Cursor: cole a configuração em ~/.cursor/mcp.json para todos os projetos, guarde e recarregue os servidores. Se o ficheiro já listar servidores, acrescente apenas a entrada alphabridge dentro de mcpServers.

Verifique e pergunte

No Claude Code, /mcp mostra o estado do servidor. Depois, faça uma primeira pergunta, por exemplo que páginas ainda são rascunhos. As alterações esperam até um administrador ativar o acesso de escrita.

Configuração

Um comando para o Claude Code, uma configuração para o Cursor

O plugin mostra ambos, com o seu endpoint e o seu token já preenchidos.

Para o Claude Code, o plugin mostra este comando com o seu endpoint e o seu token. Se o seu plugin ainda não o mostrar, insira manualmente o Endpoint URL e o Bearer token.

claude mcp add --transport http alphabridge https://your-site.tld/wp-json/alphabridge/v1/mcp --header "Authorization: Bearer YOUR-TOKEN"

O Claude Code fala então diretamente com o seu endpoint por HTTP, sem Node.js.

Para o Cursor, o plugin mostra uma configuração pronta, com este aspeto.

{
  "mcpServers": {
    "alphabridge": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-site.tld/wp-json/alphabridge/v1/mcp", "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer YOUR-TOKEN" }
    }
  }
}

No Cursor, o npx inicia o auxiliar mcp-remote, que envia cada pedido para o seu endpoint, com o seu token no cabeçalho Authorization.

Deixe Authorization:${AUTH} como está. O token fica na linha env, a seguir à palavra Bearer.

Para um segundo site, crie também lá uma ligação. Adicione-a com outro nome, por exemplo alphabridge-shop.

Token

Guarde o token em segurança

  • O token só é mostrado por inteiro uma vez. O site guarda apenas um hash dele.
  • Perdeu-o? Renove a ligação em «As suas ligações». O token antigo deixa de funcionar de imediato.
  • Escolha o nível de acesso «só leitura» ou «só conteúdo» quando um cliente não deve poder fazer tudo.
  • Defina uma expiração em dias para acessos que devem terminar.
  • O Claude Code guarda um servidor adicionado com claude mcp add em ~/.claude.json, para este projeto e só para si.
  • Cada pedido é executado com os direitos do utilizador do WordPress em nome do qual a ligação atua.
  • O acesso de escrita vale para todas as ligações do site, incluindo esta. As alterações passam a ter efeito imediato e podem ser destrutivas. Ativá-lo é por conta e risco do proprietário.
Pedidos

O que pedir no Claude Code ou no Cursor

As ferramentas gratuitas cobrem os conteúdos. O Pro e o Agency acrescentam código e implementação.

  • Liste as páginas do meu site com o estado e a última alteração.
  • Leia a estrutura da página inicial e liste os títulos e os botões.
  • Que plugins e temas têm atualizações à espera?
  • Crie um rascunho de artigo a partir das notas em notes.md.
  • Mostre-me o style.css do tema ativo.
  • Implemente a pasta build no site por SFTP.

Os três primeiros só leem. O quarto precisa de acesso de escrita. O quinto precisa do Pro e de acesso de escrita. O último precisa do Agency, do Site Deploy configurado e de acesso de escrita.

Outros clientes

Outros clientes MCP e scripts

Qualquer cliente MCP que fale Streamable HTTP e consiga enviar um cabeçalho pode usar o endpoint diretamente. Envie o token em cada pedido como Authorization: Bearer ….

Se um cliente remover o cabeçalho Authorization, envie antes o token como X-Api-Key.

O Claude na web, no Desktop e no iOS liga-se sem token. Em vez disso, aprova no seu site, como mostra a página do conector.

FAQ

Perguntas e respostas.

O Claude Code e o Cursor precisam de um token?

Sim. O plugin cria um para eles na página de definições, juntamente com o comando para o Claude Code e a configuração para o Cursor. O Claude na web e o ChatGPT aprovam no seu site em vez disso.

Que nível de acesso devo escolher?

Com só leitura, o cliente vê o que a conta pode ver e não altera nada. Com só conteúdo, também altera artigos, páginas, multimédia, termos e comentários. O nível total acrescenta definições e administração. Seja qual for a escolha, é o interruptor de acesso de escrita do site que decide se algo é escrito.

Perdi o token. E agora?

Renove a ligação em «As suas ligações», na página de definições do AlphaBridge MCP. Recebe um novo token com um novo comando e uma nova configuração. O token antigo deixa de funcionar de imediato.

O Claude Code continua a mostrar a lista antiga de ferramentas. O que ajuda?

Os clientes podem manter a lista de ferramentas que carregaram. No Claude Code, execute /mcp e volte a ligar o servidor.

Preciso do Pro para o Claude Code?

Não. O plugin gratuito dá ao Claude Code 40 ferramentas. O Pro traz 135 ferramentas a um site, incluindo ficheiros de temas e plugins. O Agency traz as 143 ferramentas e o Site Deploy por SFTP a até 10 sites.

O Pro no seu site WordPress. Com um caminho de volta.

O Pro traz 135 ferramentas ao seu site e um caminho de volta para páginas e ficheiros. O período experimental não pede cartão.