플러그인·MCP 서버 연동

직접 만든 MCP 서버를 Keural에 연결하고, 데스크톱용 플러그인 패키지를 만드는 방법입니다.

Keural의 플러그인은 MCP(Model Context Protocol) 서버입니다. 내 MCP 서버를 Keural에 연결하거나 데스크톱 앱용 플러그인 패키지를 만들 때의 명세입니다.

전송 방식

플랫폼	전송 방식	용도
웹·모바일	HTTP(Streamable HTTP) · SSE	인터넷에서 닿는 원격 MCP 서버
데스크톱 앱	STDIO · HTTP	이 컴퓨터에서 실행하는 서버, 사내망 HTTP 서버

웹 대화에서는 원격 HTTP·SSE 서버만 씁니다. STDIO 서버는 데스크톱 앱에서 실행됩니다.
서버 주소가 /mcp로 끝나면 대개 Streamable HTTP 서버이므로 전송 방식을 HTTP로 고릅니다.
데스크톱의 HTTP는 사내망 주소용입니다. 공개 인터넷 주소는 웹의 HTTP로 등록합니다.

직접 추가 입력값

설정 → 플러그인 → ＋ 커스텀 MCP 추가의 입력 칸은 다음과 같습니다.

칸	내용
이름	필수
설명	선택
전송 방식	위 표 참고
카테고리	목록 분류
서버 URL	HTTP·SSE일 때 필수. 예: `https://example.com/mcp`
실행 명령	STDIO일 때 필수. 예: `npx`
인자	STDIO 인자(JSON 배열). 예: `["-y", "@scope/server"]`
웹 검색에 이 플러그인 쓰기	켜면 웹 검색 대신 이 플러그인을 씁니다.
인증	없음 · API 키
헤더명 · API 키 값	API 키일 때. 예: 헤더명 `Authorization`, 값 `Bearer …`

API 키를 고르면 요청마다 <헤더명>: <값> 헤더를 붙여 보냅니다.

OAuth 인증 서버

조직 관리자가 OAuth 방식으로 등록한 플러그인은 사용자가 연결을 눌러 로그인합니다.

항목	값
서버 탐색	`/.well-known/oauth-protected-resource`(경로 포함 → 루트), 그다음 `/.well-known/oauth-authorization-server`
클라이언트 등록	동적 클라이언트 등록(DCR)
리디렉션 URI	`https://api.keural.ai/api/user-connectors/oauth/callback`
요청 헤더	`Authorization: Bearer <액세스 토큰>`

로그인 창은 팝업으로 열리며, 로그인이 끝나면 플러그인 목록이 갱신됩니다.

도구 권한

플러그인 도구마다 실행 방식을 정합니다.

권한	동작
항상 허용	확인 없이 실행합니다.
승인 필요	실행 전에 승인 카드를 표시합니다. 카드에 도구 인자가 함께 표시됩니다.
차단	에이전트가 이 도구를 쓰지 않습니다.

데스크톱 플러그인 패키지

데스크톱 앱은 플러그인 ZIP 파일… 또는 플러그인 폴더…로 플러그인을 설치합니다. 패키지에는 매니페스트 plugin.json이 필요합니다.

{
  "id": "my-plugin",
  "name": "My Plugin",
  "version": "1.0.0",
  "description": "사내 시스템 조회",
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": { "API_BASE": "https://intranet.example.com" }
    }
  }
}

필드	필수	내용
`id`	예	영문 소문자·숫자·하이픈
`name`	아니요	표시 이름. 없으면 `id`
`version`	아니요	기본 `1.0.0`
`description`	아니요	설명
`minAppVersion`	아니요	필요한 최소 앱 버전
`mcpServers`	아니요	MCP 서버 정의. 서버마다 `command`, `args`, `env`
`requests`	아니요	요청하는 권한(`capabilities`, `commands`, `connectors`, `secrets`, `permissions`). 문자열 배열

웹에서 등록한 STDIO 플러그인은 데스크톱 앱에서 이 PC에 설치로 설치합니다. 설치 후 인증 토큰과 환경 변수를 직접 입력합니다.

플러그인·MCP 서버 연동

전송 방식링크 복사

직접 추가 입력값링크 복사

OAuth 인증 서버링크 복사

도구 권한링크 복사

데스크톱 플러그인 패키지링크 복사

이 페이지의 내용

전송 방식

직접 추가 입력값

OAuth 인증 서버

도구 권한

데스크톱 플러그인 패키지