Docs/Superfícies do produto/ACP

Um protocolo,
todos os editores.

O Agent Client Protocol padroniza a conversa entre editores e agentes. O MVCode implementa o lado do agente — e por isso funciona hoje em qualquer editor compatível: Zed, JetBrains, Neovim e o que vier.

CompatibilidadeReferência /acp1 min de leitura

01Como funciona

O comando mvcode acp sobe um subprocesso que fala JSON-RPC com o editor via stdio. O editor renderiza a conversa; o MVCode traz o runtime inteiro — ferramentas, agentes, permissões, MCP e regras do projeto.

o que o editor executa

mvcode acp

02Zed

~/.config/zed/settings.jsonjson

{
  "agent_servers": {
    "MVCode": { "command": "mvcode", "args": ["acp"] }
  }
}

Abra com a ação agent: new thread na Command Palette — ou vincule um atalho no keymap.json.

03JetBrains

acp.jsonjson

{
  "agent_servers": {
    "MVCode": { "command": "/caminho/absoluto/bin/mvcode", "args": ["acp"] }
  }
}

O agente aparece no seletor do AI Chat. Use caminho absoluto do binário — o launcher da IDE nem sempre herda o seu PATH.

04Neovim

avante.nvimlua

{
  acp_providers = {
    ["mvcode"] = {
      command = "mvcode",
      args = { "acp" },
      -- env = { MVCODE_API_KEY = os.getenv("MVCODE_API_KEY") }
    }
  }
}

Também há adapter para CodeCompanion.nvim — configure mvcode como agente ACP do chat.

05O que funciona via ACP

Ferramentas nativas — arquivos, terminal, busca
Ferramentas e comandos personalizados
MCP servers da sua config
Regras do AGENTS.md, formatadores, agentes e permissões

Limitação atual

Alguns comandos embutidos como /undo e /redo ainda não são suportados via ACP — use a TUI ou o app para desfazer mudanças.

06ACP e as extensões nativas

O ACP é o caminho universal hoje — funciona em qualquer editor compatível, sem instalar nada além do binário. As extensões nativas são a experiência de primeira classe planejada, e vão coexistir com o vínculo ACP:

PlanejadoExtensão VS CodeView na activity bar, review no panel e pill de seleção — em preparação.PlanejadoExtensão ChromePopup, side panel e captura por seleção — em preparação.