Respira for WordPress

Respira WordPress MCP Server

Ferramentas MCP e recursos do WordPress em 18 construtores de páginas. A camada de infraestrutura de IA para WordPress.
Edição em nível de elemento, criação completa de páginas, conversão de HTML e Figma para construtores nativos, direções de design, memória do site, varredura de acessibilidade e segurança, governança por ferramenta, snapshots e rollback.

Website • Docs • Plugin • Configuração do MCP • Skills • Suporte

O que este repositório é, e o que não é

Este repositório é a listagem pública para o servidor MCP Respira WordPress. O código-fonte do servidor é distribuído no npm como @respira/wordpress-mcp-server. Esse código de wrapper é licenciado sob MIT e você é bem-vindo para ler, fazer fork ou incorporá-lo.

O servidor é um cliente para o plugin Respira WordPress, não um produto independente. Para fazer trabalho real, ele precisa de:

• O plugin Respira for WordPress instalado no seu site
• Uma chave de API Respira válida vinculada a uma licença

O plugin não é open source. Ele é distribuído sob uma licença comercial. Teste gratuito em respira.press, sem necessidade de cartão. Planos pagos começam em 9 EUR por mês.

Em resumo: o wrapper que você npx -y é aberto. O produto por trás dele não é, e isso é intencional. Se você quer uma stack autônoma de "IA edita WordPress" sem dependência comercial, este não é o caso. O plugin é construído e mantido em tempo integral por uma pessoa, e as taxas de licença são como isso acontece.

Para relatórios de segurança, veja SECURITY.md.

O que torna o Respira diferente

A maioria dos servidores MCP para WordPress envolve a REST API. Eles podem criar posts e páginas, mas não conseguem tocar no conteúdo dos construtores de páginas, que é onde o site real vive.

O Respira inclui um plugin WordPress que dá a um agente de IA acesso nativo às estruturas de dados do próprio construtor, além das proteções de segurança que tornam a escrita em um site ao vivo viável.

Início rápido

1. Instale o plugin WordPress

Baixe de respira.press/plugin, envie para o WordPress, ative e depois vá para Respira > API Keys e gere uma chave.

2. Conecte sua ferramenta de IA

O caminho mais rápido é o comando gerado em respira.press/dashboard/mcp, que preenche seu site e chave para você. Configurações manuais abaixo.

claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

npx add-mcp "npx -y @respira/wordpress-mcp-server"

3. Adicione seu site

Execute o assistente:

npx @respira/wordpress-mcp-server --setup

Ou escreva ~/.respira/config.json você mesmo:

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true
    }
  ]
}

Reinicie sua ferramenta de IA e comece a editar.

Enfrentando um limite de ferramentas do cliente?

Alguns clientes MCP limitam o número de ferramentas ativas, geralmente em 100. O Respira anuncia muito mais do que isso, então adicione enabledTools à sua configuração e apenas essas aparecerão na listagem:

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

Ferramentas de gerenciamento de site (respira_list_sites, respira_switch_site, respira_get_active_site) estão sempre incluídas. Ferramentas não listadas ainda funcionam se chamadas diretamente. O filtro apenas controla o que é anunciado.

Além disso, o servidor filtra a lista de ferramentas pelo que seu site realmente executa. Um site Divi sem WooCommerce não vê as ferramentas de comércio. A detecção falha de forma aberta: se não conseguir identificar, você recebe a lista completa.

18 construtores de páginas suportados

level é a profundidade de escrita do Respira, não a qualidade do construtor.

Sites com construtores mistos são tratados por página, não por site.

O que as ferramentas cobrem

A referência completa está na documentação. As famílias:

Todas as ferramentas usam nomes respira_*. Os aliases legados wordpress_* estão obsoletos e serão removidos.

O que os números significam

As contagens atuais estão no catálogo de ferramentas ao vivo, contadas a partir do código em cada lançamento: ferramentas MCP para o produto inteiro e para cada plano, as ferramentas do add-on WooCommerce e as Abilities do WordPress. Elas descrevem o catálogo em um site totalmente habilitado, não o que seu cliente listará.

Um tools/list ao vivo retorna menos do que o total do catálogo, e isso é comportamento correto, não um recurso ausente. O servidor filtra o catálogo por contexto por site, então ferramentas Bricks nunca chegam a um site Elementor e as ferramentas de comércio permanecem ocultas sem WooCommerce. Um site com tema de blocos sem construtor de páginas vê ainda menos ferramentas principais.

O registro de Abilities não é filtrado por contexto, então no mesmo site o total de abilities excede legitimamente o total de ferramentas. Os dois não são diretamente comparáveis.

