O MCP (Model Context Protocol) é uma norma aberta que permite aos assistentes de IA ligarem-se a fontes de dados externas.
Com o servidor Ubidots MCP, o Claude ou o Cursor podem aceder às ferramentas Ubidots como se fossem utilizadores avançados.
Pergunte à sua IA quais os dispositivos que estão offline, para obter dados de séries temporais de uma variável ou para abrir um incidente — ela consulta Ubidots diretamente e responde, sem necessidade de dashboard .
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.
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.
Abra,edge, comente ou atribua incidentes através de comandos em linguagem natural — sem ter de interagir com a interface Ubidots .
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.
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
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 .
{
"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.
"authorization_token": "UBIDOTS"Qualquer cliente compatível com MCP pode ligar-se diretamente a https://mcp.ubidots.com/mcpubidotso utilizando o seu token API como token de portador no cabeçalho de Autorização. O artigo original não fornece passos específicos do cliente para além dos dois anteriores — é necessário feedback do produto/suporte antes de publicar um conjunto completo de guias.)
Cada categoria pode ser definida como de leitura ou isolada apenas para essa entidade — ver Autenticação abaixo.
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.
API completa, leitura apenas
ubidots
Apenas dispositivos
ubidots
Dispositivos, leitura apenas
ubidots
(O mesmo padrão aplica-se a variáveis, grupos de dispositivos, tipos de dispositivos, organizações, eventos e incidentes)
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.
Confirme mcp.ubidots.comubidots. a sua rede permite HTTPS de saída para e se o endpoint está https://mcp.ubidots.com/mcpubidotsdigitado exatamente
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.
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.
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.
Sim — utilize um endpoint com âmbito (apenas de leitura ou limitado a um tipo de entidade) em vez do https://mcp.ubidots.com/mcpubidots.
