O que você está procurando?

Aperte Enter para buscar ou ESC para fechar

MCP Adapter / Adaptador MCP

Um MCP Adapter é uma camada de integração que permite adaptar as funcionalidades de um sistema existente para o Model Context Protocol (MCP), tornando dados e ações desse sistema acessíveis a aplicações e agentes de inteligência artificial compatíveis com o protocolo.

O termo “Adapter” não representa uma primitiva oficial do MCP. O protocolo trabalha principalmente com uma arquitetura de clientes e servidores MCP, em que servidores podem disponibilizar ferramentas, recursos e prompts para aplicações de IA. O Adapter é uma forma de implementar essa arquitetura sem obrigar um software existente a ser reconstruído ao redor do MCP.

Em outras palavras, ele funciona como uma camada de tradução entre:

as APIs e funcionalidades nativas de uma aplicação e a interface padronizada esperada por clientes MCP.

O problema que um MCP Adapter resolve

Imagine um sistema que já possui uma API própria capaz de consultar clientes, buscar pedidos e atualizar informações.

Para conectar esse sistema diretamente a diferentes aplicações de IA, seria possível desenvolver integrações específicas para cada uma delas:

Aplicação
   ├── integração para cliente A
   ├── integração para cliente B
   ├── integração para cliente C
   └── integração para cliente D

O MCP propõe uma interface comum.

Em vez de cada aplicação precisar conhecer uma integração proprietária, o sistema pode disponibilizar suas funcionalidades por meio de um servidor MCP.

Um Adapter entra justamente entre essas duas camadas:

Sistema existente
       ↓
APIs / funções internas
       ↓
   MCP Adapter
       ↓
   Servidor MCP
       ↓
Cliente ou agente de IA

O Adapter conhece a estrutura interna da aplicação e sabe como representá-la no formato que clientes MCP conseguem descobrir e utilizar.

O que pode ser adaptado para MCP?

Um servidor MCP pode oferecer principalmente três tipos de primitivas: Tools, Resources e Prompts.

Tools

Tools são funções executáveis.

Elas permitem que um modelo execute uma ação ou consulte informações dinamicamente.

Por exemplo:

get_customer
create_order
update_product
publish_post
search_events

Cada Tool possui um nome, uma descrição e um schema que informa quais argumentos ela recebe.

Um cliente MCP pode listar as ferramentas disponibilizadas pelo servidor e, quando apropriado, solicitar sua execução. A documentação oficial mostra, por exemplo, operações como listTools para descobrir ferramentas e callTool para executá-las.

Resources

Resources representam dados que uma aplicação pode disponibilizar como contexto.

Podem representar, por exemplo:

arquivo
documento
configuração
registro de banco de dados
conteúdo de uma API

Ao contrário de uma Tool, que representa uma ação, um Resource é essencialmente algo que pode ser lido.

Prompts

Prompts são templates reutilizáveis disponibilizados pelo servidor MCP.

Eles podem representar fluxos ou instruções previamente definidas, que o cliente apresenta ao usuário ou ao modelo quando necessário.

Essa separação permite que o servidor descreva não apenas o que o sistema sabe fazer, mas também quais informações ele disponibiliza e quais fluxos pode oferecer.

Adapter não significa necessariamente servidor separado

O nome pode causar alguma confusão.

Um MCP Adapter não precisa obrigatoriamente ser uma aplicação independente rodando em outro servidor.

Dependendo da arquitetura, ele pode existir:

  • dentro da própria aplicação;
  • como uma biblioteca;
  • como um plugin;
  • como um proxy;
  • ou como um serviço externo.

O objetivo é adaptar as capacidades do software para o protocolo.

A implementação concreta depende da plataforma.

E o WordPress oferece um bom exemplo disso.

MCP Adapter no WordPress

No ecossistema WordPress, MCP Adapter também é o nome de um plugin oficial desenvolvido dentro da iniciativa AI Building Blocks for WordPress.

Sua função é conectar a Abilities API do WordPress ao Model Context Protocol.

A arquitetura pode ser simplificada assim:

WordPress / plugins
        ↓
   Abilities API
        ↓
    MCP Adapter
        ↓
     MCP Server
        ↓
Cliente / agente de IA

A Abilities API é responsável por registrar funcionalidades disponíveis dentro de uma instalação WordPress.

O MCP Adapter pega essas funcionalidades e as disponibiliza de maneira que aplicações compatíveis com MCP possam descobri-las e executá-las.

Abilities como camada intermediária

Uma das decisões importantes dessa implementação é que plugins não precisam necessariamente conhecer o protocolo MCP.

Eles podem registrar uma funcionalidade utilizando a Abilities API.

Uma Ability possui elementos como:

nome
descrição
input_schema
output_schema
permission_callback
execute_callback

Isso cria uma representação padronizada da funcionalidade dentro do próprio WordPress.

O MCP Adapter pode então fazer a tradução entre essa representação interna e o protocolo utilizado externamente.

Ou seja:

Plugin
   ↓
Ability
   ↓
MCP Adapter
   ↓
MCP Tool

O desenvolvedor não precisa implementar novamente toda a lógica da funcionalidade para cada agente ou cliente MCP.

O servidor MCP padrão

Ao ser instalado, o MCP Adapter disponibiliza um servidor padrão chamado:

mcp-adapter-default-server

O endpoint HTTP correspondente utiliza a estrutura:

/wp-json/mcp/mcp-adapter-default-server

A implementação também disponibiliza ferramentas responsáveis por descobrir as Abilities disponíveis, consultar informações sobre elas e executá-las.

Isso permite um fluxo semelhante a:

Agente
   ↓
Quais abilities estão disponíveis?
   ↓
MCP Adapter
   ↓
