Descripción General

El Model Context Protocol (MCP) permite que las aplicaciones de IA se conecten de forma segura a APIs externas. En proyectos IoT, esto significa que tu aplicación de IA puede decidir automáticamente si necesita llamar a la API de Ubidots para responder a una solicitud del usuario.

Ejemplos:

“¿Qué dispositivos están desconectados?”
“Muestra los últimos valores de temperature para el dispositivo aws810.”
"¿Cuál fue la temperatura promedio de ayer del Machine ABC?"

En este artículo exploramos el uso del MCP de Ubidots desde:

Claude Desktop
API de Anthropic

Uso del servidor MCP de Ubidots desde Claude Desktop

Requisitos Previos

Una cuenta de Ubidots y un token de API de Ubidots (con alcance para la organización que quieras usar).
Claude Desktop instalado (macOS/Windows/Linux).

Paso a Paso

Abre la Configuración de Claude Desktop
Inicia Claude Desktop → Configuración → Desarrollador.
Edita la Configuración
Haz clic en Edit config para abrir claude_desktop_config.json.

Agrega la entrada del servidor MCP de Ubidots
Pega el siguiente fragmento en el JSON (combínalo con tu configuración existente de mcpServers si ya existe).
Reemplaza <YOUR UBIDOTS TOKEN> con tu token real.

{
    "mcpServers": 
        { 
            "ubidots": 
                { 
                    "command": "npx", 
                    "args": [ "mcp-remote", "https://mcp.ubidots.com/mcp", "--header", "x-auth-token: <YOUR UBIDOTS TOKEN>" 
                    ] 
                }
        } 
}

Notas

Si mcpServers ya existe, agrega solo el bloque "ubidots" dentro de él.
Asegúrate de mantener la sintaxis JSON válida (comas, llaves).

Guarda y Recarga Claude
Guarda el archivo y reinicia Claude Desktop (o usa “Reload” si está disponible).
Verifica la conexión

En un nuevo chat de Claude, asegúrate de que MCP esté habilitado y prueba esto:
- “¿Qué dispositivos están en línea?”
Si se configuró correctamente, Claude confirmará que la herramienta MCP está disponible y devolverá datos en vivo desde Ubidots.

Solución de Problemas

Claude no muestra la herramienta de Ubidots

Reinicia Claude después de editar la configuración.
Verifica la validez del JSON (usa un validador JSON en línea si es necesario).
Asegúrate de que npx esté disponible en la variable PATH del sistema.

401 / No Autorizado

Verifica que el encabezado sea exactamente: x-auth-token: <YOUR UBIDOTS TOKEN>.
Comprueba que el token no haya expirado o sido revocado.

Errores de Red

Confirma que tienes conexión a internet y que no estás detrás de un proxy/firewall que bloquee HTTPS saliente.
Inténtalo más tarde en caso de problemas de red temporales.

Varios servidores MCP configurados

Asegúrate de que no existan claves duplicadas llamadas ubidots.
Si renombraste el servidor, recuerda que el nombre que verás dentro de Claude coincidirá con esa clave.

Actualizar o Eliminar la Integración

Actualizar token: Abre claude_desktop_config.json, reemplaza el token en el encabezado, guarda y recarga Claude.
Deshabilitar: Elimina o comenta el bloque "ubidots" dentro de mcpServers, guarda y recarga Claude.

Uso del servidor MCP de Ubidots con la API de Anthropic

Aunque Claude Desktop es ideal para pruebas, no representa escenarios reales, donde los usuarios querrán interactuar con un agente de IA mediante Slack, Whatsapp o un chat web integrado en tu aplicación basada en Ubidots.

En tales casos, usar una API de IA como OpenAI API o la API de Anthropic te permitirá agregar la capa de inteligencia necesaria a tu caso de uso.

Aquí tienes un ejemplo de solicitud que podrías usar desde una aplicación de este tipo para interactuar con las consultas del usuario y con el MCP de Ubidots:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-04-04" \
  -d '{
    "model": "claude-3-5-sonnet-20240620",
    "max_tokens": 500,
    "system": "Eres un asistente inteligente de IoT. Si necesitas datos de dispositivos, usa el MCP adjunto.",
    "messages": [
      {"role": "user", "content": "Lista mis dispositivos"}
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "ubidots",
        "url": "https://mcp.ubidots.com/mcp",
        "authorization_token": "YOUR_UBIDOTS_TOKEN"
        }
      }
    ]
  }'

Para obtener más información sobre el conector MCP de Anthropic, visita su documentación oficial.

Preguntas Frecuentes

¿Funciona con otros clientes MCP?
Sí. Cualquier cliente compatible con MCP puede conectarse a https://mcp.ubidots.com/mcp usando el mismo encabezado x-auth-token.

¿El servidor es local?
No. El Servidor MCP de Ubidots está alojado en la nube; lo que te evita ejecutarlo localmente y permite aplicaciones como bots de IA en Whatsapp.

¿Puedo usar múltiples cuentas de Ubidots?
Sí—crea entradas separadas (por ejemplo, ubidots-prod, ubidots-staging) con diferentes tokens.

Ejemplos de Prompts para Empezar

“Lista las organizaciones y muestra el conteo de dispositivos de cada una.”
“Para el dispositivo aws810, lista las variables y muestra las últimas marcas de tiempo y valores.”

Si tienes problemas o solicitudes de funciones para el Servidor MCP de Ubidots, cuéntanos qué cliente estás usando, tu sistema operativo y una copia editada de tu configuración mcpServers para poder ayudarte más rápido.