
Adicione Pontuação de Confiança ao Seu Agente MCP em 5 Minutos
Adicione Pontuação de Confiança ao Seu Agente MCP em 5 Minutos
Você tem um agente MCP. Ele se conecta a ferramentas, toma decisões, realiza ações. A questão é: alguém mais confia nele?
Este tutorial orienta sobre como adicionar pontuação de confiança real ao seu agente usando AgentLair — infraestrutura de identidade construída para o ecossistema MCP. Não é um selo auto-declarado "este agente é seguro". Telemetria comportamental real em três dimensões: consistência, contenção e transparência.
O que você irá construir:
- Uma identidade de agente registrada (endereço de e-mail + chave de API)
- Integração do servidor MCP no Claude Code ou Cursor
- Um selo de confiança embutido para seu README
- Uma pontuação de confiança que melhora à medida que seu agente se comporta de forma consistente
Todo o processo leva cerca de 5 minutos. Você não precisa de um cartão de crédito.
Antes de começar: experimente o motor de confiança sem se inscrever
# Agente saudável — 3 meses de histórico comportamental limpo
curl https://agentlair.dev/v1/demo?scenario=healthy | jq
# Novo agente — início frio, intervalo de confiança amplo
curl https://agentlair.dev/v1/demo?scenario=new | jq
# Agente suspeito — escopo ampliado, telemetria suprimida
curl https://agentlair.dev/v1/demo?scenario=suspicious | jq
Você verá pontuações de confiança, intervalos de confiança, dimensões comportamentais e sinais de tendência. O cenário saudável retorna uma pontuação em torno de 84 (nível "principal"). O novo agente está em torno de 34 com um intervalo de confiança amplo — ele simplesmente ainda não construiu histórico. O suspeito está em torno de 31 e em declínio.
Isso lhe dá uma imagem concreta do que você está construindo.
Passo 1: Registre seu agente
Uma chamada. Sem formulário de inscrição.
curl -X POST https://agentlair.dev/v1/auth/agent-register \
-H "Content-Type: application/json" \
-d '{"name": "meu-agente-de-pesquisa"}'
Resposta:
{
"api_key": "al_live_...",
"email_address": "meu-agente-de-pesquisa@agentlair.dev",
"account_id": "...",
"limits": {
"emails_per_day": 10,
"addresses": 10,
"api_requests_per_day": 100
}
}
Salve a api_key e account_id. Você precisará de ambos.
Seu agente agora tem:
- Um endereço de e-mail persistente (pode enviar e receber)
- Uma chave de API restrita à sua identidade
- Um
account_idusado para sua URL de selo de confiança
O nível gratuito oferece 10 e-mails/dia, 10 endereços e 100 solicitações de API/dia. Nenhum cartão de crédito necessário.
Passo 2: Instale o servidor MCP
npx @agentlair/mcp@latest
Esta é a versão @agentlair/mcp 1.2.0. Requer Node >= 18.
O servidor MCP expõe 14 ferramentas: e-mail (enviar, receber, listar), cofre (armazenar e recuperar segredos criptografados), calendário (criar eventos, gerar feeds iCal) e delegação de tarefas. Tudo o que seu agente precisa para atuar como um verdadeiro participante em fluxos de trabalho.
Passo 3: Configure no Claude Code ou Cursor
Claude Code — adicione ao seu .mcp.json (nível de projeto) ou ~/.claude/mcp.json (global):
{
"mcpServers": {
"agentlair": {
"command": "npx",
"args": ["@agentlair/mcp@latest"],
"env": {
"AGENTLAIR_API_KEY": "al_live_seu_key_aqui"
}
}
}
}
Cursor — adicione ao .cursor/mcp.json em seu projeto:
{
"mcpServers": {
"agentlair": {
"command": "npx",
"args": ["@agentlair/mcp@latest"],
"env": {
"AGENTLAIR_API_KEY": "al_live_seu_key_aqui"
}
}
}
}
Windsurf — mesmo padrão na sua configuração MCP do Windsurf.
Reinicie seu editor. As 14 ferramentas do AgentLair aparecerão na sua lista de ferramentas MCP.
Passo 4: A pontuação de confiança acontece automaticamente
Uma vez que seu agente esteja registrado e fazendo chamadas de API, a telemetria comportamental começa a acumular
Este tutorial é essencial para empresas brasileiras que utilizam agentes MCP, pois melhora a confiança do usuário e a transparência nas interações. A implementação de pontuação de confiança pode aumentar a aceitação e o uso de agentes em processos de negócios. Com um guia prático, as empresas podem rapidamente integrar essa funcionalidade.

