Klavis MCP — Instalar & Demo en vivo

Por qué usarlo

Características clave

MCPs hospedados para Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana, etc.
OAuth 2.0 gestionado de extremo a extremo — sin malabares de tokens por usuario
Un único endpoint MCP independientemente de cuántas apps habilites
Registro de auditoría de cada llamada a herramienta por tenant
Opción de autohospedaje con Docker para entornos con requisitos de cumplimiento estrictos

Demo en vivo

Cómo se ve en la práctica

klavis.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/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"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Klavis

Lanzar un agente que use 5 herramientas SaaS sin 5 flujos de autenticación

👤 Creadores de productos que integran Claude en su aplicación ⏱ ~45 min intermediate

Cuándo usarlo: Tus usuarios quieren que Claude lea Gmail, actualice HubSpot y comente en Jira — y no quieres escribir el pegamento OAuth para cada uno.

Requisitos previos

Cuenta Klavis + clave API — Regístrate en klavis.ai y obtén la clave desde el panel
Servidores seleccionados habilitados — Activa Gmail, HubSpot y Jira en la interfaz de Klavis

Flujo

Conectar el gateway

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

→ La lista de herramientas menciona los endpoints de Gmail, HubSpot y Jira
Conexión del usuario final

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

→ URL OAuth devuelta; tras el callback muestra connected:true
Acción entre aplicaciones

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

→ Las tres APIs llamadas en un solo flujo con rastro de auditoría

Resultado: Un agente multi-SaaS funcional con autenticación por usuario y una sola URL de configuración.

Errores comunes

Los tokens de usuario caducan silenciosamente — Suscríbete al webhook auth_expired y pide al usuario que vuelva a conectar

Combinar con: gmail · slack

Bot de operaciones interno — crea tickets, actualiza el CRM y publica en Slack desde un solo chat

👤 Equipos de herramientas internas ⏱ ~30 min intermediate

Cuándo usarlo: Quieres un chat con Claude que pueda «hacer el papeleo» en todo tu stack SaaS.

Requisitos previos

Admin autentica todas las apps una vez — Conecta cada app desde la cuenta del equipo, no por usuario

Flujo

Conectar el stack

Add Klavis. Confirm Salesforce, Jira, Slack are all connected.✓ Copiado

→ Los tres muestran estado conectado
Triaje de mensaje

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.✓ Copiado

→ Caso y bug creados; la respuesta en Slack los enlaza

Resultado: Acción entre herramientas completada en un chat con confirmaciones en cada sistema.

Errores comunes

Límites de tasa en Slack — El panel de Klavis muestra la cuota por app; agrupa operaciones cuando sea posible

Combinar con: slack · linear

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

klavis + gmail

MCP de Gmail local para uso personal, Klavis para datos de clientes

Use my local Gmail MCP for me, Klavis for customer data.✓ Copiado

klavis + slack

Publicar actualizaciones de estado desde flujos de operaciones

After creating the Salesforce case, post a summary in #customers via Klavis.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_connected_apps	user_id?: str	Comprobar qué apps tiene conectadas un usuario	free
get_auth_url	app: str, user_id: str	Iniciar el flujo OAuth de un usuario	free
proxy_tool_call	app, tool, args, user_id	Cualquier llamada a herramienta downstream — Klavis la enruta	varies by app

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Plan gratuito: 1k llamadas/mes. Pro: 100k/mes.
Tokens por llamada: 100–2000 según la aplicación
Monetario: Freemium + basado en uso
Consejo: Audita qué apps concentran la mayor parte de llamadas y fija cuotas por app en el panel

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: read (per app) write-scoped (per app)

Almacenamiento de credenciales: Klavis almacena los tokens OAuth cifrados en reposo

Salida de datos: api.klavis.ai + cada SaaS downstream

No conceder nunca: admin scopes unless truly needed

Usa el build Docker autohospedado para entornos SOC2 — el plano hospedado ve todo el tráfico

Resolución de problemas

Errores comunes y soluciones

401 from proxy_tool_call

El OAuth del usuario caducó — llama a get_auth_url de nuevo y pide al usuario que vuelva a conectar

Verificar: Call list_connected_apps, check status==connected

El servidor "notion" no está en el gateway

Habilítalo primero en el panel de Klavis y reinicia el cliente MCP para que detecte las nuevas herramientas

Límite de tasa en una app individual

Klavis devuelve 429 con retry_after; espera o agrupa las llamadas

Alternativas

Klavis vs otros

Alternativa	Cuándo usarla	Contrapartida
Composio MCP	Quieres una plataforma de integraciones hospedada similar con precios diferentes	Cobertura de apps distinta; modelo de autenticación similar
Self-hosted individual MCPs	Un único usuario, pocas apps, entorno sensible al cumplimiento	Debes gestionar el pegamento OAuth de cada app por tu cuenta

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills