MCP Adapter

wp plugin install mcp-adapter --activate

Registro de alterações

0.7.1 – 2026-10-15

Corrigido

• Bound stored session initialization parameters to 4 KiB and automatically recover oversized session data, preventing repeated database failures and excessive logging. Affected clients need to reconnect once. Client icons are excluded from storage so large inline icons do not prevent connections.
• Register the installed plugin’s autoloader before checking for bundled copies, allowing version selection before an older bundled class is loaded.
• Unknown ability names from MCP clients no longer generate WordPress developer notices.

Alterado

• Unavailable abilities return clearer errors with relevant available ability names or a pointer to discovery. Abilities not exposed through MCP return the same ability_not_found error as unknown names.

Adicionado

• A site-owner guide covers connecting an AI client, Application Passwords, and troubleshooting.

0.7.0 – 2026-10-02

Alterações incompatíveis

• O adaptador oferece exatamente duas revisões de esquema MCP: 2025-11-25 e 2026-07-28. Clientes que propõem 2025-06-18 ou 2024-11-05 ainda conseguem se conectar e são atendidos pelo esquema 2025-11-25.
• As classes DTO geradas, as classes McpToolValidator, McpResourceValidator e McpPromptValidator, além do filtro mcp_adapter_validation_enabled, foram removidos. A validação da comunicação sempre é feita pelo esquema selecionado.
• Os campos inválidos do protocolo não são mais descartados ou corrigidos silenciosamente. Componentes que não podem ser representados por nenhuma revisão compatível são rejeitados.
• Os transportes personalizados devem delegar para HttpRequestHandler ou McpWireOrchestrator. As solicitações em lote JSON-RPC são rejeitadas.
• As classes WP\MCP\Cli são final.

Adicionado

• Suporte ao MCP 2026-07-28, incluindo o ciclo de vida sem sessão de server/discover e os novos cabeçalhos HTTP.
• Ferramentas chamáveis diretamente podem solicitar dados de elicitação na revisão 2026-07-28 retornando McpInputRequired.
• McpRequestContext, um contexto imutável por solicitação que contém o esquema selecionado, o transporte e os dados da sessão.

Alterado

• O uso do MCP Adapter como biblioteca incorporada foi descontinuado. Instale o plugin MCP Adapter.

Corrigido

• mcp-adapter/get-ability-info serializa um input_schema vazio como {}, em vez de [].
• As habilidades padrão são registradas quando outro plugin inicializa a Abilities API antes da inicialização do servidor MCP.

Consulte o guia de migração da versão 0.7.0 e o CHANGELOG.md para ver a lista completa de alterações.

0.6.1 – 2026-08-13

Corrigido

• O ZIP da versão não inclui mais um mapa de classes do Jetpack Autoloader que aponta para arquivos ausentes no ZIP. Na versão 0.6.0, o mapa listava classes globais usadas apenas em testes, incluindo WP_CLI e WP_CLI_Command, e as associava a arquivos em tests/phpunit/, que não fazem parte do pacote de lançamento. Por isso, qualquer plugin que chamasse class_exists( 'WP_CLI' ) durante uma solicitação web comum poderia provocar um erro fatal não capturado. Agora, class_exists( 'WP_CLI' ) retorna false quando o WP-CLI não está disponível (#283).

O comportamento da API, dos hooks e do protocolo não mudou. Não é necessário migrar ao atualizar da versão 0.6.0. Instalações criadas a partir do código-fonte ou incluídas via Composer não foram afetadas.

0.6.0 – 2026-08-12

Alterações incompatíveis

• Agora é necessário usar o WordPress 6.9 ou versão posterior. A instalação do plugin independente Abilities API não é mais compatível.
• Agora, as habilidades com meta.public: true são expostas pelo servidor MCP padrão, a menos que meta.mcp.public desabilite explicitamente essa opção. Os callbacks de permissão e as verificações de capacidade existentes continuam sendo aplicados.
• Somente no Multisite, as sessões Streamable HTTP ativas precisam se reconectar uma vez após a atualização, pois o armazenamento das sessões passa de uma chave compartilhada pela rede para chaves separadas por site. Instalações de site único não são afetadas.
• Os auxiliares de validação MIME anteriormente disponibilizados por McpValidator foram removidos. Integrações que os chamam diretamente devem implementar a própria validação MIME, adequada à aplicação.

Adicionado

• Suporte a resources/templates/list, que retorna uma lista de modelos vazia quando não há modelos disponíveis.
• O bloqueio da execução direta dos arquivos PHP do plugin.
• Ampliação da cobertura de testes automatizados de compatibilidade e dependências, além das verificações do Plugin Check.

Alterado

• Agora o Jetpack Autoloader é usado para que as classes WP\MCP mais recentes disponíveis tenham prioridade quando o adaptador independente e outro plugin incluírem versões diferentes.
• No WordPress Multisite, o armazenamento das sessões é separado por site.
• Alterações simultâneas nas sessões são protegidas por novas tentativas limitadas, reduzindo o risco de uma solicitação sobrescrever outra sessão.
• A documentação esclarece que a Abilities API está incluída no WordPress 6.9 e versões posteriores, documenta o campo obrigatório category das habilidades e aprimora os exemplos ao longo do conteúdo.

Corrigido

• _meta é preservado no conteúdo dos recursos, nos recursos incorporados, nos blocos de conteúdo e nas mensagens de prompt.
• Um _meta malformado é omitido sem descartar o conteúdo que o acompanha.
• mimeType é emitido exatamente como declarado, inclusive com valores que contêm parâmetros, como text/html;profile=mcp-app.
• O conteúdo de recursos composto apenas por blobs é tratado corretamente.
• Os esquemas de URI dos recursos são comparados sem distinção entre maiúsculas e minúsculas. Assim, os clientes podem ler os recursos mesmo quando convertem o esquema para letras minúsculas.
• Os argumentos vazios são normalizados para habilidades que definem esquemas, permitindo a execução válida de chamadas de ferramentas sem argumentos.
• wp mcp-adapter serve mantém a saída padrão do JSON-RPC limpa ao selecionar o servidor padrão.
• O argumento global --user do WP-CLI é usado em vez de registrar uma opção local conflitante.

Para versões anteriores, consulte o CHANGELOG.md.