Skills incluídas

O pacote inclui as skills do Claude Code do Respira, que são as receitas que tornam as ferramentas úteis em conjunto: migrações de construtores de páginas (Divi para Bricks, Elementor para Gutenberg, WPBakery para Bricks e outras), conversão Figma para construtor, auditorias de site, passagens de SEO e AEO e fluxos de trabalho WooCommerce.

npx @respira/wordpress-mcp-server install-skills

Navegue pelo catálogo em respira.press/skills.

Segurança

Escrever em um site de produção ao vivo é o problema central. As proteções:

1. Snapshot antes de cada mutação. Restaure com respira_restore_snapshot, compare com respira_diff_snapshots.
2. Duplicar antes de editar. O original permanece intocado enquanto o agente trabalha em uma cópia.
3. Governança por ferramenta. Administradores habilitam ou desabilitam ferramentas individuais a partir do wp-admin. A governança se aplica ao caminho REST, ao caminho da API de Abilities e ao WebMCP igualmente.
4. Modo somente leitura. Aponte um agente para um site e deixe-o olhar sem permitir que escreva.
5. Log de atividades. Cada chamada é registrada e legível a partir do wp-admin e de respira_list_activity.

Ecossistema de IA do WordPress

O Respira funciona com a stack oficial de IA do WordPress, não ao redor dela.

Inhale é o plugin complementar gratuito que registra um pequeno conjunto de Abilities sem nenhuma conta Respira, se você quiser experimentar o caminho de Abilities antes de qualquer outra coisa.

Opções de instalação

npx

npx -y @respira/wordpress-mcp-server

Instalação zero, boa para experimentar. A desvantagem é que o cache do npx pode se corromper após uma instalação interrompida, um disco externo desconectado ou quarentena do antivírus, e os erros resultantes de ENOENT são confusos. Consulte Solução de problemas.

Instalação global (mais estável)

npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

Evita completamente o cache do npx. A melhor escolha para uso diário.

Opções de linha de comando

Variáveis de ambiente

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILE e RESPIRA_CONFIG_B64 são as alternativas para vários sites.

Plugin Grok Build

Este repositório também é a fonte do plugin Respira para Grok Build. O plugin é pequeno de propósito. Ele envia dois arquivos e nada mais:

• .grok-plugin/plugin.json, o manifesto.
• .mcp.json, uma definição de servidor MCP: npx -y @respira/wordpress-mcp-server, o mesmo pacote que este README descreve.

Não possui habilidades, comandos, agentes, ganchos ou scripts de instalação.

Antes do primeiro uso. Instale o plugin Respira for WordPress no site e execute npx @respira/wordpress-mcp-server --setup uma vez. Isso grava a lista de sites em ~/.respira/config.json, que o servidor lê quando o Grok Build o inicia. Sem nenhum site nesse arquivo, o servidor inicia com uma ferramenta, respira_redeem_token, que recebe um código de configuração de respira.press/dashboard/mcp e grava a lista de sites para você.

Endpoints de rede que o servidor chama.

Credenciais. Uma chave de site Respira por site, mantida em ~/.respira/config.json na sua máquina (ou WORDPRESS_URL e WORDPRESS_API_KEY para um único site). A chave vai somente para o site ao qual pertence, em um cabeçalho de solicitação. O plugin WordPress a verifica; o servidor não lê chaves SSH, arquivos .env ou outros tokens.

Sem o plugin. O Grok Build também pode acessar um site diretamente, um comando por site: consulte respira.press/integrations/grok.

Verificação de integridade

npx @respira/wordpress-mcp-server --doctor

Verifica a versão do Node, o arquivo de configuração, a conectividade do site, a versão do plugin, a compatibilidade da API e as atualizações disponíveis, e relata aprovação ou falha por verificação com algo que você possa usar. Adicione --json para pipelines de CI.

Solução de problemas

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

Segurança

A validação da chave da API acontece no lado do servidor, no plugin WordPress. O servidor MCP repassa as credenciais e não as armazena nem valida.

Relate vulnerabilidades para security@respira.press. Política completa em SECURITY.md.

Links

• Site
• Documentação
• Baixar o plugin
• Configuração do MCP
• Catálogo de habilidades
• Recursos
• Complemento WooCommerce
• Complemento de scanner de acessibilidade
• Suporte

Onde encontrar o Respira

Licença

MIT © Respira

O catálogo completo de ferramentas, contado a partir do código: respira.press/tools. A camada de infraestrutura de IA para WordPress.
respira.press