Pular para o conteúdo principal
O servidor iZap Analytics MCP expõe ferramentas de analytics e gerenciamento de assistentes via Streamable HTTP em {origin}/mcp. Conecte o Claude, o ChatGPT ou seu próprio agente e chame as ferramentas diretamente — com a mesma lógica de negócio e autenticação da API REST.
AmbienteURL do MCP
Produçãohttps://api.izap.ai/mcp
Staginghttps://api-staging.izap.ai/mcp

​
Conectar

A autenticação é OAuth 2.0 (clientes interativos a inicializam automaticamente) ou um Bearer JWT para código servidor-a-servidor. Registre-o como um servidor MCP HTTP remoto: 
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}

​
Catálogo de ferramentas

Todas as ferramentas aceitam um business_id (UUID) opcional; omita-o para usar sua primeira empresa.
FerramentaFinalidade
list_connected_assistantsLista os assistentes de IA da conta
get_today_message_statsContagens de chats / mensagens / pessoas únicas para uma data
get_today_assistant_ratioProporção de mensagens IA-vs-humano para uma data
get_conversation_durationDuração média/mínima/máxima de conversa para uma data
search_today_messagesBusca por palavra-chave nas mensagens de uma data
get_assistant_instructionsLê o prompt e as instruções de um assistente
create_ai_assistantCria um novo assistente
update_ai_assistant_instructionsAtualiza o prompt/instruções de um assistente

​
Notas

  • Datas são strings ISO-8601 (ex.: 2026-04-15); fuso horário é um nome IANA (ex.: America/Sao_Paulo).
  • search_today_messages tem limite de taxa por usuário, por dia.
  • Erros de servidor aparecem como erros de ferramenta MCP (isError: true) com a mensagem Error <status>: <detail>; um 401 significa que o token deve ser renovado.

Construa com o MCP no seu código

Obtenha um token e use o SDK MCP em Python ou TypeScript para chamar essas ferramentas a partir da sua própria aplicação ou agente.