/ 目录 / 演练场 / Klavis
● 社区 Klavis-AI 🔑 需要你的密钥

Klavis

作者 Klavis-AI · Klavis-AI/klavis

托管式 MCP 集成平台——一次认证,一个网关,覆盖 Slack、Salesforce、GCal 等 50 多个应用的 MCP 服务器。

Klavis 托管生产级 MCP 服务器,OAuth 和多租户认证均已处理好。不用在本地安装 20 个 MCP、管理 20 个 token,只需一个网关 URL。特别适合向终端用户部署 agent——用户点击「连接 Slack」,OAuth 流程由 Klavis 全权处理。

为什么要用

核心特性

实时演示

实际使用效果

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 个 SaaS 工具的 agent,只需一套认证流程

👤 在自己应用中嵌入 Claude 的产品开发者 ⏱ ~45 min intermediate

何时使用: 你的用户希望 Claude 能读取 Gmail、更新 HubSpot、评论 Jira——而你不想为每个应用单独写 OAuth 胶水代码。

前置条件
  • Klavis 账号 + API key — 在 klavis.ai 注册并从控制台获取 key
  • 已启用所需服务器 — 在 Klavis UI 中开启 Gmail、HubSpot、Jira
步骤
  1. 接入网关
    用我的 token 将 Klavis 添加为 MCP 服务器。列出当前可用的工具。✓ 已复制
    → 工具列表中出现 Gmail、HubSpot、Jira 端点
  2. 终端用户授权
    为 user_id=xyz 生成 Connect-Gmail 的 URL。用户完成后,确认认证是否成功。✓ 已复制
    → 返回 OAuth URL;回调后显示 connected:true
  3. 跨应用操作
    针对来自 acme.com 的最新邮件,创建一个 HubSpot 联系人和一个汇总邮件线索的 Jira 工单。✓ 已复制
    → 一次流程中命中三个 API,并留有审计记录

结果: 一个支持用户级独立授权、只需一个配置 URL 的多 SaaS agent。

注意事项
  • 用户 token 静默失效 — 订阅 auth_expired webhook,提示用户重新授权
搭配使用: gmail · slack

内部运营 bot——在一个对话里提工单、更新 CRM、发 Slack 消息

👤 内部工具团队 ⏱ ~30 min intermediate

何时使用: 你想用一个 Claude 对话窗口处理整个 SaaS 堆栈的「文书工作」。

前置条件
  • 管理员账户一次性完成所有应用的 OAuth — 从团队账户而非用户账户连接各应用
步骤
  1. 接入工具栈
    添加 Klavis。确认 Salesforce、Jira、Slack 全部已连接。✓ 已复制
    → 三个应用均显示已连接状态
  2. 处理用户投诉
    针对 Slack #support 最新消息中的客户投诉:创建一个 Salesforce 案例、一个 Jira bug,并在线程中回复工单链接。✓ 已复制
    → Case 和 bug 已创建;Slack 回复包含两者链接

结果: 一次对话完成跨工具操作,每个系统均留有记录。

注意事项
  • Slack 触发频率限制 — 在 Klavis 控制台查看各应用配额;操作尽量批量进行
搭配使用: slack · linear

组合

与其他 MCP 搭配,撬动十倍杠杆

klavis + gmail

本地 Gmail MCP 用于个人场景,Klavis 用于多用户场景

我自己用本地 Gmail MCP,客户数据走 Klavis。✓ 已复制
klavis + slack

在运营流程完成后推送状态更新

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 配额
免费版:每月 1k 次调用。Pro:每月 10 万次。
每次调用 Token 数
100–2000,视应用而定
费用
免费增值 + 按量计费
提示
在控制台审查哪些应用消耗了大部分调用次数,并为其设置单独的配额上限

安全

权限、密钥、影响范围

最小权限: read (per app) write-scoped (per app)
凭据存储: Klavis 持有 OAuth token,静态加密存储
数据出站: api.klavis.ai + 各下游 SaaS
切勿授予: admin scopes unless truly needed

故障排查

常见错误与修复

401 from proxy_tool_call

用户 OAuth 已过期——重新调用 get_auth_url 让用户重新授权

验证: Call list_connected_apps, check status==connected
Server "notion" not in gateway

先在 Klavis 控制台启用该服务器,然后重启 MCP 客户端以加载新工具

Rate limit on a single app

Klavis 返回 429 并附带 retry_after;退避等待或改为批量操作

替代方案

Klavis 对比其他方案

替代方案何时用它替代权衡
Composio MCP你想要类似的托管集成平台但定价不同应用覆盖范围不同;认证模型类似
Self-hosted individual MCPs单人使用、应用数量少、合规敏感需要自己为每个应用编写 OAuth 胶水代码

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills