English | Português | Español

Controle o Adobe InDesign diretamente pelo Codex, Claude, OpenCode e outros clientes MCP.

Instalação · Ferramentas · Segurança · Desenvolvimento

O InDesign MCP é um servidor Model Context Protocol que automatiza o Adobe InDesign no Windows por meio de COM e ExtendScript. Ele permite que assistentes de IA consultem documentos, editem conteúdo e executem exportações usando ferramentas estruturadas.

✨ Destaques

• 19 ferramentas prontas para edição, inspeção e exportação.
• Instalação por npm, sem plugin ou script de inicialização no InDesign.
• Integração nativa com Codex, Claude Desktop, Claude Code e OpenCode.
• Execução local por stdio; seus documentos não são enviados pelo MCP.
• Modo seguro por padrão, com execução arbitrária de JSX desabilitada.

📋 Requisitos

• Windows 10 ou 11
• Adobe InDesign 2024 ou mais recente
• Node.js 18 ou mais recente
• PowerShell 5.1 ou mais recente

O InDesign deve estar aberto durante o uso. Nenhum script de inicialização ou ajuste de firewall é necessário.

📦 Instalação pelo npm

Não é necessário clonar o repositório nem instalar o pacote globalmente. Configure seu cliente MCP para executar:

npx -y mcp-indesign

Codex

Adicione a ~/.codex/config.toml:

[mcp_servers.indesign]
command = "npx"
args = ["-y", "mcp-indesign"]
startup_timeout_sec = 30

[mcp_servers.indesign.env]
INDESIGN_MCP_LANGUAGE = "pt-BR"

Claude Desktop ou Claude Code

{
  "mcpServers": {
    "indesign": {
      "command": "npx",
      "args": ["-y", "mcp-indesign"],
      "env": { "INDESIGN_MCP_LANGUAGE": "pt-BR" }
    }
  }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "indesign": {
      "type": "local",
      "command": ["npx", "-y", "mcp-indesign"],
      "environment": { "INDESIGN_MCP_LANGUAGE": "pt-BR" },
      "enabled": true
    }
  }
}

Reinicie o cliente, abra o InDesign e execute check_connection.

🧰 Ferramentas

| Ferramenta | Função | | --- | --- | | check_connection | Verifica a comunicação com o InDesign | | list_documents | Lista documentos abertos | | get_document_info | Retorna páginas e propriedades do documento | | get_page_info | Retorna informações de uma página | | get_text | Lê texto da seleção, página, documento ou frame | | insert_text | Insere texto em um frame | | set_frame_text | Substitui, acrescenta ou prefixa texto | | replace_text | Localiza e substitui texto | | list_frames | Lista frames de texto | | create_text_frame | Cria um frame de texto | | list_styles | Lista estilos do documento | | apply_style | Aplica estilos à seleção ou a um frame | | list_colors | Lista amostras de cor | | create_color_swatch | Cria uma amostra RGB, CMYK, LAB ou GRAY | | export_pdf | Exporta PDF | | export_image | Exporta JPG, PNG ou TIFF | | quick_export | Exporta rapidamente para um formato escolhido | | batch_export | Exporta múltiplos documentos e formatos | | run_jsx | Executa ExtendScript quando habilitado explicitamente |

🔐 Segurança

O runtime usa inglês por padrão. Defina o idioma da interface no ambiente do MCP quando necessário:

INDESIGN_MCP_LANGUAGE=en     # Inglês
INDESIGN_MCP_LANGUAGE=pt-BR  # Português (pt e pt-PT também são aceitos)
INDESIGN_MCP_LANGUAGE=es     # Espanhol

run_jsx permite execução arbitrária de ExtendScript e fica desabilitado por padrão. Habilite somente em ambientes confiáveis:

INDESIGN_MCP_ENABLE_RUN_JSX=1

Para usar uma instalação externa do BatchExportProfessional.jsx:

INDESIGN_MCP_BATCH_SCRIPT=C:\caminho\BatchExportProfessional.jsx

🛠️ Desenvolvimento

git clone https://github.com/SanNw/Indesign-MCP.git
cd Indesign-MCP
npm install
npm test

O teste inicia o servidor, valida as 19 ferramentas e confirma que run_jsx permanece bloqueado por padrão.

🩺 Solução de problemas

• Execute check_connection antes das outras ferramentas.
• Confirme que o InDesign está aberto na mesma sessão do Windows.
• Reinicie o cliente MCP depois de alterar a configuração.
• Presets de exportação variam conforme a versão e o idioma do InDesign.

⚠️ Limitações

• A série 0.1.x suporta somente Windows.
• Operações podem modificar o documento aberto, mas não o salvam automaticamente.
• A compatibilidade foi validada diretamente com o InDesign 2025; outras versões devem ser testadas pela comunidade.

📄 Licença

MIT

Feito para aproximar inteligência artificial e design editorial.