01Conectar
Cadastre um servidor MCP remoto no cliente e informe o endereço canônico https://app.evobits.com.br/mcp. Configure o cabeçalho HTTP Authorization com o valor Bearer evk_sua_chave. O nome do servidor e o formato do arquivo de configuração dependem do cliente.
{
"url": "https://app.evobits.com.br/mcp",
"headers": {
"Authorization": "Bearer evk_sua_chave"
}
}O exemplo mostra os dois valores necessários. Configure-os na área de servidores remotos do seu cliente e mantenha a chave em um armazenamento seguro, sem incluí-la em arquivos compartilhados ou no controle de versão.
Crie a chave em Configuração > Integrações > API. A documentação de criação, rotação e escopos está na referência da API pública.
02Chave e permissões
A chave MCP usa a mesma autenticação, escopos, recorte por grupo, validade e limite por minuto da API pública. Conceda somente os escopos que as ferramentas necessárias usam. Um alvo fora do recorte da chave aparece como inexistente.
| Escopo | Acesso | Ferramentas |
|---|---|---|
| dispositivos.ler | Consulta | listar_grupos, listar_dispositivos, obter_dispositivo |
| sensores.ler | Consulta | listar_sensores, obter_sensor, consultar_estado |
| medidas.ler | Consulta | consultar_medidas |
| eventos.ler | Consulta | listar_eventos, obter_evento |
| alertas.ler | Consulta | listar_alertas, obter_alerta |
| manutencoes.ler | Consulta | listar_manutencoes |
| relatorios.ler | Consulta | consultar_disponibilidade |
| metricas.ler | Consulta | consultar_metricas |
| dispositivos.criar | Inclusão | criar_grupo, criar_dispositivo, criar_sensor |
| manutencoes.escrever | Inclusão | criar_manutencao |
Inclusões respeitam o acesso de escrita do grupo indicado. Para uma chave com recorte, informe um destino gravável. Grupos raiz podem ser criados sem pai por uma chave sem recorte.
03Ferramentas disponíveis
O servidor anuncia exatamente estas ferramentas:
| Ferramenta | Ação | Parâmetros principais |
|---|---|---|
| listar_grupos | Consulta | limite, cursor |
| listar_dispositivos | Consulta | grupo, limite, cursor |
| obter_dispositivo | Consulta | id |
| listar_sensores | Consulta | dispositivo, tipo, estado, limite, cursor |
| obter_sensor | Consulta | id |
| consultar_estado | Consulta | Sem parâmetros |
| consultar_medidas | Consulta | id, de, ate, agregacao, limite, cursor |
| listar_eventos | Consulta | Período, dispositivo, estado, situação e paginação |
| obter_evento | Consulta | id |
| listar_alertas | Consulta | Estado, período, dispositivo, severidade e paginação |
| obter_alerta | Consulta | id |
| listar_manutencoes | Consulta | Tipo e id do escopo, vigência e paginação |
| consultar_disponibilidade | Consulta | Escopo, id e período |
| consultar_metricas | Consulta | Sem parâmetros |
| criar_manutencao | Inclusão | Escopo, id, início, fim e motivo opcional |
| criar_grupo | Inclusão | Nome, pai opcional e ordem opcional |
| criar_dispositivo | Inclusão | Nome e campos opcionais de endereço, grupo, tipo e coleta |
| criar_sensor | Inclusão | Dispositivo, tipo, configuração e campos opcionais do sensor |
A configuração de cada sensor depende do tipo. Consulte a lista de tipos de sensor antes de usar criar_sensor. Para sensores heartbeat, a criação retorna uma URL e um token que aparecem uma única vez. Guarde ambos no momento da resposta: consultas posteriores não os exibem novamente.
As ferramentas MCP fazem consultas e inclusões. Não há ferramentas para excluir ou editar recursos, reconhecer alertas ou alterar manutenções já criadas.
04Limites e paginação
- O limite de requisições por minuto é o da chave e do plano da empresa. Cada ferramenta que consulta a API consome uma requisição.
- Listas aceitam limite de 1 a 200, com padrão 50. As medidas aceitam até 1000 pontos por página.
- Para continuar uma lista, passe o valor proximo como cursor. O cursor é opaco, não o altere.
- O corpo de uma requisição MCP pode ter até 64 KiB. O conteúdo de uma resposta tem teto de 256 KiB. Reduza o período ou use paginação se a resposta ultrapassar o teto.
- Datas e identificadores seguem os formatos da API pública. A chave mantém seus próprios escopos, recorte por grupo e validade.
Consulte a referência da API para detalhes dos parâmetros, respostas, erros e limites do plano.
05Clientes e autorização
O endpoint usa Streamable HTTP e negocia versões do protocolo MCP usadas por clientes publicados em 2025 e 2026. O cliente precisa aceitar um servidor HTTP remoto e permitir configurar o cabeçalho Bearer.
A conexão é configurada manualmente com uma chave da API. O endpoint não oferece descoberta OAuth nem autorização automática. Se o cliente exigir OAuth para adicionar servidores remotos, ele não poderá concluir a conexão com este endpoint.