Lista de abilities

Agente
   ↓
Quais argumentos esta ability recebe?
   ↓
MCP Adapter
   ↓
Schema da ability

Agente
   ↓
Execute esta ability
   ↓
MCP Adapter
   ↓
WordPress

Essa descoberta é especialmente útil para agentes, porque reduz a necessidade de conhecer antecipadamente todos os plugins e funcionalidades existentes naquela instalação.

Transporte HTTP e STDIO

O plugin oferece suporte a diferentes formas de transporte.

A página oficial lista suporte nativo a HTTP e STDIO, além da possibilidade de transportes personalizados.

STDIO é especialmente útil em ambientes locais ou ferramentas executadas na mesma máquina.

Um cliente pode iniciar o servidor através do WP-CLI, por exemplo:

wp mcp-adapter serve \
  --server=mcp-adapter-default-server \
  --user=admin

Já em instalações acessíveis pela rede, o servidor pode ser utilizado por HTTP através do endpoint MCP do WordPress.

Isso permite conectar clientes como ambientes de desenvolvimento e aplicações compatíveis com MCP ao mesmo WordPress.

Autenticação e permissões

Disponibilizar ferramentas para agentes não significa expor todas as funções do site livremente.

O MCP Adapter mantém o sistema de permissões do WordPress como parte do fluxo de execução.

Além disso, a exposição de Abilities é controlada: a documentação atual informa que uma Ability só fica acessível pelo MCP quando estiver marcada como pública, e seus controles de permissão continuam sendo executados para o usuário autenticado.

Assim, existem duas perguntas diferentes:

Esta Ability pode aparecer através do MCP?

          ↓

O usuário atual possui permissão para executá-la?

Uma resposta positiva à primeira não elimina a segunda.

Para conexões HTTP, aplicações também podem utilizar mecanismos de autenticação do WordPress, como Application Passwords, ou implementações OAuth apropriadas.

Múltiplos servidores MCP

O MCP Adapter também não limita uma instalação WordPress a um único servidor.

A arquitetura permite criar múltiplos servidores MCP com configurações diferentes. A página do plugin lista explicitamente o gerenciamento de múltiplos servidores como um de seus recursos.

Isso permite imaginar configurações como:

WordPress

├── MCP Server editorial
│   ├── ler posts
│   ├── criar rascunhos
│   └── consultar mídia
│
├── MCP Server suporte
│   ├── consultar documentação
│   └── buscar informações
│
└── MCP Server administrativo
    ├── diagnósticos
    └── configurações específicas

Cada servidor pode controlar quais funcionalidades são disponibilizadas para determinado contexto.

O MCP Adapter contém inteligência artificial?

Não.

Esse ponto é importante.

O plugin oficial não executa modelos de linguagem e não oferece recursos de geração de texto ou imagens por conta própria.

A própria documentação o define como a camada de servidor e transporte.

Ele não é:

WordPress → Inteligência Artificial

Sua função é mais próxima de:

Agente de IA
      ↕
     MCP
      ↕
MCP Adapter
      ↕
 WordPress

O modelo de IA pode estar sendo executado em outra aplicação.

O Adapter apenas disponibiliza uma interface padronizada para que essa aplicação interaja com capacidades autorizadas do WordPress.

MCP Adapter e REST API são a mesma coisa?

Não.

Embora ambos permitam que sistemas externos interajam com o WordPress, eles atuam em níveis diferentes.

A REST API fornece endpoints HTTP que aplicações podem chamar diretamente.

O MCP fornece uma camada padronizada voltada especialmente para aplicações e agentes capazes de descobrir ferramentas, entender seus schemas e decidir quando utilizá-las.

Inclusive, a própria Abilities API possui endpoints REST para descobrir e executar Abilities.

Portanto, MCP não substitui necessariamente REST.

O MCP Adapter pode ser entendido como uma interface adicional sobre capacidades do WordPress, voltada a outro modelo de integração.

Compatibilidade com versões do protocolo

O MCP ainda está evoluindo, e isso também faz parte da responsabilidade do Adapter.

Na versão 0.7.0, publicada em outubro de 2026, o plugin suporta diretamente as revisões MCP:

2025-11-25
2026-07-28

Clientes que propõem algumas versões anteriores ainda podem se conectar utilizando o schema compatível definido pelo Adapter.

A especificação MCP 2026-07-28, por sua vez, introduziu mudanças relevantes como um núcleo stateless, alterações de autorização, novas regras de roteamento e extensões formais do protocolo.

Concentrar essa compatibilidade no Adapter evita que cada plugin WordPress precise acompanhar individualmente todas essas mudanças.

Por que isso é importante para o WordPress?

Tecnicamente, o MCP Adapter resolve a tradução entre duas arquiteturas:

Abilities API
      ↕
MCP

Mas seu impacto pode ser mais amplo.

Ele permite que plugins descrevam suas funcionalidades dentro do WordPress e deixem a integração com agentes para uma camada compartilhada.

Isso reduz a necessidade de cada plugin construir integrações específicas para Claude, ChatGPT, Cursor, VS Code ou outros clientes compatíveis.

Para uma análise menos técnica sobre essa mudança e sobre o que ela pode representar para o futuro do ecossistema, leia também MCP Adapter: por que essa nova peça importa para o futuro do WordPress com IA.

Neste artigo do Glossário, a definição pode ser resumida assim:

MCP Adapter é uma camada de integração que traduz as capacidades nativas de uma aplicação para as estruturas do Model Context Protocol. No WordPress, o plugin oficial MCP Adapter conecta as funcionalidades registradas pela Abilities API a clientes MCP, permitindo que agentes descubram e executem capacidades autorizadas do site utilizando uma interface padronizada.

Referências