본문으로 건너뛰기

플러그인: Agent에 필요한 능력 더하기

Plugin, Skill, MCP의 차이를 이해하고 필요한 기능을 연결한 뒤 실제 읽기 한 번으로 연결을 확인합니다.

약 7분

이 챕터에서 배울 내용

실제 플러그인 기능을 검증하고 출처와 대조할 수 있는 실제 데이터를 읽는다.

Agent에게 페이지 제작과 파일 정리를 맡길 수 있게 되었다면 다음에는 외부 서비스의 실제 데이터를 읽고 싶을 수 있습니다. 플러그인은 Agent가 어떻게 일하고 무엇에 연결하는지를 담당합니다.

“프로젝트 서비스에서 최근 작업 항목 읽기”처럼 명확한 요구로 시작하세요. 나중에 쓸지도 모른다는 이유로 많은 플러그인을 설치하기보다 각각이 지금 작업에 어떤 도움을 주는지 알아야 합니다.

세 이름의 역할

이름의미확인할 점
Plugin용도별 기능 패키지. Skill과 MCP를 포함할 수 있음포함 내용과 적합한 작업
Skill특정 작업을 수행하는 방법과 자료현재 목표와 입력에 맞는지
MCP ServerAgent에게 외부 도구나 데이터를 제공하는 연결설정, 로그인, 현재 Agent harness 지원 여부

Skill이 있다고 외부 계정 접근 권한이 생기는 것은 아닙니다. MCP가 들어 있는 플러그인도 서비스 연결이 추가로 필요할 수 있습니다. Agent harness는 실행 입구이고 Model은 선택하는 모델이며, 둘 다 플러그인과 별개의 선택입니다.

작업 방법, 연결, 권한
  1. Skill반복해서 쓸 수 있는 작업 방법
  2. MCP 연결외부 서비스를 사용하는 도구
  3. 계정 권한연결이 읽고 쓸 수 있는 범위를 정함
Plugin은 기능을 묶습니다. 연결에는 해당 서비스가 지원하는 설정과 권한이 필요합니다.

플러그인이 방법과 도구를 묶으면 Agent가 그것을 사용해 작업합니다. 연결이 무엇을 읽고 쓸 수 있는지는 외부 서비스의 계정 권한이 정합니다.

설치한 다음 연결 확인하기

대상 워크스페이스에서 사이드바에서 “플러그인”을 직접 엽니다. 기본 화면에는 설치 목록과 플러그인 탐색 영역이 있고 이름, 용도, Skill로 검색할 수 있습니다. 상세 화면의 사용 예와 포함 내용을 읽고 필요한 것을 설치합니다. 소유자와 편집자는 설치, 업데이트, 제거를 할 수 있고 뷰어에게는 같은 관리 작업이 제공되지 않습니다.

설치 후 설치 목록으로 돌아옵니다. 외부 연결이 있는 플러그인은 상세 화면의 연결 상태를 확인하세요. 연결 불필요, 설정 필요, OAuth 로그인 필요, 특정 Agent harness만 지원하는 상태 등이 있습니다. 해당 연결 버튼으로 서비스 로그인 절차를 완료하고 돌아와 상태를 확인합니다.

권한은 두 층으로 이해하세요. 워크스페이스 역할은 플러그인 관리 가능 여부를 정하고, 외부 계정과 승인은 읽고 쓸 수 있는 데이터를 정합니다. 로그인 때 서비스, 계정, 요청하는 접근 범위를 확인하고 공유 워크스페이스에서는 팀이 합의한 용도로 사용합니다.

안내서와 연결 플러그를 담은 도구 트레이에서 열쇠 구멍을 거쳐 외부 데이터로 선이 이어진다.
Plugin은 기능을 묶고 Skill은 방법을 제공하며 MCP는 도구나 데이터를 연결합니다. 설치와 외부 서비스 권한 부여는 별개입니다.

작고 구체적인 읽기로 검증할 수 있습니다.

방금 연결한 프로젝트 서비스에서 제가 지정한 프로젝트의 최근 작업 항목 다섯 개를 읽고 제목, 상태, 출처 링크를 나열해 주세요. 읽기만 하고 수정하지 마세요. 현재 Agent harness가 이 연결을 지원하지 않거나 승인이 부족하면 분명하게 설명하고 예시 데이터로 대신하지 마세요.

검수의 기준은 답변이 그럴듯한지가 아니라 출처를 확인할 수 있는지입니다. 링크 하나를 열어 제목과 상태를 비교하세요. 실제 읽기가 성공하기 전에는 이후 작업이 그 결과에 기대지 않게 합니다.

출처가 분명할 때 고급 메뉴 사용하기

플러그인 화면 오른쪽 위의 고급 메뉴에는 Skills, MCP Servers, Agent Plugins가 있습니다. 개별 Skill은 지원하는 링크, 폴더, 압축 파일 등으로 가져올 수 있습니다. 원격 MCP는 HTTPS 서비스 엔드포인트와 설정 양식을 사용합니다. Agent Plugin은 폴더, ZIP, 공개 GitHub 저장소를 지원합니다.

서비스 제공자의 설명이나 팀이 검토한 리소스를 가진 경우에 적합한 입구입니다. 일반 사용자는 탐색 영역에서 완성된 플러그인을 고르면 포함 내용을 파악하기 쉽습니다. 일반 웹페이지 주소는 MCP 서비스 주소가 아니며 이름을 안다고 이미 설치된 것도 아닙니다.

업데이트 또는 모두 업데이트가 보이면 필요할 때 명시적으로 실행하세요. 자동 업그레이드를 보장하는 것은 아닙니다. 제거는 이 워크스페이스의 플러그인을 없애지만 타사 계정 승인을 취소하지 않습니다. 그 접근까지 중단하려면 해당 서비스의 승인 관리에서 처리해야 합니다.

결과를 팀 눈앞에 두기

읽은 결과를 팀이 언제든 보게 하려면 Agent에게 웹 페이지로 만들어 게시해 달라고 하세요. Workspace 구성원만 열 수 있고, 30일 동안 아무도 열지 않은 페이지는 “계속 보관”을 켜지 않았다면 삭제됩니다. 정기적으로 새로 고치려면 예약 작업을 만들고 프롬프트에 페이지를 다시 만들어 게시하라고 적으세요. 주소는 그대로입니다.

문제가 생기면 앞 단계부터 확인하기

플러그인이 없으면 워크스페이스와 설치 목록을 확인합니다. 연결이 안 되면 설정, OAuth, Agent harness 지원을 확인하세요. 읽은 데이터가 이상하면 출처 링크를 열어 비교하고, 권한을 준 계정과 접근 범위를 확인하세요.

실제 기능 호출 한 번이 성공하고 돌아온 데이터를 출처 링크와 대조할 수 있으면 이 장을 마친 것입니다.