name	nekt-connection-test
description	Testa a conexão do MCP da Nekt e retorna apenas Conexão OK ou Conexão falhou, com sugestão de correção se houver erro.
version	1.2.0

Nekt Connection Test

Teste rápido de conectividade com o MCP da Nekt.

Uso

Quando o usuário pedir para testar a conexão Nekt, execute:

Testar conexão — usar a chamada mais simples para validar endpoint + autenticação:
```
mcp_nekt_list_layers()
```
Esse tool é o ideal porque testa o endpoint HTTP, o bearer token e a capacidade de acessar dados — tudo numa chamada só.
Se funcionar — responder exclusivamente:
```
✅ Conexão OK
```
NUNCA inclua layers, databases, tabelas, schemas ou qualquer dado retornado pelo tool. O tool retorna dados, você os descarta completamente. O usuário só quer saber se a conexão funciona.

Se falhar — responder no formato:

❌ Conexão falhou
Sugestão: <diagnóstico + ação>

Regras de resposta

Sucesso = só "✅ Conexão OK". Nada mais. Zero detalhes. Mesmo que o tool retorne layers, databases, nomes — ignore tudo.
Falha = "❌ Conexão falhou" + sugestão. Uma frase de diagnóstico + ação prática.
O objetivo da skill é um health check binário. Não é exploração de schema, não é diagnóstico aprofundado.
Em caso de falha, dar uma sugestão curta e prática baseada no erro.

Diagnóstico por tipo de erro

Use o erro retornado pelo tool mcp_nekt_list_layers() para gerar a sugestão:

Timeout / sem resposta → NEKT_MCP_URL pode estar errado ou o MCP Server está offline. Ação: confira se a URL foi copiada exatamente da página do MCP Server na Nekt (Settings → MCP Server). Teste com curl <NEKT_MCP_URL> no terminal.
401 / 403 / Unauthorized / Forbidden → Token inválido, expirado ou header mal formatado. Ação: verifique se NEKT_MCP_TOKEN é o token atual (gere um novo em Settings → MCP Server se necessário). Confirme que o config.yaml do profile tem Authorization: Bearer ${NEKT_MCP_TOKEN} exatamente nesse formato — sem aspas extras, sem espaços antes do Bearer.
Connection refused / DNS / host unreachable → O endpoint do MCP Server não está acessível da sua rede. Ação: verifique se a URL está correta e se o MCP Server está habilitado (Settings → MCP Server → Enable). Se estiver correto, pode ser firewall/VPN — teste com curl -v.
Erro interno / 500 → Problema no lado do servidor Nekt. Ação: aguardar e tentar novamente. Se persistir, contatar suporte Nekt.
Qualquer outro erro → Ação: revisar o config.yaml do profile conforme o formato abaixo. Comparar com a doc oficial: https://docs.nekt.com/build-with-ai.md

Formato de configuração esperado (Hermes profile config.yaml)

{
  "mcpServers": {
    "Nekt": {
      "type": "http",
      "url": "<MCP_ENDPOINT>",
      "headers": {
        "Authorization": "Bearer <MCP_TOKEN>"
      }
    }
  }
}

Profiles

Disponível em todos os profiles que têm o MCP Nekt configurado (default e analista).

Variáveis de ambiente necessárias

NEKT_MCP_URL — endpoint HTTP do MCP Nekt
NEKT_MCP_TOKEN — bearer token do MCP Nekt

Nekt Connection Test

Teste rápido de conectividade com o MCP da Nekt.

Uso

Quando o usuário pedir para testar a conexão Nekt, execute:

Testar conexão — usar a chamada mais simples para validar endpoint + autenticação:

mcp_nekt_list_layers()

Esse tool é o ideal porque testa o endpoint HTTP, o bearer token e a capacidade de acessar dados — tudo numa chamada só.

Se funcionar — responder exclusivamente:

✅ Conexão OK

NUNCA inclua layers, databases, tabelas, schemas ou qualquer dado retornado pelo tool. O tool retorna dados, você os descarta completamente. O usuário só quer saber se a conexão funciona.

Se falhar — responder no formato:

❌ Conexão falhou
Sugestão: <diagnóstico + ação>

Regras de resposta

Sucesso = só "✅ Conexão OK". Nada mais. Zero detalhes. Mesmo que o tool retorne layers, databases, nomes — ignore tudo.

Falha = "❌ Conexão falhou" + sugestão. Uma frase de diagnóstico + ação prática.

O objetivo da skill é um health check binário. Não é exploração de schema, não é diagnóstico aprofundado.

Em caso de falha, dar uma sugestão curta e prática baseada no erro.

Diagnóstico por tipo de erro

Use o erro retornado pelo tool mcp_nekt_list_layers() para gerar a sugestão:

Timeout / sem resposta → NEKT_MCP_URL pode estar errado ou o MCP Server está offline. Ação: confira se a URL foi copiada exatamente da página do MCP Server na Nekt (Settings → MCP Server). Teste com curl <NEKT_MCP_URL> no terminal.

401 / 403 / Unauthorized / Forbidden → Token inválido, expirado ou header mal formatado. Ação: verifique se NEKT_MCP_TOKEN é o token atual (gere um novo em Settings → MCP Server se necessário). Confirme que o config.yaml do profile tem Authorization: Bearer ${NEKT_MCP_TOKEN} exatamente nesse formato — sem aspas extras, sem espaços antes do Bearer.

Connection refused / DNS / host unreachable → O endpoint do MCP Server não está acessível da sua rede. Ação: verifique se a URL está correta e se o MCP Server está habilitado (Settings → MCP Server → Enable). Se estiver correto, pode ser firewall/VPN — teste com curl -v.

Erro interno / 500 → Problema no lado do servidor Nekt. Ação: aguardar e tentar novamente. Se persistir, contatar suporte Nekt.

Qualquer outro erro → Ação: revisar o config.yaml do profile conforme o formato abaixo. Comparar com a doc oficial: https://docs.nekt.com/build-with-ai.md

Formato de configuração esperado (Hermes profile config.yaml)

{ "mcpServers": { "Nekt": { "type": "http", "url": "<MCP_ENDPOINT>", "headers": { "Authorization": "Bearer <MCP_TOKEN>" } } } }

Profiles

Disponível em todos os profiles que têm o MCP Nekt configurado (default e analista).

Variáveis de ambiente necessárias

NEKT_MCP_URL — endpoint HTTP do MCP Nekt

NEKT_MCP_TOKEN — bearer token do MCP Nekt

nekt-connection-test