TagoIO

Interaja com sua conta TagoIO para acessar dispositivos, dados e recursos da plataforma para desenvolvimento e análise inteligente de dados.

GitHub

Experimente este MCPPatrocinado

Documentação

TagoIO

TagoIO | Servidor MCP

Trabalhe na sua conta TagoIO apenas perguntando. Seu assistente de IA lê seus dispositivos, dados, dashboards e análises, e faz as alterações que você solicitar, a partir da sua IDE ou ferramenta de chat.

Comece aqui

Obtenha um token. Gere um Token de Perfil em Configurações de Perfil do TagoIO.
Adicione o servidor ao seu cliente. Use um botão de instalação acima, ou copie a configuração para sua ferramenta em Configuração do cliente.
Pergunte algo. Tente: "Liste meus dispositivos e me diga quais pararam de enviar dados esta semana."

Seu cliente se conecta ao servidor hospedado do TagoIO em https://mcp.ai.tago.io. Você também pode executar o servidor você mesmo.

O que você pode pedir

O servidor oferece ao seu assistente cerca de 80 capacidades focadas em toda a sua conta. Você descreve o resultado, e ele escolhe as ferramentas. Algumas coisas que funcionam bem hoje:

Entenda sua frota

"Quais dispositivos não enviaram dados nos últimos 7 dias?"
"Mostre-me os últimos 50 registros do Hidrômetro 12 e resuma a variável de fluxo."
"Crie um dispositivo na minha rede LoRaWAN e depois me dê o token dele."

Depure sem trocar de aba

"A análise do Relatório Diário falhou ontem à noite. Leia o console e me diga por quê."
"Corrija o bug que você encontrou, envie o script e execute-o uma vez para confirmar."
"Um cliente diz que o dashboard está vazio. Faça login como esse usuário e verifique o que ele vê."

Crie dashboards a partir de uma descrição

"Crie um dashboard para minha frota de cadeia fria: um mapa das unidades, um gráfico de linhas de temperatura das últimas 24 horas e um cartão para o nível da bateria."
"Este medidor não mostra valor. Compare a configuração dele com as variáveis que o dispositivo realmente envia."

Desembarace permissões

"Minha análise recebe um erro de permissão ao gravar na entidade Sites. Qual política ela precisa?"
"Mostre-me todas as políticas de acesso que envolvem usuários do TagoRUN."

Mantenha a conta organizada

"Quão perto estou do meu limite de registros de dados este mês?"
"Encontre arquivos armazenados com mais de um ano e maiores que 5 MB e depois exclua-os."

Escreva código com a documentação no contexto

"Encontre o exemplo oficial para analisar o payload de um Dragino LHT65 e adapte-o ao meu dispositivo."

O servidor lê e escreve. Excluir dados, rotacionar credenciais e enviar scripts passam pelo fluxo de confirmação do seu assistente, então você aprova cada alteração antes que ela seja aplicada.

Configuração do cliente

Cada configuração abaixo aponta para o servidor hospedado. Substitua YOUR-TAGOIO-TOKEN pelo seu Token de Perfil.

Cliente	Onde a configuração fica
VS Code / GitHub Copilot	`.vscode/mcp.json` ou Configurações do Usuário
Claude Code	`claude mcp add-json` CLI
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
Cursor	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
JetBrains IDEs	Configurações > Ferramentas > Assistente de IA > MCP
Google Gemini CLI	`~/.gemini/settings.json`
Amazon Q CLI	`~/.aws/amazonq/mcp.json`
Warp	`~/.warp/mcp.json`
Kiro	`.kiro/mcp.json`
OpenAI Agents / ChatGPT	Interface do Agent Builder

VS Code / GitHub Copilot

Adicione a .vscode/mcp.json para um projeto, ou às Configurações do Usuário para todos eles. O VS Code Insiders usa a mesma configuração, e o Copilot lê o mesmo arquivo.

{
  "servers": {
    "@tago-io/mcp": {
      "type": "http",
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer ${input:tagoToken}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tagoToken",
      "description": "TagoIO Profile Token",
      "password": true
    }
  ]
}

