orquestra-mcp 1.0.3 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "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": {

package/src/server.mjs

@@ -38,9 +38,31 @@ const SETUP_GUIDE = {
   ],
 }
 
+// Instrucciones a nivel de servidor (campo "instructions" del protocolo MCP)
+// -- la mayoría de los clientes (Claude Code/Desktop, Cursor, Gemini CLI...)
+// las inyectan solas como contexto del modelo al conectarse, sin que el
+// usuario tenga que escribir nada en su CLAUDE.md/AGENTS.md. Acá vive el
+// "modo automático": cuándo respaldar trabajo como tarea/changelog sin que
+// se lo pidan, cómo llenar un proyecto vacío la primera vez, y cuándo sí
+// preguntar en vez de adivinar.
+const SERVER_INSTRUCTIONS = `Este server conecta con Orquestra, la app de gestión de proyectos del usuario -- úsalo para mantener su proyecto sincronizado con el trabajo real, sin que tenga que pedírtelo cada vez.
+
+Al empezar una sesión de trabajo en este proyecto, llama una vez a get_project_context para saber en qué fase está, qué tareas hay abiertas/vencidas/bloqueadas y qué se hizo recientemente. Úsalo como contexto de fondo, no lo repitas en cada mensaje.
+
+Si get_project_context devuelve un proyecto vacío (sin módulos ni tareas), es la primera vez que se usa este MCP aquí -- antes de crear nada a mano, llama a get_setup_guide y ofrece al usuario aplicar un playbook de etapa (get_stage_playbook + apply_stage_playbook) o iniciar un proyecto nuevo (init_project).
+
+Durante el trabajo normal de código, sin que el usuario te lo pida explícitamente:
+- Si te pide una funcionalidad o arreglo real (no una pregunta rápida ni exploración de código sin cambios), revisa con list_tasks/search si ya existe una tarea relacionada; si no, créala con create_task antes de empezar a trabajar.
+- Al terminar, mueve la tarea de estatus con update_task y registra una entrada de changelog con create_changelog_entry -- así el usuario nunca tiene que documentar esto a mano.
+- Antes de crear un módulo/estatus/categoría/servicio/entorno/distribución, revisa con el list_* correspondiente que no exista ya uno con ese nombre.
+
+No le preguntes al usuario por workspaceId ni projectId -- ya están configurados. Solo pregúntale por el proyecto si tiene más de uno y no queda claro a cuál te refieres.
+
+No crees tareas ni entradas de changelog por preguntas triviales o exploración sin cambios reales -- solo por trabajo que de verdad avanza el proyecto.`
+
 export function createServer() {
   const config = loadConfig()
-  const server = new McpServer({ name: 'orquestra-mcp', version: '1.0.0' })
+  const server = new McpServer({ name: 'orquestra-mcp', version: '1.0.0' }, { instructions: SERVER_INSTRUCTIONS })
 
   function resolveProjectId(projectId) {
     if (config.defaultProjectId) return config.defaultProjectId

package/src/setup.mjs

@@ -116,5 +116,12 @@ export async function runSetup() {
 
   writeConfigFile({ apiBase, apiToken: token, workspaceId, defaultProjectId })
   console.log(`\nListo. Configuración guardada en ${CONFIG_PATH}.`)
-  console.log('Ya puedes correr "npx orquestra-mcp" (o configurarlo en tu cliente MCP) sin pasar variables de entorno.')
+  console.log('\nSiguiente paso -- conéctalo a tu agente de IA:\n')
+  console.log('  Claude Code:')
+  console.log('    claude mcp add orquestra -- npx orquestra-mcp\n')
+  console.log('  Claude Desktop -- agrega esto a tu claude_desktop_config.json:')
+  console.log('    { "mcpServers": { "orquestra": { "command": "npx", "args": ["orquestra-mcp"] } } }\n')
+  console.log('  ¿Usas Cursor, ChatGPT/Codex o Gemini CLI? La config de cada uno está en:')
+  console.log('    https://orquestra.me/mcp#instalacion\n')
+  console.log('Docs completas y las 35 tools disponibles: https://orquestra.me/mcp')
 }