MCP 서버와 스킬 추가하기

에이전트에 추가 도구나 서비스 연결이 필요하면 MCP 서버를 추가하세요. 특정 종류의 작업에 대한 지침과 자료를 재사용하려면 스킬을 추가하세요. Noea는 여러 에이전트의 일반 채팅에서 쓸 확장 기능을 한곳에서 관리합니다.

확장 기능은 선택 사항이며 시작할 때 꼭 필요하지는 않습니다. 설명과 정리 작업은 여기에서 추가한 확장 기능을 사용하지 않습니다.

필요한 확장 기능 선택하기

서버의 사용 가능 여부는 에이전트가 해당 연결 방식을 지원하는지에 따라서도 달라집니다. 스킬 명령은 채팅에 실제로 표시되는 목록을 기준으로 사용하세요.

MCP 서버 추가하기

설정 → MCP 서버를 열어 서버를 추가하고, 이름을 입력한 다음 연결 방식을 선택하세요.

• stdio: 로컬에서 서비스를 시작합니다. 명령, 인수, 필요한 환경 변수를 입력하세요. 인수는 한 줄에 하나씩 입력합니다.
• HTTP: URL로 서비스에 연결합니다. 서버 주소와 필요한 헤더를 입력하세요.

서비스가 호환되는 JSON 설정을 제공하면 JSON 붙여넣기로 양식을 채울 수 있습니다. 저장하기 전에 명령, 주소, 인증 필드를 확인하세요.

이름은 대소문자를 구분하지 않고 고유해야 합니다. noea로 시작하는 이름은 예약되어 있습니다. 첫 행은 Noea 기본 제공 서버로, 항상 활성화되어 있으며 삭제할 수 없습니다.

연결 테스트하기

편집 패널의 연결 테스트는 현재 양식 값을 사용합니다. 목록에서 테스트하면 저장된 설정을 사용합니다.

성공하면 도구 이름과 개수가 표시됩니다. 실패하면 명령 없음, 프로세스 종료, 시간 초과, 요청 거부, 핸드셰이크 실패 등 실패한 단계를 알려 줍니다. HTTP 서비스에서 권한 부여를 요구하면 선택한 에이전트의 인증 절차를 따르세요.

테스트 성공은 해당 설정으로 연결할 수 있다는 뜻입니다. 모든 에이전트가 지원한다는 보장은 아니며, 채팅에서 서버를 자동으로 활성화하지도 않습니다.

채팅에서 서버 활성화하기

서버 목록의 새 채팅 기본 설정이 처음 선택되는 서버를 결정합니다. 특정 채팅의 설정 메뉴에서도 MCP 서버를 선택할 수 있습니다.

선택은 채팅과 함께 저장됩니다. 연결된 에이전트는 변경된 설정을 즉시 다시 읽지 않으며, 다음 연결 때 적용합니다. 새 설정을 사용하려면 새 채팅을 시작하고 서버 선택을 확인하세요.

환경 변수 누락이나 지원하지 않는 연결 방식 등 서버를 사용할 수 없는 이유는 메뉴에 표시됩니다.

환경 변수 사용하기

환경 변수와 헤더 값은 ${VAR}로 Noea 실행 환경의 변수를 참조할 수 있습니다. 값은 연결할 때 읽습니다. 설정 후 연결을 테스트하세요. 한 터미널에서 export를 실행해도 이미 실행 중인 Noea 프로세스에 그 값이 전달된다고 보장할 수는 없습니다.

필드는 기본적으로 값을 숨기며 클릭해서 표시할 수 있습니다. 숨김은 화면 표시만 제어하고, 설정의 저장 방식이나 사용 방식은 바꾸지 않습니다.

스킬 추가하기

설정 → 스킬에서 추가를 선택하고 SKILL.md가 있는 폴더를 지정하세요. 형식에 문제가 있으면 앱이 안내합니다.

스킬은 Noea 라이브러리에 추가됩니다. 추가와 제거는 새 채팅에서 적용됩니다. 파일 관리자에서 위치를 볼 수 있습니다. 삭제는 라이브러리 복사본만 제거하며, 처음 선택한 원본 폴더는 제거하지 않습니다.

같은 페이지에 에이전트 디렉터리에서 발견한 사용자 및 프로젝트 수준의 스킬도 읽기 전용으로 표시됩니다. 위치를 확인하거나 Noea로 복사를 선택할 수 있습니다. 이 목록이 에이전트에 내장되거나 플러그인으로 제공되는 모든 스킬을 포함하는 것은 아닙니다.

채팅에서 확장 기능 사용하기

새 채팅을 시작하고 입력창 처음에 /를 입력해 Noea 스킬과 에이전트 명령을 살펴보세요. 사용 가능한 항목을 선택하고 현재 작업의 요구사항을 추가한 다음 보냅니다.

확장 기능이 보이지 않으면 새 채팅을 시작했는지, 에이전트가 지원하는지 확인한 다음 문제 해결을 참고하세요.