ABAP com agente de IA: o que o ADT para VS Code 1.2 da SAP libera, onde já funciona e que travas ligar
Publicado em 13 de novembro de 2026 · conferido nas fontes oficiais em 13/11/2026
Na versão 1.2 do ADT para VS Code, o servidor MCP da SAP ganhou ferramentas para ler e editar código ABAP, que um agente como o Claude Code pode usar. Onde funciona, as travas, o custo e os dados.
A SAP pôs no ADT para VS Code (a extensão "ABAP Development Tools for Visual Studio Code") um servidor MCP: um programa que roda dentro da extensão, no computador do desenvolvedor, e oferece a um agente de IA as ferramentas de desenvolvimento ABAP. Com ele, o agente acha um objeto, cria, ativa, roda os testes e abre a ordem de transporte, a partir de um pedido em linguagem natural. Na versão 1.2, o servidor ganhou ferramentas para ler e editar o código-fonte (abap_object_read_file e abap_object_edit_file), além de busca, verificação, os dumps da ST22 e a documentação. Assim, um agente que roda fora do VS Code, como o Claude Code, no terminal, passa a ter pelo próprio servidor as ferramentas do ciclo; o VS Code continua aberto, com o servidor rodando nele, e a ferramenta de edição do servidor vem desligada e se liga à parte. No ambiente ABAP do BTP, a lista de novidades de IA da SAP dá essas ferramentas como disponíveis a partir de 13/11/2026.
MCP (Model Context Protocol) é o padrão aberto que liga um agente de IA a ferramentas de fora. A SAP diz que o servidor atende "any MCP-compatible AI assistant", mas o único agente que ela dá como confirmado é o GitHub Copilot ("GitHub Copilot is confirmed; others are also supported"). Nenhuma página da SAP lida para este texto cita o Claude Code para o ABAP; o anúncio da SAP de 05/11/2025 o cita só para os servidores MCP do SAP Build.
Como o pedido chega ao SAP
| Passo | Quem | O quê |
|---|---|---|
| 1 | Você | pede ao agente, por exemplo, uma classe nova num pacote local |
| 2 | O agente | escolhe as ferramentas e chama o servidor MCP no próprio computador, em http://localhost:2236/mcp, com o token |
| 3 | O servidor MCP, dentro do VS Code | confere as travas (o sistema liberado e, para criar ou alterar, o pacote liberado; nas notas da 1.2, com o BTP 2611 e o Public Edition 2702, previsto) e fala com o SAP pela conexão que você abriu no VS Code |
| 4 | O sistema ABAP | cria, ativa e roda os testes; num pacote com transporte, o objeto vai para uma ordem de transporte |
| 5 | Você | revisa o que mudou e só então libera a ordem; nenhuma ferramenta da tabela da SAP é de liberar ordem |
O servidor roda dentro da extensão: o VS Code fica aberto, com a conexão ao sistema ativa, enquanto o agente trabalha. Pelo tutorial da SAP, "The MCP server only starts once a destination is active in the workspace".
O ciclo de um pedido, no exemplo da SAP
A SAP publica o caminho de um pedido ("Create an ABAP class that demonstrates how to output text to the console using the classrun API"). O agente decide sozinho a sequência; os nomes abaixo são os da tabela de ferramentas atual:
abap_destination_list: escolhe o sistema.abap_repository_list_creatable_typeseabap_object_get_creatable_type_detail: acha o tipo (a classe) e os campos obrigatórios (pacote, nome, descrição).abap_object_validate_creation: confere o nome e o pacote antes de criar.abap_transport_create_request: cria a ordem de transporte (no exemplo, "UIAK900123").abap_object_create: cria a classe.- A edição do código. No exemplo da SAP, ela é feita pela ferramenta de edição do próprio agente (o "host" MCP), no arquivo aberto no editor ("Built-in edit tool from MCP host (Not from ADT MCP Server)"); desde a 1.2, o servidor tem também a dele (
abap_object_edit_file). abap_object_activate: ativa.abap_unit_run_tests: roda os testes ("All tests passed").
Também estão na tabela, entre outras: a busca de objetos, a verificação, o ATC, o gerador de aplicações RAP ("tables, CDS views, behaviour definitions, service definition, service binding"), os dumps da ST22 e o log de erros do Gateway, e o diff de todos os objetos de uma ordem de transporte (abap_transport_get_unified_diff).
Como se liga
- No VS Code, nas preferências, a opção do ADT MCP Server; a porta padrão é a 2236. O token é gerado sozinho e fica na preferência "Adt > MCP Server: Token".
- No agente, o endereço
http://localhost:<porta>/mcpe o cabeçalhoAuthorization: Bearer <token>. No Claude Code, pela documentação dele:claude mcp add --transport http adt http://localhost:2236/mcp --header "Authorization: Bearer <token>". O escopo padrão do comando é o local, que fica só na sua máquina e só no projeto em que foi adicionado. O token é uma senha: não vai para um arquivo do repositório. - A aprovação de cada chamada é do agente, e muda de um para outro. A página da SAP, escrita para o agente em geral (o "host" MCP), dá as opções "for a single use, for the current session, for the current workspace, or for all future invocations". No Claude Code, por padrão, a sessão interativa começa no modo "auto" (em todos os planos a partir da versão 2.1.283; antes, já nos planos Pro, Max, Ultra e Team), em que as chamadas passam por um classificador, e não por você. Para aprovar chamada a chamada, inicie no modo Manual (
claude --permission-mode default, oupermissions.defaultModeno arquivo de configuração) e não escolha o "Yes, and don't ask again"; ou ponha uma regra "ask" paramcp__adt__*, que nenhum modo aprova sozinho (ela pergunta mesmo no modo auto).
O mesmo servidor existe no ADT para Eclipse, desde a versão 3.60, na porta padrão 2234; as ferramentas da 1.2 estão também nas notas da versão 3.62 dele.
As travas, desde a versão 1.2
- Os sistemas: "Users must explicitly opt in to the ABAP destinations they wish to access". Fora da lista, nem leitura nem escrita.
- Os pacotes: só os pacotes da lista recebem objeto novo ou alteração; "Objects in other packages not part of the list cannot be modified".
- A leitura continua aberta: "Reading from all packages is allowed irrespective of the access restrictions defined". Num sistema liberado, o agente lê o código de qualquer pacote.
- A ferramenta de edição do servidor vem desligada: "The native edit file tool is disabled by default"; liga-se à parte. Um agente que roda dentro do VS Code ainda edita pelo editor, como no exemplo da SAP, e nenhuma página lida diz que a lista de pacotes vale para essa edição.
- A chave geral: as restrições valem enquanto a preferência central "Enable access restrictions" estiver ligada, e ela vem ligada. Desligada, o servidor não restringe nada, mesmo com as listas preenchidas.
As restrições de sistema e de pacote entraram na versão 1.2. Nas notas dela, a SAP as lista com o BTP 2611 e o Public Edition 2702; a chave geral, também com o S/4HANA e o Private Edition 2027.
Quem liga o servidor, escolhe os sistemas e os pacotes é o próprio desenvolvedor, nas preferências do VS Code. O administrador aparece em dois lugares: na licença do Joule (as AI units; na página do administrador para o Joule "side-by-side", escrita para o ADT para Eclipse, pelo "SAP for Me") e, segundo a página de segurança da SAP, nas configurações do Copilot, que a empresa pode gerenciar para todos os desenvolvedores.
O pacote decide o transporte
No ABAP, o que diz se um objeto vai para uma ordem de transporte é o pacote em que ele está ou é criado: no pacote com transporte, criar ou alterar um objeto pede uma ordem ("choose the package that has transport enabled"). O modelo de instruções que a SAP publica para o agente faz a separação pelo pacote: "The package $tmp/zlocal/<your_local_development_package> is used for local development. No transports are needed". A instrução diz ao agente onde trabalhar; o que impede um objeto de pacote transportável de ser criado ou alterado pelo servidor é a lista de pacotes, com as restrições ligadas. No começo, ela pode ter só o pacote local; um pacote transportável entra quando você quiser que o agente mexa nele. Nenhuma página lida diz que criar uma ordem de transporte passa pela lista: no exemplo da SAP, a ordem é criada antes do objeto.
Onde já funciona, e onde só no 2027
| Onde | O que a SAP lista |
|---|---|
| Ambiente ABAP do BTP | o servidor MCP no ADT para VS Code desde 29/05/2026; as ferramentas novas da 1.2, a partir de 13/11/2026 (o release 2611) |
| S/4HANA Cloud Public Edition | as ferramentas novas da 1.2 no release 2702, previsto (o roteiro o dá como "Planned Release"), pelas notas do VS Code; as notas do Eclipse 3.62 dizem 2611 |
| S/4HANA on-premise e Private Edition | as ferramentas novas da 1.2 (ler, editar, buscar, verificar, os dumps e a documentação), no release 2027; o roteiro de IA do ABAP põe a leitura e a edição por MCP como planejadas para o Private Edition 2027 |
A extensão em si se conecta a sistemas bem mais antigos: o NetWeaver a partir do 7.3 EHP1 SP04 e o S/4HANA a partir do 1709, com a ressalva da SAP de que "Feature availability may vary by release version". Nas notas lidas, as ferramentas novas da 1.2 aparecem para o on-premise só com o 2027, e as de criar, ativar, testar e abrir a ordem não aparecem com release on-premise nenhum, e as notas do ADT para Eclipse 3.60 dão o servidor MCP para o BTP e para o Public Edition 2608, sem a marca das funções que valem em qualquer sistema. Antes de planejar, confira o release do seu sistema de desenvolvimento.
O computador: a SAP pede Windows 10 ou macOS 14 em diante. A conexão RFC (on-premise e Private Edition) usa o cadastro do sistema no SAP Logon ou o arquivo de landscape da empresa; desde a 1.2, dá também para informar o sistema à mão, sem o SAP Logon.
O custo
- A licença: "Support for the MCP tools is only provided if the customer possesses a valid SAP Joule for Developers, ABAP AI capabilities license." E, no roteiro de IA do ABAP, onde estão as ferramentas de ler e editar: "AI features must be licensed additionally."
- O consumo: na tabela de ferramentas, quatro são marcadas "Token consumption/additional costs: Required": explicar um objeto, a busca na documentação e as duas da correção do ATC por IA. As de criar, ler, editar, ativar, testar e abrir a ordem são marcadas "Not required". A SAP manda fazer o login no Joule antes de subir o servidor para usar as ferramentas "that require a Joule license", sem listar quais são.
- As AI units: para o Joule "side-by-side", no BTP, no Public Edition e no Private Edition, a SAP manda comprar AI units (nota 3740750, que pede login: o que ela diz do uso sem a licença fica fora deste texto). Em 30/09/2026, a SAP registrou no BTP que a licença promocional do Joule para o ABAP expirou e tirou a opção "on-stack".
- O agente: o Claude Code, o Copilot ou outro tem o contrato e o custo dele, à parte da SAP.
Os dados: o que vai para o provedor do agente
A SAP avisa, na ferramenta que lê os dumps e o log de erros do Gateway: "Connecting an ADT MCP server to a third-party AI service may expose the processed data to that AI service provider. This may include actual business data, such as sensitive or personal data". E: "SAP assumes no responsibility or liability for any data privacy issues arising from your use of third-party AI services". O aviso fala do dado processado em geral, e o código que o agente lê também é processado pelo modelo. Num sistema com dado real, leve isso ao encarregado pelo tratamento de dados pessoais da empresa, o da LGPD, antes de ligar. Na página do administrador para o Joule "side-by-side" (escrita para o ADT para Eclipse), as regiões são EU10, EU11 (só acesso da UE), US30, AP20 e JP10, sem o Brasil; nenhuma página lida liga essas regiões às ferramentas MCP do VS Code. A página de segurança da SAP alerta ainda para a injeção de instruções ("Prompt injection attacks may compromise the client system").
Onde as fontes da SAP não batem
- O tutorial da SAP, atualizado em 17/09/2026, chama o servidor MCP de "experimental feature ... not intended for productive use". A lista de novidades do BTP marca a mesma função como "General Availability" desde 29/05/2026.
- O tutorial diz: "Any coding agent that supports Visual Studio Code's virtual workspace filesystem is compatible — GitHub Copilot is confirmed; others are also supported." Com as ferramentas de arquivo da 1.2, o servidor também passou a ter as suas. O modelo de instruções da SAP já dá as duas vias ("use the VS Code editor or the ABAP edit file tool") e acrescenta "If needed open the editor first using the object's URI in ABAP's virtual filesystem": as páginas lidas não dizem se a edição pelo servidor depende do editor aberto no VS Code.
- O Public Edition das ferramentas da 1.2: 2702 nas notas do ADT para VS Code, 2611 nas do ADT para Eclipse 3.62.
O que fazer
- Veja o release do sistema de desenvolvimento contra a tabela acima. No on-premise e no Private Edition, as notas da SAP só trazem, para o 2027, as ferramentas novas da 1.2 (ler, editar, buscar, verificar, os dumps e a documentação); as de criar, ativar, testar e abrir a ordem não aparecem com release on-premise em nenhuma nota lida.
- Fale com o administrador da conta SAP sobre a licença do Joule para o ABAP e as AI units antes de ligar o servidor: a SAP só dá suporte às ferramentas com a licença, e diz que os recursos de IA se licenciam à parte.
- Use a extensão na versão 1.2 ou depois, que é a que traz as travas, e comece num sistema de desenvolvimento, sem dado real de cliente ou de funcionário; leve o aviso de dados ao encarregado antes de ir além.
- Ligue o servidor com as travas: só o sistema de desenvolvimento na lista; só o pacote local na lista de pacotes; a ferramenta de edição do servidor desligada até conferir o que o agente faz com a leitura. Nas notas da 1.2, as listas de sistema e de pacote vêm com o BTP 2611 e o Public Edition 2702; para o 2027, só a chave geral.
- Escreva as instruções do agente a partir do modelo da SAP: ABAP Cloud, o pacote local, os prefixos da casa, ativar depois de editar e rodar os testes. A SAP fala do
agents.md. Por padrão, o Claude Code só lê oAGENTS.mdquando não háCLAUDE.mdnemCLAUDE.local.mdna pasta ou acima dela (da versão 2.1.277 em diante): se você já tem umCLAUDE.md, ponha o modelo nele ou importe oAGENTS.mdcom@AGENTS.md. - Aprove as ferramentas uma a uma no começo. No Claude Code, no modo Manual, sem o "don't ask again", ou com a regra "ask"; no agente que mostra as opções da página da SAP, "for a single use".
- Revise tudo o que o agente gerou antes de liberar: a SAP recomenda que todo objeto gerado por IA seja revisto por um desenvolvedor. O diff da ordem (
abap_transport_get_unified_diff) e o ATC ajudam.
O que este texto não cobre
- O blog do SAP Community que mostrou o Claude Code com o ADT 1.2, e os anúncios da versão 1.2 e do servidor MCP no mesmo site: o SAP Community recusa a leitura automática, e este texto se apoia na documentação oficial da SAP e na do Claude Code.
- A data em que a extensão 1.2 saiu no Visual Studio Marketplace.
- As notas SAP 3740750, 3752299 e 3751297, que pedem login, e o preço das AI units e dos agentes.
- A configuração do GitHub Copilot e a política de MCP dele para empresas, e os servidores MCP de terceiros para o ABAP, que a SAP não cobre.
Fontes oficiais
- SAP, ADT para VS Code: Model Context Protocol Tools
- SAP, ADT para VS Code: Enabling ADT MCP Server
- SAP, ADT para VS Code: Configuring ADT MCP Server
- SAP, ADT para VS Code: Using MCP Tools
- SAP, ADT para VS Code: Scenario: Agentic Loop
- SAP, ADT para VS Code: Agent Configuration
- SAP, ADT para VS Code: Security Considerations and Recommendations
- SAP, ADT para VS Code: Recommendations and Constraints
- SAP, ADT para VS Code: What's New
- SAP, ADT para VS Code: a página de entrada, com a validade
- SAP, ADT para VS Code: Installing ABAP Development Tools for VS Code
- SAP, ADT para VS Code: Establishing a System Connection via RFC Destination
- SAP, ADT para VS Code: Adding an ABAP Development Object to a Transport Request
- SAP, ADT para VS Code: Getting Started (Administrators)
- SAP, Joule for Developers: Configuring for Side-by-Side Use (Administrators)
- SAP, Joule for Developers: AI What's New do BTP ABAP environment
- SAP, ABAP Platform: o roteiro de IA do ABAP
- SAP, ADT para Eclipse: Enabling ADT MCP Server
- SAP, ADT para Eclipse: notas da versão 3.60
- SAP, ADT para Eclipse: notas da versão 3.62
- SAP News, New Agentic Capabilities on SAP BTP Supercharge Developers for What's Next (05/11/2025)
- SAP Developers, tutorial Enable the ADT MCP Server in ABAP Development Tools for VS Code
- Anthropic, documentação do Claude Code: MCP
- Anthropic, documentação do Claude Code: permissões
- Anthropic, documentação do Claude Code: modos de permissão
- Anthropic, documentação do Claude Code: CLAUDE.md e AGENTS.md
Conteúdo informativo, preparado pela Knisstech a partir das fontes oficiais citadas. Não substitui a análise do caso concreto, e a norma pode mudar depois da data da conferência.
Precisa ajustar o cadastro fiscal, o ERP ou o SPED para essa mudança? Fale com a Knisstech.