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.
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.
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.
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.
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 addem ~/.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.
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 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.
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.
Continue a ler.
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.