Clevra

npx add-mcp 'https://app.clevra.ai/api/mcp'

Servidor MCP da Clevra

A Clevra opera um servidor remoto Model Context Protocol (MCP). Adicione-o a qualquer assistente de IA que suporte servidores MCP remotos, como Claude ou ChatGPT, e o assistente poderá trabalhar com os dados da sua empresa na Clevra: responder perguntas sobre sua agenda, trabalhos, faturas e clientes, além de realizar um pequeno conjunto de ações do dia a dia, como elaborar um orçamento ou agendar uma visita. O assistente sempre age como você, com exatamente o acesso que seu perfil na Clevra concede.

Usa o Claude? A página Clevra for Claude tem instruções passo a passo para o Claude.

Detalhes do servidor

URL do servidor	https://app.clevra.ai/api/mcp
Transporte	Streamable HTTP, sem estado. As solicitações são JSON-RPC sobre POST; não há stream iniciado pelo servidor nem sessão a manter.
Versões do protocolo	2025-11-25 (com o handshake initialize) e 2026-07-28.
Autenticação	Fluxo de código de autorização OAuth 2.1 com PKCE (S256). A pessoa faz login com seu login habitual da Clevra e aprova o acesso; o assistente recebe um token de acesso revogável e o envia no cabeçalho Authorization: Bearer. Tokens na URL são recusados.
Descoberta	Protected Resource Metadata (RFC 9728) em https://app.clevra.ai/.well-known/oauth-protected-resource/api/mcp. Ele nomeia o servidor de autorização, cujos próprios metadados listam os endpoints de autorização, token e registro. Toda resposta 401 aponta para ele no cabeçalho WWW-Authenticate.
Registro do cliente	Client ID Metadata Documents ou Dynamic Client Registration. Nenhuma chave de API ou segredo pré-compartilhado é necessário.
Escopos	Nenhum. O que o assistente pode ver e fazer é decidido pelo perfil da pessoa na Clevra a cada solicitação.
Capacidades	Ferramentas (tools/list, tools/call). Cada ferramenta declara um JSON Schema para sua entrada e carrega um título e anotações de somente leitura ou escrita.

O que você precisa

• Uma conta Clevra com o perfil Org Admin, Manager ou Dispatcher.
• Um plano Clevra que inclua o assistente de IA: Pro, Business ou Custom (ou um teste ativo).
• Um assistente de IA ou cliente MCP que suporte servidores MCP remotos com login OAuth.

Conecte seu assistente

1. Nas configurações do seu assistente, adicione um conector personalizado. Dependendo do assistente, ele pode ser chamado de conector, aplicativo, integração ou servidor MCP.
2. Cole a URL do servidor:
   https://app.clevra.ai/api/mcp Nenhuma chave de API é necessária. Se o assistente pedir um tipo de autenticação, escolha OAuth.
3. Faça login com seu login habitual da Clevra e aprove o acesso na tela de consentimento.
4. Pronto. Faça sua primeira pergunta.

Você pode verificar sua conexão a qualquer momento na Clevra em Configurações → Aplicativos conectados. Essa página também mostra a URL do servidor e exatamente o que um assistente pode e não pode fazer.

Ferramentas

Ferramentas de leitura. Elas consultam informações, limitadas ao que seu perfil pode ver:

Ferramenta	O que faz
list_clients, get_client	Encontra clientes e lê os detalhes de um cliente
list_client_notes	Lê as anotações de um cliente
get_client_billing_standing	Saldo pendente e vencido de um cliente
list_jobs, get_job	Encontra trabalhos e lê um trabalho, incluindo suas visitas agendadas
get_job_stats	Contagens e totais de trabalhos
get_job_profit	Lucro de um trabalho, apenas para perfis que podem ver custos
list_invoices, get_invoice	Encontra faturas e lê uma
list_quotes, get_quote	Encontra orçamentos e lê um
list_requests, get_request	Encontra solicitações de serviço e lê uma
get_schedule	A agenda para um intervalo de datas
find_open_slots	Tempo livre para um membro da equipe em um intervalo de datas
list_activities	Chamadas, e-mails, reuniões e outras atividades registradas
list_team_members	Sua lista de equipe
Ferramentas de relatório	Execute qualquer relatório do hub de Relatórios incluído no seu plano

Ferramentas de ação. Elas são marcadas como ferramentas de escrita, então seu assistente pode pedir confirmação antes de cada execução:

