연동 종류 선택
| 종류 | 용도 |
|---|---|
| 실행 파일 (대기 없음) | 다른 앱을 시작하며, 종료를 기다리거나 출력을 받지 않습니다 |
| 표준 입출력 필터 | 프로그램에 텍스트를 전달하고 변환된 결과를 받습니다 |
| REST API (HTTP POST) | JSON을 보내고 응답 본문을 받습니다 |
| MCP 클라이언트 | MCP 서버의 도구를 호출하고 응답 텍스트를 받습니다 |
도구 등록과 실행
- 설정 → 외부 연동 → + 도구 추가를 선택합니다.
- 이름을 입력하고 도구 종류를 선택한 다음, 실행 파일 경로나 엔드포인트 URL 등 해당 종류에 필요한 항목을 입력합니다.
- 도구가 텍스트를 받는 경우 보낼 입력을 선택합니다. 결과를 돌려주는 경우 출력을 처리할 방법을 선택합니다.
- 필요에 따라 열려있는 파일이 있을 때만 실행과 선택한 텍스트가 있을 때만 실행을 설정합니다.
- 설정을 저장하고 터미널에서
/<도구 이름>을 실행합니다.
서식 도구 모음의 플러그 아이콘에서도 도구를 실행할 수 있습니다. 등록한 도구는 설정의 단축키 탭과 제스처 탭에 표시되며, 여기에서 단축키나 제스처를 할당할 수 있습니다.
현재 문서를 도구에 전달
인수 등에 아래의 자리 표시자를 사용합니다.
| 자리 표시자 | 들어가는 값 |
|---|---|
{file} / {dir} | 파일 경로와 그 파일이 들어 있는 폴더 |
{selection} | 선택한 텍스트 |
{workspace} | 작업 영역의 루트 |
{input} | 터미널에서 도구 이름 뒤에 입력한 내용 |
{full_document} | 문서 전체. REST 본문과 MCP 인수 JSON에서 사용할 수 있습니다 |
{token} | 등록한 토큰. REST 헤더와 본문, MCP 인수 JSON에서 사용할 수 있습니다 |
JSON 안에서는 _json으로 끝나는 자리 표시자를 사용하십시오. 따옴표와 줄바꿈을 이스케이프하고 앞뒤 따옴표까지 포함하므로 결과가 올바른 JSON 문자열이 됩니다. 자리 표시자를 다시 따옴표로 감싸지 마십시오.
{"text": {selection_json}, "instruction": {input_json}}종류별 확인 사항
- 표준 입출력 필터: 선택 영역, 문서 전체, 터미널 인수 등 입력으로 보낼 내용을 선택합니다. 실행 파일의 경로와 작업 폴더를 확인하십시오.
- REST API: 외부 엔드포인트는 HTTPS여야 합니다. 응답 본문을 그대로 받으므로 JSON에서 특정 필드만 꺼낼 수는 없습니다. 토큰은 토큰 설정… 으로 등록합니다.
- MCP: 표준 입출력 방식이면 명령, 인수, 환경 변수를 지정하고, HTTP 방식이면 엔드포인트를 지정합니다. 그런 다음 도구 이름과 인수 JSON을 설정합니다.
npx나uvx를 사용하려면 필요한 런타임을 별도로 설치하십시오.
결과를 보낼 곳 선택
결과는 선택 영역 교체, 커서 위치에 삽입, 문서 전체 교체, 클립보드로 복사, 새 파일로 출력, 터미널에 표시 중에서 선택할 수 있습니다. 문서 전체를 교체한 결과는 자동으로 저장되지 않으므로 결과를 확인한 뒤 저장하십시오.
실행을 시작한 뒤 탭을 전환해도 출력 대상은 바뀌지 않으며, 실행을 시작한 탭에 적용됩니다. 그 탭이 닫혔으면 출력은 새 탭에 열립니다. 진행 중인 실행은 진행 창이나 터미널에서 취소할 수 있습니다.
다른 컴퓨터로 정의 옮기기
외부 연동 탭의 JSON으로 내보내기… / JSON에서 가져오기… 를 사용합니다. 가져오기 전에 실행 파일 경로와 URL을 확인하십시오. 토큰 값은 내보내지지 않으므로 다른 컴퓨터에서 다시 등록하십시오.
라이선스가 편집을 허용하지 않는 동안에는 외부 도구를 실행할 수 없습니다. 상태는 라이선스와 인증에서 확인하십시오.