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 ツールに触れるエージェントを出荷する

👤 クロードをアプリに埋め込む製品ビルダー ⏱ ~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

結果： ユーザースコープの認証と 1 つの構成 URL を備えた、動作するマルチ SaaS エージェント。

注意点

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

組み合わせ： gmail · スラック

内部運用ボット — 1 つのチャットからチケットのファイル、CRM の更新、Slack への投稿

👤 社内ツールチーム ⏱ ~30 min intermediate

使うタイミング： SaaS スタック全体で「事務処理」ができる 1 つのクロードチャットが必要です。

前提条件

管理者はすべてのアプリを 1 回 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

結果： 各システムのレシートを使用して、ツール間のアクションを 1 つのチャットで完了します。

注意点

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 通話/月。プロ: 100k/月。
呼び出しあたりのトークン: アプリに応じて 100 ～ 2000
金額: フリーミアム + 従量制
ヒント: どのアプリが大量の通話を引き起こしているかを監査し、ダッシュボードでアプリごとの割り当てを設定します

セキュリティ

権限、シークレット、影響範囲

最小スコープ： read (per app) write-scoped (per app)

認証情報の保管： Klavis は OAuth トークンを保持しています。保存時に暗号化される

データ送信先： api.klavis.ai + 各ダウンストリーム SaaS

絶対に付与しない： admin scopes unless truly needed

SOC2 スコープ用のセルフホスト Docker ビルド - ホストされたプレーンがすべてのトラフィックを認識します

トラブルシューティング

よくあるエラーと対処法

proxy_tool_call からの 401

ユーザーの OAuth の有効期限が切れました - get_auth_url を再度呼び出して再接続してもらいます

確認： Call list_connected_apps, check status==connected

サーバー「概念」がゲートウェイにありません

まず Klavis ダッシュボードでこれを有効にしてから、MCP クライアントを再起動して新しいツールを選択します

単一アプリのレート制限

Klavis は retry_after で 429 を返します。後退またはバッチ

代替案

Klavis 他との比較

代替案	代わりに使う場面	トレードオフ
Composio MCP	異なる価格設定の同様のホスト型統合プラットフォームが必要な場合	対象となるアプリが異なります。同様の認証モデル
Self-hosted individual MCPs	単一ユーザー、少数のアプリ、コンプライアンス重視	すべてのアプリの OAuth グルーを所有します

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る