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:

PlanoRequisições/minuto
Professional30
Enterprise120

Próximos Passos