Escolher um tipo de integração
| Tipo | Para que serve |
|---|---|
| Executável (fire-and-forget) | Inicia outro aplicativo sem esperar que ele termine e sem coletar a saída dele |
| Filtro stdio (stdin → stdout) | Envia texto a um programa e recebe de volta o resultado convertido |
| API REST (HTTP POST) | Envia JSON e recebe de volta o corpo da resposta |
| Cliente MCP | Chama uma ferramenta em um servidor MCP e recebe de volta o texto da resposta |
Registrar e executar uma ferramenta
- Escolha Configurações → Ferramentas externas → + Adicionar ferramenta.
- Digite um nome, escolha o tipo de ferramenta e preencha os campos desse tipo, como o caminho do executável ou a URL do endpoint.
- Se a ferramenta aceitar texto, escolha a entrada a enviar. Se ela retornar um resultado, escolha como a saída deve ser tratada.
- Defina Requer um arquivo aberto e Requer texto selecionado conforme necessário.
- Salve as configurações e execute
/<nome da ferramenta>no terminal.
Também é possível executar ferramentas pelo ícone de plugue na barra de formatação. Cada ferramenta registrada aparece nas guias de configuração Atalhos e Gestos, onde você pode atribuir a ela um atalho ou um gesto.
Enviar o documento atual para uma ferramenta
Use os marcadores abaixo nos argumentos e em outros campos.
| Marcador | O que contém |
|---|---|
{file} / {dir} | O caminho do arquivo e a pasta que o contém |
{selection} | O texto selecionado |
{workspace} | A raiz do espaço de trabalho |
{input} | O que você digitou depois do nome da ferramenta no terminal |
{full_document} | O documento inteiro. Disponível no corpo REST e no JSON de argumentos do MCP |
{token} | O token registrado. Disponível nos cabeçalhos e no corpo REST, e no JSON de argumentos do MCP |
Em JSON, use os marcadores que terminam em _json. Eles escapam aspas e quebras de linha e incluem as aspas ao redor, de modo que o resultado é uma string JSON válida. Não adicione outro par de aspas em volta do marcador.
{"text": {selection_json}, "instruction": {input_json}}O que verificar em cada tipo
- Filtro stdio: escolha o que entra, como a seleção, o documento inteiro ou o argumento do terminal. Verifique o caminho do executável e a pasta de trabalho dele.
- API REST: um endpoint externo precisa usar HTTPS. O corpo da resposta é recebido como está, de modo que não é possível extrair um único campo de um JSON. Os tokens são registrados com Definir token….
- MCP: para entrada/saída padrão (stdio), informe o comando, os argumentos e as variáveis de ambiente; para HTTP, informe o endpoint. Em seguida, defina o nome da ferramenta e o JSON de argumentos. Para usar
npxouuvx, instale separadamente o runtime de que eles precisam.
Escolher para onde vai o resultado
O resultado pode substituir a seleção, ser inserido no cursor, substituir o documento inteiro, ir para a área de transferência, virar um novo arquivo ou ser mostrado no terminal. A substituição do documento inteiro não é salva automaticamente; confira o resultado antes de salvar.
Trocar de aba depois que uma execução começou não muda o destino da saída: ela é aplicada à aba em que a execução começou. Se essa aba tiver sido fechada, a saída é aberta em uma nova aba. Uma execução em andamento pode ser cancelada pela janela de progresso ou pelo terminal.
Levar as definições para outro computador
Use Exportar para JSON… / Importar do JSON… na guia Ferramentas externas. Verifique os caminhos dos executáveis e as URLs antes de importar. Os valores dos tokens não são exportados, por isso registre-os novamente no outro computador.
As ferramentas externas não podem ser executadas enquanto a licença não permitir a edição. Verifique o estado em Licenciamento e ativação.