Claude Code

claude mcp add-json tagoio '{"type":"http","url":"https://mcp.ai.tago.io","headers":{"Authorization":"Bearer YOUR-TAGOIO-TOKEN"}}'

Claude Desktop

Conecte-se através da ponte mcp-remote.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Cursor

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "@tago-io/mcp": {
      "serverUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

JetBrains IDEs

Abra Configurações > Ferramentas > Assistente de IA > Model Context Protocol (MCP), adicione um servidor e cole:

{
  "servers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
        }
      }
    }
  }
}

Google Gemini CLI

{
  "mcpServers": {
    "@tago-io/mcp": {
      "httpUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Amazon Q CLI

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Warp

Conecte-se através da ponte mcp-remote.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Kiro

Conecte-se através da ponte mcp-remote, em .kiro/mcp.json na raiz do seu projeto.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

OpenAI Agents / ChatGPT

Nas configurações do Agent Builder ou do ChatGPT MCP:

URL do servidor: https://mcp.ai.tago.io
Protocolo: Streamable HTTP
Autenticação: cabeçalho Authorization: Bearer YOUR-TAGOIO-TOKEN

Escolhendo um token

Token	Onde obtê-lo	O que ele alcança
Perfil	Configurações de Perfil	Todo o seu perfil. Comece aqui.
Análise	Análise > sua análise, configurada para executar "Externo"	Apenas o que essa análise pode alcançar. Adequado para ambientes compartilhados e de produção onde o acesso é controlado via IAM.
Dispositivo	O próprio dispositivo	Os dados desse dispositivo. Solicitações em nível de conta retornam um erro de permissão.

Regiões e endpoints

As solicitações vão para US East por padrão. Defina o cabeçalho x-tagoio-region para alcançar um endpoint diferente:

Valor	Destino
`us-e1`	US East (padrão)
`eu-w1`	EU West
`https://api.your-instance.io`	Sua instância dedicada do TagoDeploy

x-tagoio-region: eu-w1

Para TagoDeploy, passe o endpoint completo da API da sua instância via https://. Isso funciona no servidor hospedado, então uma instância dedicada precisa da mesma configuração de uma linha que uma região pública.

Via STDIO não há cabeçalhos. Defina TAGOIO_API para o seu endpoint em vez disso.

Execute localmente

Execute o servidor na sua própria máquina para trabalho offline, ou quando sua rede bloquear conexões de saída. Instale Node.js 22.12 ou mais recente, então:

npx -y @tago-io/mcp-server        # STDIO, what desktop apps and IDEs expect
npx -y @tago-io/mcp-server http   # HTTP on port 3000

STDIO lê o token do ambiente:

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": ["-y", "@tago-io/mcp-server"],
      "env": {
        "TAGOIO_TOKEN": "YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Para Claude Code:

claude mcp add @tago-io/mcp-server -e TAGOIO_TOKEN=YOUR-TAGOIO-TOKEN -- npx -y @tago-io/mcp-server

O modo HTTP recebe o token por solicitação, então várias pessoas podem compartilhar um servidor com suas próprias credenciais. Defina a porta com MCP_PORT e verifique GET /health para confirmar que o servidor está ativo. Para apontar qualquer configuração neste README para o seu servidor local, troque a URL por http://localhost:3000. Execute npx -y @tago-io/mcp-server --help para a lista completa de opções.

Escrevendo widgets personalizados

Widgets personalizados são componentes React com um contrato de autoria estrito: um wrapper de provedor, dependências fixadas npm:, um marcador // tailwind. O servidor valida seu código contra esse contrato e relata o que o viola.

A habilidade de widget personalizado ensina o contrato em si, com exemplos práticos. Instale-a para Claude Code:

# all projects
mkdir -p ~/.claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o ~/.claude/skills/custom-widget-development/SKILL.md

# one project
mkdir -p .claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o .claude/skills/custom-widget-development/SKILL.md

Para outros clientes, coloque o mesmo arquivo onde esse cliente carrega habilidades ou prompts reutilizáveis.

Seu token e seus dados

O servidor remove seu token de todo resultado, erro, download de script e saída de console antes que chegue ao seu assistente. Valores de variáveis de ambiente, tokens de análise gerados e URLs de arquivos assinados recebem o mesmo tratamento.

Algumas configurações permanecem no admin do TagoIO: configuração de ambiente do TagoRUN, SSO e domínios personalizados, e-mails de teste e criação de usuários anônimos.

Solução de problemas

Não conecta. Confirme se o token ainda é válido e se https://mcp.ai.tago.io está acessível a partir da sua rede. Se sua conta estiver em EU West, defina o cabeçalho x-tagoio-region.

Erro de autenticação. Via HTTP, o cabeçalho é Bearer YOUR-TOKEN, com o espaço. Via STDIO, o token vai em TAGOIO_TOKEN. Se o formato estiver correto, o token pode não ter permissão para o que você pediu.

Uma solicitação retorna vazia. Duas causas comuns: o dispositivo não tem dados no período que você perguntou, ou seu perfil não tem acesso a esse dispositivo.

A ponte falha (Claude Desktop, Warp, Kiro). Verifique se há Node.js 22.12 ou mais recente e execute a ponte manualmente para ler o erro real:

npx -y mcp-remote https://mcp.ai.tago.io --header "Authorization: Bearer YOUR-TOKEN"

Referência completa de ferramentas

Cada ferramenta que o servidor expõe, agrupada por domínio. Cada uma carrega seus próprios parâmetros, limites e anotação de leitura ou gravação na descrição que seu cliente lê.

Domínio	Ferramentas
Dispositivos	`search_devices`, `get_device`, `create_device`, `update_device`, `delete_device`, `configure_device`
Dados do dispositivo	`read_device_data`, `send_device_data`, `edit_device_data`, `delete_device_data`
Ações	`search_actions`, `get_action`, `create_action`, `update_action`, `delete_action`
Análises	`search_analyses`, `get_analysis`, `create_analysis`, `update_analysis`, `delete_analysis`, `upload_analysis_script`, `download_analysis_script`, `run_analysis`, `read_analysis_console`
Dashboards e widgets	`search_dashboards`, `get_dashboard`, `create_dashboard`, `update_dashboard`, `delete_dashboard`, `get_widget`, `create_widget`, `update_widget`, `delete_widget`, `widget_schema_lookup`, `validate_widget_configuration`, `get_custom_widget_code`, `upload_custom_widget_code`
Entidades	`search_entities`, `get_entity`, `create_entity`, `update_entity`, `delete_entity`, `update_entity_schema`
Dados da entidade	`read_entity_data`, `send_entity_data`, `edit_entity_data`, `delete_entity_data`, `empty_entity_data`
Usuários de execução	`search_run_users`, `get_run_user`, `create_run_user`, `update_run_user`, `delete_run_user`, `login_as_run_user`
Notificações de usuários de execução	`read_run_user_notifications`, `send_run_user_notification`, `update_run_user_notification`, `delete_run_user_notification`
Arquivos	`search_files`, `delete_files`
Gerenciamento de acesso	`search_access_policies`, `get_access_policy`, `lookup_access_permissions`, `create_analysis_access_policy`, `create_run_user_access_policy`, `update_analysis_access_policy`, `update_run_user_access_policy`, `delete_access_policy`
Perfil	`get_profile`, `get_profile_limits`, `get_profile_statistics`, `search_secrets`
Conectores e redes	`search_connectors`, `get_connector`, `search_networks`, `get_network`
Documentação e exemplos	`platform_overview`, `search_docs`, `read_doc`, `search_code_examples`, `get_code_example`

Contribuindo

Issues e pull requests são bem-vindos. As instruções do agente estão em AGENTS.md.

Licença

MIT. Consulte o arquivo LICENSE.

Construído pela equipe TagoIO. Precisa de ajuda? Consulte a documentação do TagoIO ou entre em contato com o suporte.