Klavis MCP — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana 등을 위한 호스팅된 MCP
OAuth 2.0은 엔드투엔드 처리 — 사용자별 토큰 저글링 없음
활성화한 앱 수에 관계없이 단일 MCP 엔드포인트
테넌트당 모든 도구 호출에 대한 감사 로그
규정 준수가 많은 환경을 위한 Docker를 통한 자체 호스트 옵션

라이브 데모

실제 사용 모습

klavis.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "klavis",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "klavis": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add klavis -- npx -y mcp-remote https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Klavis

5개의 인증 흐름 없이 5개의 SaaS 도구를 다루는 에이전트 출시

👤 Claude를 앱에 삽입하는 제품 빌더 ⏱ ~45 min intermediate

언제 쓸까: 사용자는 Claude가 Gmail을 읽고, HubSpot을 업데이트하고, Jira에 댓글을 달기를 원하지만, 각각에 대해 OAuth 접착제를 작성하고 싶지는 않습니다.

사전 조건

Klavis 계정 + API 키 — klavis.ai에 가입하고 대시보드에서 키를 받으세요.
선택한 서버가 활성화되었습니다. — Klavis UI에서 Gmail, HubSpot, Jira를 켭니다.

흐름

게이트웨이 배선

Add Klavis as an MCP server with my token. List which tools are now available.✓ 복사됨

→ Tool list mentions Gmail, HubSpot, Jira endpoints
최종 사용자 연결

Generate the Connect-Gmail URL for user_id=xyz. When they return, confirm auth succeeded.✓ 복사됨

→ OAuth URL returned; post-callback shows connected:true
교차 앱 작업

For the latest Gmail from acme.com, create a HubSpot contact and a Jira ticket summarizing the thread.✓ 복사됨

→ All three APIs hit in one flow with audit trail

결과: 사용자 범위 인증과 하나의 구성 URL을 사용하여 작동하는 다중 SaaS 에이전트입니다.

함정

User tokens expire silently — Subscribe to the auth_expired webhook and prompt the user to reconnect

함께 쓰기: 지메일 · 느슨하게

내부 운영 봇 — 단일 채팅을 통해 티켓 제출, CRM 업데이트, Slack에 게시

👤 내부 도구 팀 ⏱ ~30 min intermediate

언제 쓸까: SaaS 스택 전체에서 "문서 작업"을 수행할 수 있는 하나의 Claude 채팅이 필요합니다.

사전 조건

관리자 OAuth는 모든 앱을 한 번에 인증합니다. — 사용자별로가 아닌 팀 계정에서 각 앱을 연결하세요.

흐름

스택 연결

Add Klavis. Confirm Salesforce, Jira, Slack are all connected.✓ 복사됨

→ All three show connected status
분류 이메일

For the customer complaint in the last Slack #support message: create a Salesforce case, a Jira bug, and reply-in-thread with the ticket links.✓ 복사됨

→ Case + bug created; Slack reply links them

결과: 각 시스템의 영수증과 함께 한 번의 채팅으로 교차 도구 작업이 완료되었습니다.

함정

Rate limits on Slack — Klavis dashboard shows per-app quota; batch operations when possible

함께 쓰기: 느슨하게 · 선의

조합

다른 MCP와 조합해 10배 효율

klavis + gmail

Local Gmail MCP for personal, Klavis for multi-user

저는 로컬 Gmail MCP를 사용하고, 고객 데이터에는 Klavis를 사용하세요.✓ 복사됨

klavis + slack

Post status updates from ops flows

Salesforce 케이스를 생성한 후 Klavis를 통해 #customers에 요약을 게시합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_connected_apps	user_id?: str	특정 사용자가 어떤 앱을 연결했는지 확인	free
get_auth_url	app: str, user_id: str	사용자 OAuth 흐름 시작	free
proxy_tool_call	app, tool, args, user_id	모든 다운스트림 도구 호출 - Klavis가 이를 라우팅합니다.	varies by app

비용 및 제한

운영 비용

API 쿼터: 무료 등급: 통화 1,000개/월 장점: 100,000/월
호출당 토큰: 앱에 따라 100~2000
금액: 프리미엄 + 사용량 기반
팁: 어떤 앱이 대량 통화를 유도하는지 감사하고 대시보드에서 앱별 할당량을 설정하세요.

보안

권한, 시크릿, 파급범위

최소 스코프: read (per app) write-scoped (per app)

자격 증명 저장: Klavis는 OAuth 토큰을 보유하고 있습니다. 미사용 암호화됨

데이터 외부 송신: api.klavis.ai + 각 다운스트림 SaaS

절대 부여 금지: admin scopes unless truly needed

SOC2 범위용 자체 호스트 Docker 빌드 - 호스팅된 평면에서 모든 트래픽을 확인합니다.

문제 해결

자주 발생하는 오류와 해결

401 from proxy_tool_call

사용자의 OAuth가 만료되었습니다. get_auth_url을 다시 호출하고 다시 연결하도록 하세요.

확인: Call list_connected_apps, check status==connected

게이트웨이에 없는 서버 "notion"

먼저 Klavis 대시보드에서 활성화한 다음 MCP 클라이언트를 다시 시작하여 새 도구를 선택하세요.

단일 앱의 비율 제한

Klavis는 retry_after로 429를 반환합니다. 물러서거나 일괄 처리

대안

Klavis 다른 것과 비교

대안	언제 쓰나	단점/장점
Composio MCP	가격이 다른 유사한 호스팅 통합 플랫폼을 원합니다.	다양한 앱 적용 범위 유사한 인증 모델
Self-hosted individual MCPs	단일 사용자, 소수의 앱, 규정 준수에 민감	모든 앱에 대한 OAuth 접착제를 소유하고 있습니다.

Klavis

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Klavis

5개의 인증 흐름 없이 5개의 SaaS 도구를 다루는 에이전트 출시

사전 조건

흐름

함정

내부 운영 봇 — 단일 채팅을 통해 티켓 제출, CRM 업데이트, Slack에 게시

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Klavis 다른 것과 비교

더 보기

리소스