Blynk MCP

Para o índice completo da documentação, consulte llms.txt. Versões em Markdown das páginas de documentação estão disponíveis adicionando .md às URLs das páginas; esta página está disponível como Markdown.

MCP Server

A Blynk fornece um servidor hospedado do Model Context Protocol (MCP), projetado para permitir que clientes interajam com seu hardware por meio de interfaces de IA. Esta implementação agiliza o desenvolvimento e permite que agentes de IA gerenciem sua frota, possibilitando tarefas como verificar o status do dispositivo, metadados e valores de datastream por meio de linguagem natural ou fluxos de trabalho automatizados.

Endpoint: https://blynk.cloud/mcp

Autenticação

O servidor Blynk MCP implementa a especificação OAuth 2.0 em total conformidade com o padrão MCP. Todas as solicitações exigem um token de acesso válido. Para facilitar a integração perfeita entre diferentes plataformas e serviços de IA, o servidor também suporta o Registro Dinâmico de Clientes.

Ferramentas

O servidor MCP da Blynk fornece um conjunto de ferramentas que permitem que agentes de IA executem tarefas administrativas e operacionais diretamente dentro da sua organização.

{% hint style="warning" %} Cada ferramenta requer permissões específicas associadas ao papel do usuário (por exemplo, View Devices, Edit Templates).

Para ferramentas que modificam a estrutura do seu projeto (como criar templates ou datastreams), o Modo Desenvolvedor deve estar habilitado no seu Perfil de Usuário. {% endhint %}

Pesquisar Dispositivos

search_devices

Encontra e lista dispositivos, opcionalmente filtrados por nome, template ou status atual do dispositivo.
Exemplo de solicitação de IA: "Encontre todos os dispositivos que tenham 'Pump' no nome."

Obter um Dispositivo

get_device

Obtém informações detalhadas sobre o dispositivo, incluindo seus valores de datastream e metadados.
Exemplo de solicitação de IA: "Qual é o valor atual de temperatura no dispositivo 'Temperature Sensor'?"

Criar um Dispositivo

create_device

Cria um novo dispositivo sob um template e gera um Auth Token.
Exemplo de solicitação de IA: "Crie um novo dispositivo chamado 'Living Room Sensor' usando o template 'Room Sensor'."

Atualizar Valor de DataStream

update_datastream_value

Atualiza um valor de datastream no dispositivo.
Exemplo de solicitação de IA: "Ligue meu dispositivo aquecedor."

Obter Todos os Templates

get_all_templates

Recupera informações de todos os templates, incluindo nome, descrição e ID do template.
Exemplo de solicitação de IA: "Liste todos os meus templates disponíveis."

Obter Template

get_template

Recupera informações detalhadas de um template específico, incluindo suas configurações de datastream, eventos e ciclo de vida.
Exemplo de solicitação de IA: "Mostre as configurações de datastream do template 'Living Room Sensor'."

Criar um Template

create_template

Cria um novo template, especificando seu nome, descrição, tipo de conexão e outras informações.
Exemplo de solicitação de IA: "Configure um novo template para uma placa ESP32 conectada via Wi-Fi."

Criar um DataStream

create_datastream

Adiciona um novo canal de dados virtual (V1–V255) a um template específico.
Exemplo de solicitação de IA: "Adicione um novo datastream ao template TMPL123 para monitoramento de temperatura."

Editar um DataStream

edit_datastream

Atualiza a configuração de um canal de dados existente dentro de um template.
Exemplo de solicitação de IA: "Altere a unidade do datastream em V1 no template TMPL123 para Celsius."

Criar um Evento

create_event

Adiciona um novo evento a um template específico.
Exemplo de solicitação de IA: "Crie um evento 'Low Battery' para meu template de sensor."

Editar um Evento

edit_event

Modifica os parâmetros ou configurações de notificação de um evento existente.
Exemplo de solicitação de IA: "Atualize o evento 'Overheat' para ser uma notificação de alta prioridade."

Recursos

Além das ferramentas ativas, o servidor MCP expõe entidades de Dispositivo e Template como recursos persistentes.

Os recursos oferecem um método padronizado para a IA interpretar o estado do seu ecossistema Blynk, fornecendo aos modelos o contexto de longo prazo necessário para análise e solução de problemas precisas.

---

Instruções do Agente

Esta documentação é publicada com GitBook. GitBook é a plataforma de documentação projetada para que tanto humanos quanto agentes de IA possam ler, navegar e raciocinar sobre conteúdo técnico de forma eficaz. Saiba mais em gitbook.com.

Consultando Esta Documentação

Se você precisar de informações adicionais que não estão diretamente disponíveis nesta página, você pode consultar a documentação dinamicamente fazendo uma pergunta.

Execute uma solicitação HTTP GET na URL da página atual com o parâmetro de consulta ask e o parâmetro de consulta opcional goal:

GET https://docs.blynk.io/en/getting-started/mcp-server.md?ask=<question>&goal=<endgoal>

ask é a pergunta imediata: deve ser específica, autocontida e escrita em linguagem natural. goal é opcional e descreve o objetivo final mais amplo que você está tentando alcançar em nome do usuário. O GitBook o utiliza para adaptar a resposta ao que é mais útil para esse objetivo.

A resposta conterá uma resposta direta à pergunta e trechos e fontes relevantes da documentação.

Use este mecanismo quando a resposta não estiver explicitamente presente na página atual, você precisar de esclarecimentos ou contexto adicional, ou quiser recuperar seções relacionadas da documentação.