orquestra-mcp 1.0.0 → 1.0.2

package/README.md

@@ -143,8 +143,8 @@ Compuestas:
 
 Los campos enum (`type`, `priority`, `status`, etc.) están fijos y
 documentados en el `inputSchema` de cada tool — el modelo los ve sin
-adivinar. Todo lo que se crea/edita aparece en vivo en `orquestra-web`
-(misma colección de Firestore, mismo `onSnapshot`).
+adivinar. Todo lo que se crea/edita aparece en vivo en `orquestra-web`,
+sin necesidad de refrescar.
 
 `projectId` es opcional en todas las tools de proyecto si hay un
 `defaultProjectId` configurado (por `setup` o por

package/bin/orquestra-mcp.mjs

@@ -3,8 +3,30 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { createServer } from '../src/server.mjs'
 import { runSetup } from '../src/setup.mjs'
 
+const HELP_TEXT = `orquestra-mcp -- Servidor MCP de Orquestra (35 tools)
+
+Uso:
+  npx orquestra-mcp            Inicia el servidor MCP por stdio -- lo usa tu cliente
+                                MCP (Claude Code, Claude Desktop, etc.), no se corre a mano
+  npx orquestra-mcp setup      Login por navegador + configura tu proyecto default
+  npx orquestra-mcp --help     Muestra esta ayuda
+
+Config (la deja lista "setup"): ~/.orquestra/mcp-config.json
+Alternativa manual (variables de entorno): ORQUESTRA_API_TOKEN, ORQUESTRA_WORKSPACE_ID,
+ORQUESTRA_DEFAULT_PROJECT_ID
+
+Docs completas: https://orquestra.me/mcp
+`
+
 async function main() {
-  if (process.argv[2] === 'setup') {
+  const cmd = process.argv[2]
+
+  if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
+    console.log(HELP_TEXT)
+    return
+  }
+
+  if (cmd === 'setup') {
     await runSetup()
     return
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Servidor MCP de Orquestra -- 35 tools para leer y escribir tareas, ideas, changelog, infraestructura y más desde un agente de IA",
   "type": "module",
   "bin": {
@@ -16,7 +16,13 @@
     "node": ">=18"
   },
   "homepage": "https://orquestra.me/mcp",
-  "keywords": ["mcp", "model-context-protocol", "orquestra", "claude", "ai-agent"],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "orquestra",
+    "claude",
+    "ai-agent"
+  ],
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",

package/src/api.mjs

@@ -1,6 +1,6 @@
 import { readConfigFile, CONFIG_PATH } from './configFile.mjs'
 
-const DEFAULT_API_BASE = 'https://if9c2vlf35.execute-api.us-east-1.amazonaws.com'
+const DEFAULT_API_BASE = 'https://api.orquestra.me'
 
 export function loadConfig() {
   const fileConfig = readConfigFile()

package/src/setup.mjs

@@ -4,7 +4,7 @@ import { exec } from 'child_process'
 import { createInterface } from 'readline'
 import { writeConfigFile, CONFIG_PATH } from './configFile.mjs'
 
-const DEFAULT_API_BASE = 'https://if9c2vlf35.execute-api.us-east-1.amazonaws.com'
+const DEFAULT_API_BASE = 'https://api.orquestra.me'
 const DEFAULT_WEB_URL = 'https://app.orquestra.me'
 const CALLBACK_TIMEOUT_MS = 5 * 60 * 1000
 

package/src/stages.mjs

@@ -1,5 +1,5 @@
 // Puerto exacto de orquestra-web/src/lib/stages.js (STAGES + PLAYBOOKS) --
-// constantes estaticas, sin acceso a red ni Firestore. get_stage_playbook y
+// constantes estaticas, sin acceso a red ni a la base de datos. get_stage_playbook y
 // apply_stage_playbook las leen directo desde aca.
 export const STAGES = [
   {