Cursor, VS Code com GitHub CoPilot, Claude Código, Codex, código ROO e a maioria dos outros MCP Clientes lêem seus servidores de um arquivo de configuração. Eles não executam um login OAuth, então PageForge fornece um token de acesso pessoal. O cliente envia o token em um cabeçalho de solicitação em cada chamada.
Crie um token
- Vá para PageForge > conexões e certifique-se de que MCP esteja habilitado.
- Em Outros MCP Clientes (Token de acesso pessoal), clique em Criar token de acesso pessoal.
- A caixa de diálogo Pessoal de acesso criada é aberta. Clique em Copy Token. PageForge Armazena apenas um hash dele e não pode mostrá-lo novamente.
- Em Configuração do cliente, escolha a guia do cliente: vs código / GitHub CoPilot, Cursor, Claude código ou genérico MCP Cliente.
- Clique em Copy Configuration e cole-o no arquivo de configuração desse cliente.
- Reinicie o cliente e pergunte: "Mostrar meu PageForge Status do site."
A caixa de diálogo também mostra os escopos do token e expires. Os tokens não expiram por conta própria, então revogue um token quando você não precisar mais dele.
Configurações de exemplo
Para Cursor, em .cursor/mcp.json:
{
"mcpServers": {
"pageforge": {
"url": "https://example.com/wp-json/pageforge/v1/mcp",
"headers": {
"X-PageForge-MCP-API-Key": "pfmcp_YOUR_TOKEN_HERE"
}
}
}
}
Para o código VS e o copiloto do GitHub, em .vscode/mcp.json:
{
"servers": {
"pageforge": {
"type": "http",
"url": "https://example.com/wp-json/pageforge/v1/mcp",
"headers": {
"X-PageForge-MCP-API-Key": "pfmcp_YOUR_TOKEN_HERE"
}
}
}
}
Claude O código usa .mcp.json com a mesma forma mcpServers de Cursor mais "type": "http". Substitua o URL pelo seu próprio terminal e o espaço reservado pelo seu token.
Qual cabeçalho usar
| Cabeçalho | Formato |
|---|---|
X-PageForge-MCP-API-Key | O token por conta própria. Isso é o que as configurações copiadas usam. |
Authorization | Bearer seguido por um espaço e o token |
Envie um ou outro, não ambos. Uma solicitação que carrega ambos é rejeitada. Nunca coloque um token no URL ou em uma string de consulta. PageForge Só lê tokens de cabeçalhos.
Como os tokens são protegidos
- Cada token pertence ao administrador que o criou e age com as permissões WordPress dessa pessoa.
- PageForge Armazena um hash com chave, para que o token não seja lido de volta do banco de dados.
- No Free, um token só pode ler e visualizar. No Pro, você escolhe seu acesso em Acesso que este token pode usar antes de criá-lo.
Gerenciar tokens
Cada token é listado em Tokens de acesso pessoal com seu status: “Credencial ativo · Nunca usado”, Use, revogado ou expirado.
- Rotate emite um novo token para o mesmo cliente. O velho para de trabalhar imediatamente. Atualize a configuração do cliente com o novo token.
- Revoke encerra o acesso imediatamente.
Importante Um arquivo de configuração com um token é uma senha. Não o comprometa com um repositório compartilhado. Se um laptop com um token for perdido, revogue esse token.
A seguir: escopos, permissões e segurança e ai Assistant não conseguem se conectar.
