Servidor AMMP MCP
Última atualização · Ver como markdown
O AMMP MCP server permite que um assistente de IA leia seus dados da AMMP diretamente: detalhes de usinas e dispositivos, séries temporais de potência e energia, KPIs, status de alertas e dados brutos de dispositivos. Ele usa o Model Context Protocol (MCP), um padrão aberto compatível com Claude, Claude Code e um número crescente de outras ferramentas de IA.
Você pergunta em linguagem natural, por exemplo: "Quais locais tiveram o menor performance ratio no mês passado?", e o assistente escolhe as ferramentas certas do AMMP, executa as consultas e responde com seus dados.
Detalhes do servidor
| Configuração | Valor |
|---|---|
| URL do servidor | https://mcp.ammp.io/mcp |
| Transporte | HTTP com streaming sobre HTTPS |
| Autenticação | OAuth 2.1 com registro dinâmico de cliente e PKCE |
| Acesso | Somente leitura |
Login e permissões
Cada usuário faz login com sua própria conta da AMMP. O servidor encaminha esse login para os serviços de dados da AMMP, para que o assistente veja as mesmas organizações, locais e dispositivos que sua conta vê no AMMP OS, e nada mais.
Todas as ferramentas são somente leitura. O assistente não pode alterar configurações, alertas, tickets ou dados no AMMP OS.
As sessões são atualizadas automaticamente em segundo plano. Quando uma sessão expirar, sua ferramenta de IA solicitará que você faça login novamente.
Conecte o Claude (web, desktop e mobile)
- No Claude, abra Configurações → Conectores.
- Selecionar Adicionar conector personalizado.
- Insira um nome, como
AMMP, e a URL do servidorhttps://mcp.ammp.io/mcp. - Selecionar Conectar e faça login com sua conta AMMP.
- Em um chat, verifique se o conector do AMMP está ativado no menu de ferramentas.
Nos planos Claude Team e Enterprise, o proprietário pode precisar adicionar o conector para toda a organização primeiro. Os nomes dos menus podem variar ligeiramente entre as versões do Claude.
Conecte o Claude Code
Adicione o servidor a partir do seu terminal:
claude mcp add --transport http ammp https://mcp.ammp.io/mcp
Em seguida, execute /mcp dentro do Claude Code, selecione ammp e faça login com sua conta AMMP.
Outras ferramentas de IA
Qualquer cliente MCP compatível com servidores remotos via Streamable HTTP com OAuth pode se conectar. Adicione https://mcp.ammp.io/mcp como um servidor MCP remoto e faça login quando solicitado.
Importante
Algumas plataformas empresariais, como o Gemini Enterprise, precisam de um cliente OAuth pré-registrado em vez de registro dinâmico de clientes. Se a sua plataforma solicitar um client ID e secret, entre em contato com seu gerente de contas da AMMP.
O que você pode perguntar
- "Liste meus sites no Quênia com sua capacidade fotovoltaica."
- "Mostre a energia diária do Site X nos últimos 30 dias."
- "Quais sites têm alertas abertos neste momento?"
- "Detalhe as perdas de energia do Site X no mês passado em tempo de inatividade, clipping, sujidade e curtailment."
- "Exporte os dados de potência de 15 minutos de cada site do grupo Y para setembro como CSV."
Resultados grandes e exportações
Resultados pequenos são retornados diretamente na conversa. Tabelas maiores são armazenadas por um curto período e retornadas como um resumo com linhas de amostra. O assistente pode, então, transformar uma tabela armazenada em um link de download em CSV ou Parquet. Esses links são temporários, portanto salve o arquivo assim que estiver pronto.
Para todas as ferramentas e opções, consulte o Referência de ferramentas MCP.