Ferramenta	O que faz
create_client	Criar um cliente
add_client_note	Adicionar uma anotação a um cliente
create_activity	Registrar uma atividade
create_task	Criar uma tarefa
create_quote_draft	Elaborar um orçamento. Ele permanece como rascunho até você enviá-lo pela Clevra.
schedule_visit	Agendar uma visita. O agendamento envia as mensagens automáticas da sua empresa, como confirmações e lembretes, exatamente como agendar na Clevra faz, então esta ferramenta é marcada como destrutiva.

Toda ação segue as mesmas regras do aplicativo Clevra e é registrada na trilha de auditoria da Clevra como feita por um assistente de IA. Cada registro em uma resposta inclui um link que o abre na Clevra.

O que o servidor não pode fazer. Ele nunca:

• envia e-mails ou mensagens de texto por conta própria
• recebe ou reembolsa pagamentos
• exclui nada
• converte orçamentos em trabalhos
• importa dados
• altera cobrança, folha de pagamento, associação à equipe ou configurações da empresa.

Faça isso na Clevra.

Experimente perguntar

• "O que está na agenda para amanhã e quem está atribuído a cada visita?"
• "Quais faturas estão vencidas e quanto está pendente no total?"
• "Mostre tudo o que fizemos para a Acme Property Management este ano."
• "Encontre um horário de duas horas para a Maria na próxima semana e agende a visita de acompanhamento para o trabalho da Oak Street."
• "Elabore um orçamento para a Jane Smith: manutenção anual do forno mais uma troca de filtro."
• "Execute o relatório de receita do mês passado e me diga quais serviços cresceram mais."

Permissões e privacidade

• Seu perfil, nada mais. O assistente vê e faz apenas o que seu perfil na Clevra permite. Taxas de pagamento e custos ficam ocultos para perfis que não podem vê-los no aplicativo, e uma mudança de perfil tem efeito na próxima solicitação.
• A Clevra não recebe suas conversas. A Clevra vê apenas as solicitações que o assistente faz em seu nome. Para cada solicitação, ela mantém um registro de acesso (qual conexão, qual ferramenta, o resultado e quanto tempo levou), nunca o conteúdo. Os registros de acesso são excluídos após 90 dias.
• O que o assistente recebe é tratado pelo provedor dele. Os dados retornados ao seu assistente são processados sob seu acordo com o provedor desse assistente. Consulte nossa Política de Privacidade.
• Sua senha permanece com a Clevra. Você faz login pela própria página de login da Clevra, e o assistente recebe um token de acesso revogável.

Controles para administradores

Na Clevra, em Configurações → Aplicativos conectados, os administradores podem:

• ver todas as conexões da empresa e desconectar qualquer uma delas;
• desativar Permitir conexões de assistentes de IA para pausar todas as conexões de uma vez;
• desativar Permitir ações por meio de assistentes de IA para manter todos os assistentes somente leitura para toda a empresa.

Limites

• Até cinco conexões ativas por pessoa.
• 120 solicitações por minuto por conexão e 3.000 solicitações por 10 minutos por empresa.
• 2.000 chamadas de ferramenta por conexão e 10.000 por empresa por dia, contadas no fuso horário da sua empresa.
• Usar o servidor não conta contra a cota mensal de mensagens do assistente de IA no aplicativo.

Desconectar ou reconectar

• Desconectar: na Clevra, vá em Configurações → Aplicativos conectados e selecione Desconectar. A próxima solicitação do assistente será recusada. Você também pode remover o conector nas configurações do seu assistente.
• Reconectar após desconectar: em Configurações → Aplicativos conectados, selecione Conectar e reconecte a Clevra no seu assistente dentro de uma hora.

Solução de problemas

O que seu assistente diz	O que fazer
"Seu perfil não inclui o conector de assistente de IA"	Peça ao seu administrador para conceder o perfil Org Admin, Manager ou Dispatcher. Nenhuma reconexão é necessária.
"O assistente de IA não está incluído no plano da sua empresa"	Um administrador pode alterar o plano em Configurações → Cobrança. Nenhuma reconexão é necessária.
"As conexões de assistentes de IA estão pausadas"	Um administrador desativou Permitir conexões de assistentes de IA em Configurações → Aplicativos conectados.
"Esta conexão foi desconectada…"	Na Clevra, pressione Conectar em Configurações → Aplicativos conectados e conecte a Clevra novamente no seu assistente.
"Conecte a Clevra para continuar"	Faça login com sua conta de funcionário da Clevra. Se você acabou de pressionar Conectar na Clevra, pressione novamente; cada solicitação de conexão é válida por uma hora.

Suporte

Dúvidas ou problemas: hi@clevra.ai.