API MCP
Integre o AccountWatch com instâncias externas do Claude via Model Context Protocol.
O AccountWatch expõe um conjunto de ferramentas via Model Context Protocol (MCP), permitindo que você consulte dados de saúde de clientes diretamente do Claude ou de outros assistentes de IA compatíveis com MCP.
O Que é MCP?
O Model Context Protocol é um padrão aberto que permite que assistentes de IA acessem fontes de dados e ferramentas externas. O AccountWatch implementa endpoints de servidor MCP que o Claude pode chamar para recuperar informações de saúde de clientes, gerar resumos e mais.
Ferramentas Disponíveis
get_clients
Retorna uma lista de todos os clientes rastreados com suas pontuações de saúde atuais.
Parâmetros: Nenhum
Retorna: Array de objetos de cliente com name, healthScore, status, lastActivity
get_client_health
Retorna informações detalhadas de saúde para um cliente específico.
Parâmetros:
client_name(string) — O nome do cliente a ser consultado
Retorna: Pontuação de saúde, dados de tendência, análise recente e membros da equipe atribuídos
get_health_summary
Retorna um resumo de saúde de todo o portfólio.
Parâmetros: Nenhum
Retorna: Pontuação média, contagem de clientes em risco, contagens de tendência positiva/negativa e comentário gerado por IA
get_upsell_opportunities
Retorna as oportunidades de upsell detectadas atualmente.
Parâmetros: Nenhum
Retorna: Array de oportunidades com nome do cliente, descrição do sinal e status
Configuração
Pré-requisitos
- Plano Professional ou superior do AccountWatch
- Um cliente compatível com MCP (Claude Desktop, Cursor, etc.)
Configuração
Adicione o AccountWatch como servidor MCP na configuração do seu cliente:
{
"mcpServers": {
"accountwatch": {
"url": "https://your-backend-url/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Substitua YOUR_API_TOKEN pelo seu token de API do AccountWatch (disponível em Configurações > API).
Exemplo de Uso
Uma vez conectado, você pode fazer perguntas ao Claude como:
- "Qual é o status de saúde de todos os meus clientes?"
- "Quais clientes estão em risco esta semana?"
- "Resuma as oportunidades de upsell em todo o meu portfólio"
- "Como a Acme Corp está em comparação com o mês passado?"
O Claude chamará as ferramentas MCP apropriadas do AccountWatch para recuperar dados reais para suas respostas.
Limites de Requisições
As chamadas à API MCP são limitadas com base no seu plano:
| Plano | Requisições/minuto |
|---|---|
| Professional | 30 |
| Enterprise | 120 |
Próximos Passos
- Entenda as pontuações de saúde que a API retorna
- Gerencie seu faturamento para garantir o acesso à API