O que pode fazer com ele

Monitorize a sua frota pelo chat

Pergunte a Claude quais os dispositivos que estão offline, qual foi a última leitura de um sensor ou como se comportou uma variável na última semana — sem ter de abrir um dashboard.

Controle os dispositivos sem usar as mãos

Permita que um agente de IA crie dispositivos, atualize tipos de dispositivos ou reorganize grupos de dispositivos à medida que descreve a alteração em linguagem simples.

Aja imediatamente em relação aos incidentes

Abra,edge, comente ou atribua incidentes através de comandos em linguagem natural — sem ter de interagir com a interface Ubidots .

Guia de início rápido

Obtenha o seu token API

Obtenha o seu token no seu perfil Ubidots . É ele que autentica o seu cliente de IA — não é necessário criar uma conta separada nem registar-se.

Adicione o servidor Ubidots MCP

Cole o endpoint (https://mcp.ubidots.com/mcpubidotscliente) e o seu token na configuração do seu cliente de IA. Consulte a secção Configuração abaixo para obter os passos exatos para cada

Comece a perguntar

Faça perguntas sobre os seus dispositivos, variáveis ​​ou incidentes em linguagem simples. A sua IA liga diretamente para Ubidots e responde — sem necessidade de dashboard .

Exemplos de perguntas

Tente perguntar

Uma vez ligado, basta perguntar em linguagem natural. A sua IA decide quais as ferramentas Ubidots a utilizar e responde com os seus dados reais.

Dados de leitura

“Quais os dispositivos que estão offline?”

“Mostrar os últimos valores de temperatura para o dispositivo aws810.”

Qual foi a temperatura média da máquina ABC ontem?

“Liste as organizações e mostre a quantidade de dispositivos para cada uma.”

Criação e atualização de dados

“Criar um novo dispositivo chamado bomba-04 na organização da Central Norte.”

“Atualize a descrição do dispositivo aws810 para ‘Compressor da asa norte’.”

“Criar um incidente P2 para o dispositivo aws810 sobre uma falha do sensor.”

Configuração

01
Área de trabalho Claude
{
  "mcpServers": {
    "ubidots": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ubidots.com/mcpubidots",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": Bearer 
      }
    }
  }
}

Edite o ficheiro claude_desktop_config.json, cole o seguinte conteúdo, substitua o token pelo seu e reinicie o Claude Desktop.

02
API antrópica
curl https://api.anthropic.com/v1/messages\
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Quais dos meus dispositivos estão offline?"}
    ],
    "mcp_servers": [{
      "type": "url",
      "name": "ubidots",
      "url": "https://mcp.ubidots.com/mcpubidots,
      "authorization_token": "UBIDOTS_TOKEN"
    }],
    "tools": [
      {"type": "mcp_toolset", "mcp_server_name": "ubidots"}
    ]
  }'

Chame este comando a partir da sua própria aplicação (um bot do Slack ou WhatsApp, ou um chat dentro da sua aplicação Ubidots ) para fornecer as suas ferramentas Ubidots ao Claude. Substitua a chave API da Anthropic pelo seu token Ubidots .

03
Outros clientes compatíveis com MCP (Cursor, ChatGPT, etc.)

Qualquer cliente compatível com MCP pode ligar-se diretamente a https://mcp.ubidots.com/mcpubidotsAPI como token de portador no Autorização .

Ferramentas disponíveis

Cada categoria pode ser definida como de leitura ou isolada apenas para essa entidade — ver Autenticação abaixo.

Ler

Somente pesquisa dados

Escrever

Cria ou altera registos (desativado nos endpoints /apenas leitura)

Dispositivos

Lista de dispositivos

Ler

Valores mais recentes

Ler

Criar

Escrever

Atualização

Escrever

Variáveis

Listar variáveis

Ler

Lista por dispositivo

Ler

Estatísticas

Ler

Séries temporais

Ler

Criar

Escrever

Atualização

Escrever

Estatísticas: primeiro, último, mínimo, máximo, contagem, soma, média, desvio padrão e os percentis 25, 50 e 75.

Grupos de dispositivos

Lista

Ler

Criar

Escrever

Atualização

Escrever

Tipos de dispositivos

Lista

Ler

Criar

Escrever

Atualização

Escrever

Organizações

Lista

Ler

Criar

Escrever

Atualização

Escrever

Eventos

Lista de eventos

Ler

logs eventos

Ler

Ainda não existem ferramentas de escrita para eventos.

Incidentes

Listar incidentes

Ler

logs de incidentes

Ler

Criar

Escrever

edge

Escrever

Comentar

Escrever

Atribuir

Escrever

Autenticação

O servidor Ubidots MCP autentica-se com o seu token de API Ubidots existente — sem necessidade de uma conta separada ou de uma configuração de fluxo OAuth.

Passe-o como um token de portador no de Autorização (Authorization: Bearer). ) — o mesmo token que já utiliza para a Ubidots API REST

Necessita de um acesso mais restrito? Dirija o seu cliente de IA para um endpoint com um âmbito definido — consulte a tabela abaixo — para o restringir a leitura apenas ou a um único tipo de entidade — útil para conceder a um assistente o acesso mínimo necessário.

Âmbito
Ponto final

Acesso total (leitura e escrita)

ubidots

Acesso total, leitura apenas

ubidots

Apenas dispositivos

ubidots

Dispositivos, leitura apenas

ubidots

Apenas variáveis

ubidots

Variáveis, leitura apenas

ubidots

Apenas grupos de dispositivos

ubidots

Grupos de dispositivos, leitura apenas

ubidots

Apenas tipos de dispositivo

ubidots

Tipos de dispositivos, leitura apenas

ubidots

Apenas para organizações

ubidots

Organizações, leitura apenas

ubidots

Apenas eventos (ainda sem ferramentas de gravação)

ubidots

Eventos, leitura apenas

ubidots

Apenas incidentes

ubidots

Incidentes, leitura apenas

ubidots

Perguntas frequentes

Estou a receber um erro 401/Não autorizado — o que está errado?

Verifique se o seu token API é válido e está corretamente formatado como Bearer. No cabeçalho de Autorização, a ausência do prefixo "Bearer" ou de um token expirado são as causas mais comuns.

O meu cliente de IA não consegue aceder ao servidor

Confirme mcp.ubidots.comubidots. a sua rede permite HTTPS de saída para e se o endpoint está https://mcp.ubidots.com/mcpubidotsdigitado exatamente

Faltam algumas ferramentas

Verifique se está a utilizar o endpoint completo, e não um endpoint de leitura apenas com âmbito ou específico para uma entidade — os endpoints com âmbito expõem intencionalmente menos ferramentas.

Vejo ferramentas duplicadas

Remova quaisquer entradas de servidor duplicadas no ficheiro de configuração MCP do seu cliente de IA — cada servidor deve ser listado apenas uma vez.

Com que clientes de IA funciona?

O Claude Desktop (macOS, Windows, Linux) e a API Anthropic já estão disponíveis; qualquer cliente compatível com MCP também pode ligar-se diretamente utilizando o mesmo endpoint e token.

Posso limitar o que a IA pode ver ou alterar?

Sim — utilize um endpoint com âmbito (apenas de leitura ou limitado a um tipo de entidade) em vez do https://mcp.ubidots.com/mcpubidots.

Comece agora

Ligue a sua IA ao Ubidots

Aponte o Claude ou qualquer cliente compatível com MCP para o servidor MCP Ubidots e autentique-se com o seu token API Ubidots . Está alojado pela Ubidots, por isso não há nada para instalar.