@tunnelhub/mcp 1.0.0 → 1.0.2

package/README.md

@@ -20,22 +20,6 @@ Este MCP é especialmente útil para:
 - Consultar logs e traces de uma execução
 - Ler informações básicas da empresa atual
 
-## 🚀 Comece em 2 minutos
-
-A forma principal de uso é via `npx`:
-
-```bash
-npx @tunnelhub/mcp
-```
-
-Se você estiver desenvolvendo localmente:
-
-```bash
-pnpm install
-pnpm build
-node dist/index.js
-```
-
 ## ✅ Pré-requisitos
 
 Você vai precisar de:
@@ -51,19 +35,30 @@ Clientes recomendados:
 - Cursor
 - Outros clientes MCP compatíveis com `stdio`
 
-## ⚙️ Variáveis de ambiente
+## 🚀 Comece em 2 minutos
 
-Variáveis suportadas:
+A forma principal de uso é via `npx` com o bin explícito:
 
-- `OAUTH_CALLBACK_PORT` padrão `3333`
-- `TUNNELHUB_FRONTEND_URL` opcional
-- `TUNNELHUB_API_HOST` opcional; padrão `https://api.tunnelhub.io`
+```bash
+npx -y @tunnelhub/mcp@latest
+```
 
-Observações:
+Se você estiver desenvolvendo localmente:
 
-- O login usa o fluxo do frontend do TunnelHub
-- Quando possível, o MCP reutiliza o domínio personalizado da empresa
-- A porta do callback OAuth prefere `3333` e procura outra livre se necessário
+```bash
+pnpm install
+pnpm build
+node dist/index.js
+```
+
+Se esta for sua primeira vez usando o MCP do TunnelHub, siga este fluxo:
+
+1. Faça login no TunnelHub
+2. Qual sessão está ativa?
+3. Liste os ambientes disponíveis
+4. Liste as automações ativas
+
+Você não precisa decorar o nome das tools. Pode pedir em linguagem natural, e o cliente MCP deve escolher a ferramenta certa.
 
 ## 🔌 Configuração oficial por cliente
 
@@ -72,7 +67,7 @@ Observações:
 Depois da publicação, a forma recomendada será:
 
 ```bash
-opencode mcp add tunnelhub -- npx @tunnelhub/mcp
+opencode mcp add tunnelhub -- npx -y @tunnelhub/mcp@latest
 ```
 
 Para desenvolvimento local:
@@ -98,7 +93,8 @@ Exemplo completo:
       "type": "local",
       "command": [
         "npx",
-        "@tunnelhub/mcp"
+        "-y",
+        "@tunnelhub/mcp@latest"
       ],
       "enabled": true,
       "environment": {
@@ -138,7 +134,7 @@ Exemplo de configuração no `claude_desktop_config.json`:
   "mcpServers": {
     "tunnelhub": {
       "command": "npx",
-      "args": ["@tunnelhub/mcp"],
+      "args": ["-y", "@tunnelhub/mcp@latest"],
       "env": {
         "OAUTH_CALLBACK_PORT": "3333"
       }
@@ -172,7 +168,7 @@ Use o mesmo comando `stdio` do cliente MCP:
   "mcpServers": {
     "tunnelhub": {
       "command": "npx",
-      "args": ["@tunnelhub/mcp"],
+      "args": ["-y", "@tunnelhub/mcp@latest"],
       "env": {
         "OAUTH_CALLBACK_PORT": "3333"
       }
@@ -202,7 +198,7 @@ Exemplo usando build local:
 Se o cliente aceitar um comando local, use:
 
 ```bash
-npx @tunnelhub/mcp
+npx -y @tunnelhub/mcp@latest
 ```
 
 Ou, em desenvolvimento:
@@ -236,6 +232,7 @@ Ferramentas básicas de sessão:
 
 Você pode pedir coisas como:
 
+- `Faça login no TunnelHub`
 - `Qual sessão está ativa?`
 - `Liste os ambientes disponíveis`
 - `Liste as automações ativas`
@@ -280,6 +277,20 @@ Você pode pedir coisas como:
 - `get_execution_traces_tunnelhub`
 - `get_execution_logs_tunnelhub`
 
+## ⚙️ Variáveis de ambiente
+
+Variáveis suportadas:
+
+- `OAUTH_CALLBACK_PORT` padrão `3333`
+- `TUNNELHUB_FRONTEND_URL` opcional
+- `TUNNELHUB_API_HOST` opcional; padrão `https://api.tunnelhub.io`
+
+Observações:
+
+- O login usa o fluxo do frontend do TunnelHub
+- Quando possível, o MCP reutiliza o domínio personalizado da empresa
+- A porta do callback OAuth prefere `3333` e procura outra livre se necessário
+
 ## 🧭 Dicas de uso
 
 - Ao procurar uma execução, informe sempre a data ou um intervalo de tempo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tunnelhub/mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for TunnelHub automations and monitoring",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,6 +12,7 @@
     }
   },
   "bin": {
+    "mcp": "dist/index.js",
     "tunnelhub-mcp": "dist/index.js"
   },
   "type": "module",