MCP Adapter

Registro de alterações

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.