Klavis MCP — Instalar & Demo ao vivo

Por que usar

Principais recursos

MCPs hospedados para Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana, entre outros
OAuth 2.0 gerenciado de ponta a ponta — sem malabarismo de tokens por usuário
Um único endpoint MCP, independentemente de quantos apps você ativar
Log de auditoria de cada chamada de ferramenta por tenant
Opção de auto-hospedagem via Docker para ambientes com requisitos de conformidade

Demo ao vivo

Como fica na prática

klavis.replay ▶ pronto

0/0

Instalar

Escolha seu 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"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a 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"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o 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"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Klavis

Publicar um agente que acessa 5 ferramentas SaaS sem 5 fluxos de autenticação

👤 Desenvolvedores de produtos que incorporam Claude em seus apps ⏱ ~45 min intermediate

Quando usar: Seus usuários querem que o Claude leia o Gmail, atualize o HubSpot e comente no Jira — e você não quer escrever a cola OAuth para cada um.

Pré-requisitos

Conta Klavis + chave de API — Cadastre-se em klavis.ai e pegue a chave no dashboard
Servidores selecionados habilitados — Ative Gmail, HubSpot e Jira na interface da Klavis

Fluxo

Conectar o gateway

Adicione a Klavis como servidor MCP com meu token. Liste quais ferramentas estão disponíveis agora.✓ Copiado

→ Lista de ferramentas menciona endpoints do Gmail, HubSpot e Jira
Conexão do usuário final

Gere a URL de Conexão do Gmail para user_id=xyz. Quando ele retornar, confirme se o auth foi bem-sucedido.✓ Copiado

→ URL OAuth retornada; callback mostra connected:true
Ação entre apps

Para o último Gmail de acme.com, crie um contato no HubSpot e um ticket no Jira resumindo a thread.✓ Copiado

→ As três APIs acionadas em um único fluxo com trilha de auditoria

Resultado: Um agente multi-SaaS funcional com autenticação por usuário e uma única URL de configuração.

Armadilhas

Tokens de usuário expiram silenciosamente — Assine o webhook auth_expired e peça ao usuário para reconectar

Combine com: gmail · slack

Bot de operações internas — abrir tickets, atualizar CRM, postar no Slack, tudo em um chat

👤 Times de ferramentas internas ⏱ ~30 min intermediate

Quando usar: Você quer um único chat do Claude que consiga "fazer a papelada" em todo o seu stack SaaS.

Pré-requisitos

Admin faz OAuth de todos os apps uma única vez — Conecte cada app pela conta do time, não por usuário

Fluxo

Conectar o stack

Adicione a Klavis. Confirme que Salesforce, Jira e Slack estão todos conectados.✓ Copiado

→ Os três mostram status de conectado
Triar reclamação

Para a reclamação do cliente na última mensagem do Slack no #support: crie um caso no Salesforce, um bug no Jira e responda na thread com os links dos tickets.✓ Copiado

→ Caso + bug criados; resposta no Slack com links

Resultado: Ação entre ferramentas concluída em um chat com comprovantes em cada sistema.

Armadilhas

Limites de taxa no Slack — O dashboard da Klavis mostra a cota por app; agrupe operações quando possível

Combine com: slack · linear

Combinações

Combine com outros MCPs para 10× de alavancagem

klavis + gmail

MCP local do Gmail para uso pessoal, Klavis para dados de clientes

Use meu MCP local do Gmail para mim, Klavis para os dados dos clientes.✓ Copiado

klavis + slack

Postar atualizações de status a partir de fluxos de operações

Após criar o caso no Salesforce, poste um resumo em #customers via Klavis.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_connected_apps	user_id?: str	Verificar quais apps um determinado usuário conectou	free
get_auth_url	app: str, user_id: str	Iniciar o fluxo OAuth do usuário	free
proxy_tool_call	app, tool, args, user_id	Qualquer chamada de ferramenta downstream — a Klavis roteia	varies by app

Custo e limites

O que custa rodar

Cota de API: Plano gratuito: 1k chamadas/mês. Pro: 100k/mês.
Tokens por chamada: 100–2000 dependendo do app
Monetário: Freemium + baseado em uso
Dica: Verifique quais apps concentram a maioria das chamadas e defina cotas por app no dashboard

Segurança

Permissões, segredos, alcance

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

Armazenamento de credenciais: A Klavis guarda os tokens OAuth; criptografados em repouso

Saída de dados: api.klavis.ai + cada SaaS downstream

Nunca conceda: admin scopes unless truly needed

Use o build Docker para auto-hospedagem em escopos SOC2 — o plano hospedado vê todo o tráfego

Solução de problemas

Erros comuns e correções

401 do proxy_tool_call

OAuth do usuário expirou — chame get_auth_url novamente e peça ao usuário para reconectar

Verificar: Chame list_connected_apps e confira status==connected

Servidor "notion" não está no gateway

Habilite-o no dashboard da Klavis primeiro, depois reinicie o cliente MCP para carregar as novas ferramentas

Limite de taxa em um único app

A Klavis retorna 429 com retry_after; recue ou agrupe as requisições

Alternativas

Klavis vs. outros

Alternativa	Quando usar	Troca
Composio MCP	Você quer uma plataforma de integração hospedada similar com preços diferentes	Cobertura de apps diferente; modelo de auth semelhante
Self-hosted individual MCPs	Usuário único, poucos apps, sensível a conformidade	Você cuida da cola OAuth para cada app

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills