@justmpm/task-request 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # @justmpm/task-request
 
-MCP App com UI interativa para criar tasks estruturadas. O host chama a tool, o formulario abre dentro do chat, o usuario preenche, e a resposta volta como markdown estruturado para a conversa.
+MCP App com UI interativa para criar tasks estruturadas. Agora o pacote suporta dois modos: `stdio` para Codex local e `http` para hosts MCP por URL.
 
 ## O que é
 
@@ -20,6 +20,28 @@ Este é um **MCP App** - uma extensão do Model Context Protocol que inclui uma
 - **Validação em tempo real**
 - **Geração automática de prompt estruturado**
 
+## Modos de uso
+
+### 1. `stdio` para Codex
+
+Use quando quiser que o Codex suba o MCP automaticamente como processo local.
+
+Comando instalado:
+
+```bash
+task-request-mcp
+```
+
+### 2. `http` para hosts por URL
+
+Use quando quiser conectar via endpoint HTTP em hosts como `basic-host` ou connectors remotos.
+
+Comando instalado:
+
+```bash
+task-request-mcp-http
+```
+
 ## Como funciona
 
 Esse pacote tem 3 partes:
@@ -45,7 +67,7 @@ npm install
 # Gere UI + servidor
 npm run build
 
-# Rode o endpoint MCP
+# Rode o endpoint HTTP do MCP
 npm run start
 ```
 
@@ -68,8 +90,11 @@ npm publish --access public
 # Instalar globalmente no seu PC
 npm install -g @justmpm/task-request
 
-# Rodar o MCP publicado
+# Rodar no modo stdio (ideal para Codex)
 task-request-mcp
+
+# Rodar no modo HTTP
+task-request-mcp-http
 ```
 
 ## Testar no host
@@ -97,19 +122,34 @@ npx cloudflared tunnel --url http://localhost:3001
 
 ## Uso
 
-1. Cadastre o endpoint MCP no host:
+1. Rode o modo HTTP:
+   `task-request-mcp-http`
+
+2. Cadastre o endpoint MCP no host:
    `http://localhost:3001/mcp`
 
-2. No host, peça algo como:
+3. No host, peça algo como:
    ```
    "Crie uma task para adicionar login com Google"
    ```
 
-3. O host chama a tool `create_task` e o formulario aparece dentro do chat.
+4. O host chama a tool `create_task` e o formulario aparece dentro do chat.
 
-4. Preencha e clique em `Enviar task`.
+5. Preencha e clique em `Enviar task`.
+
+6. A tool `submit_task` devolve a resposta estruturada automaticamente para a conversa.
+
+## Uso no Codex
+
+Depois de instalar globalmente, configure em `C:\Users\tetu_\.codex\config.toml`:
+
+```toml
+[mcp_servers.task_request]
+command = "task-request-mcp"
+enabled = true
+```
 
-5. A tool `submit_task` devolve a resposta estruturada automaticamente para a conversa.
+Depois reabra o Codex. Nesse modo, ele sobe o MCP localmente sem precisar manter `localhost:3001` aberto manualmente.
 
 ## Configuração opcional
 
@@ -176,12 +216,10 @@ Já existe o hook useAuth() com signOut()
 
 Se o seu objetivo e usar isso como builder de pedido:
 
-1. Publique no npm
-2. Instale globalmente com `npm install -g @justmpm/task-request`
-3. Rode `task-request-mcp`
-4. Cadastre `http://localhost:3001/mcp` no host
-5. Quando eu precisar estruturar uma task, eu chamo `create_task`
-6. Voce preenche o formulario e eu recebo o resultado ja pronto na conversa
+1. No Codex, use `task-request-mcp` via `command`
+2. Em hosts por URL, use `task-request-mcp-http`
+3. Quando eu precisar estruturar uma task, eu chamo `create_task`
+4. Voce preenche o formulario e eu recebo o resultado ja pronto na conversa
 
 ## Estrutura
 

package/dist/mcp-app.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const PACKAGE_VERSION: string;
+export declare function createTaskRequestServer(): McpServer;
+//# sourceMappingURL=mcp-app.d.ts.map

package/dist/mcp-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app.d.ts","sourceRoot":"","sources":["../src/mcp-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoCpE,eAAO,MAAM,eAAe,QAAsB,CAAC;AAoFnD,wBAAgB,uBAAuB,IAAI,SAAS,CAoFnD"}