Elija un tipo de integración
| Tipo | Para qué sirve |
|---|---|
| Ejecutable (fire-and-forget) | Inicia otra aplicación sin esperar a que termine ni recoger su salida |
| Filtro de entrada/salida estándar | Pasa texto a un programa y recoge el resultado convertido |
| API REST (HTTP POST) | Envía JSON y recoge el cuerpo de la respuesta |
| Cliente MCP | Llama a una herramienta de un servidor MCP y recoge el texto de la respuesta |
Registre una herramienta y ejecútela
- Elija Configuración → Herramientas externas → + Agregar herramienta.
- Introduzca un nombre, elija el tipo de herramienta y rellene los campos de ese tipo, como la ruta del ejecutable o la URL del punto de conexión.
- Si la herramienta acepta texto, elija la entrada que se enviará. Si devuelve un resultado, elija cómo se tratará la salida.
- Configure Requiere un archivo abierto y Requiere texto seleccionado según lo necesite.
- Guarde la configuración y ejecute
/<nombre de la herramienta>en el terminal.
También puede ejecutar herramientas desde el icono del enchufe de la barra de formato. Cada herramienta registrada aparece en las pestañas de configuración Atajos y Gestos, donde puede asignarle un atajo o un gesto.
Pase el documento actual a una herramienta
Use los marcadores de posición siguientes en los argumentos y en otros campos.
| Marcador de posición | Qué contiene |
|---|---|
{file} / {dir} | La ruta del archivo y la carpeta que lo contiene |
{selection} | El texto seleccionado |
{workspace} | La raíz del espacio de trabajo |
{input} | Lo que escribió después del nombre de la herramienta en el terminal |
{full_document} | Todo el documento. Disponible en el cuerpo de REST y en el JSON de argumentos de MCP |
{token} | El token registrado. Disponible en los encabezados y el cuerpo de REST, y en el JSON de argumentos de MCP |
En JSON, use los marcadores de posición que terminan en _json. Estos escapan las comillas y los saltos de línea e incluyen las comillas que los rodean, de modo que el resultado es una cadena JSON válida. No añada otro par de comillas alrededor del marcador de posición.
{"text": {selection_json}, "instruction": {input_json}}Qué comprobar según el tipo
- Filtro de entrada/salida estándar: elija qué se envía, como la selección, todo el documento o el argumento del terminal. Compruebe la ruta del ejecutable y su carpeta de trabajo.
- API REST: un punto de conexión externo tiene que ser HTTPS. El cuerpo de la respuesta se recoge tal cual, por lo que no se puede extraer un único campo de un JSON. Los tokens se registran con Establecer token….
- MCP: para la entrada/salida estándar, indique el comando, sus argumentos y sus variables de entorno; para HTTP, indique el punto de conexión. Después, configure el nombre de la herramienta y el JSON de argumentos. Para usar
npxouvx, instale por separado el entorno de ejecución que necesitan.
Elija adónde va el resultado
El resultado puede sustituir la selección, insertarse en la posición del cursor, sustituir todo el documento, ir al portapapeles, convertirse en un archivo nuevo o mostrarse en el terminal. La sustitución de todo el documento no se guarda automáticamente; revise el resultado antes de guardar.
Cambiar de pestaña después de iniciar una ejecución no mueve su salida: se aplica a la pestaña en la que se inició la ejecución. Si esa pestaña se ha cerrado, la salida se abre en una pestaña nueva. Una ejecución en curso se puede cancelar desde la ventana de progreso o desde el terminal.
Lleve sus definiciones a otro equipo
Use Exportar a JSON… / Importar desde JSON… en la pestaña Herramientas externas. Compruebe las rutas de los ejecutables y las URL antes de importar. Los valores de los tokens no se exportan, así que vuelva a registrarlos en el otro equipo.
Las herramientas externas no se pueden ejecutar mientras la licencia no permite editar. Compruebe el estado en Licencias y activación.