El Model Context Protocol conecta a Claude Code, Cursor, Codex, Gemini CLI o cualquier agente compatible directo con tu proyecto: Más de 140 herramientas para leer y escribir tareas, ideas, changelog, contenido, el plan por fases, agentes de QA/seguridad/performance e infraestructura.
orquestra-mcp · npm · MIT · Node 18+
$ npx orquestra-mcp@latest setup
→ abre el navegador, confirma tu sesión, listo.
# en Claude Code
$ claude mcp add orquestra -- npx -y orquestra-mcp@latest
> get_project_context()
3 tareas vencidas, 1 desfase de paridad, fase: beta…
Necesitas una cuenta de Orquestra y Node 18+ (incluye npx). Funciona en macOS, Linux y Windows.
Corre esto desde la carpeta de tu proyecto. Abre el navegador para confirmar tu sesión de app.orquestra.me. Si todavía no tienes workspace te pide su nombre; si tienes varios, te deja elegir en cuál trabajar; después eliges (o creas) el proyecto. La conexión queda guardada para esa carpeta.
$ npx orquestra-mcp@latest setup
Un solo comando registra el servidor MCP. Después reinicia Claude Code o reconéctalo con /mcp.
macOS / Linux
$ claude mcp add orquestra -- npx -y orquestra-mcp@latest
Windows (PowerShell)
> claude mcp add orquestra -- cmd /c npx -y orquestra-mcp@latest
¿PowerShell dice que "claude" no se reconoce? Falta instalar Claude Code: npm install -g @anthropic-ai/claude-code y vuelve a abrir la terminal.
Agrega esta entrada a claude_desktop_config.json y cierra la app por completo antes de volver a abrirla.
macOS: ~/Library/Application Support/Claude/ · Windows: %APPDATA%\Claude\
{
"mcpServers": {
"orquestra": {
"command": "npx",
"args": ["-y", "orquestra-mcp@latest"]
}
}
}Con @latest cada arranque usa la última versión publicada. Para ver cuál es, o para conectar otra carpeta o cambiar de proyecto, vuelve a correr el setup ahí:
$ npm view orquestra-mcp version # última versión publicada $ npx orquestra-mcp@latest setup # conectar otra carpeta / cambiar de proyecto
¿Lo agregaste sin @latest? Quítalo y vuelve a agregarlo con el comando del paso 2 (claude mcp remove orquestra primero). El servidor que ya está corriendo conserva su versión hasta que reconectas.
Mismo servidor, mismo comando (npx -y orquestra-mcp@latest) — solo cambia dónde lo declaras. En Windows, si el agente no encuentra npx, usa "command": "cmd" con ["/c", "npx", "-y", "orquestra-mcp@latest"].
~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto)
{
"mcpServers": {
"orquestra": {
"command": "npx",
"args": ["-y", "orquestra-mcp@latest"]
}
}
}~/.codex/config.toml
[mcp_servers.orquestra] command = "npx" args = ["-y", "orquestra-mcp@latest"]
~/.gemini/settings.json (global) o .gemini/settings.json (por proyecto)
{
"mcpServers": {
"orquestra": {
"command": "npx",
"args": ["-y", "orquestra-mcp@latest"]
}
}
}El servidor manda sus propias instrucciones al conectarse — parte estándar del protocolo MCP. Claude Code, Claude Desktop, Cursor y Gemini CLI las aplican solos, sin que copies nada a un CLAUDE.md o AGENTS.md.
Al iniciar, tu agente llama a get_project_context solo — sabe en qué fase va el proyecto, qué hay abierto y qué se hizo recientemente, sin que se lo resumas tú.
Si no hay módulos ni tareas todavía, lo detecta y te ofrece un playbook por etapa o iniciar el proyecto desde cero, en vez de improvisar.
Cuando le pides una funcionalidad o un arreglo, revisa si ya existe la tarea, la crea si falta, y al terminar la mueve de estatus y registra el changelog — solo.
No te pide workspaceId ni projectId — quedaron configurados en el setup. Solo pregunta si de verdad hay ambigüedad.
No necesitas memorizarlas — el agente las descubre solo al conectarse. Esta es la referencia por grupos, con las más representativas.
Traen el estado real del proyecto sin copiar y pegar nada a mano.
get_project_contextFase, plataformas, tareas abiertas/vencidas/bloqueadas, módulos, ideas y changelog reciente.
get_dashboard_summaryTareas de hoy, riesgos, salud de módulos y actividad reciente.
get_parity_summaryDesfases multiplataforma: qué avanza en una distribución y falta en otra.
get_infra_statusServicios, entornos y distribuciones con su estado operativo.
get_pagespeed / measure_pagespeedPageSpeed Insights de cada sitio web: scores, Core Web Vitals reales y su historial semanal.
get_sync_reportRevisión de sincronización: qué hay en el proyecto que no cuadra con la realidad.
get_taskUna tarea completa con checklist y verificaciones, por folio (ORQ-123) o por código de módulo o grupo (AUTH-3, V2-3), sin traer el listado.
list_tasksCon summary, fields, limit y cursor para proyectos grandes: solo ids, títulos y estatus, y páginas en vez de cientos de tareas de golpe.
searchBusca por texto en tareas, notas, ideas y docs.
list_*Tareas, módulos, estatus, ideas, notas, docs, contenido, campañas, canales, servicios, entornos, distribuciones, changelog, agentes de QA…
Escritura real sobre el proyecto — el agente deja rastro de quién, cuándo y por qué.
create_task / update_taskTareas con módulo, fecha de inicio y de término, scope por plataforma, clave de grupo (groupKey) y transiciones de estatus validadas. Al pasar a En progreso, la tarea muestra qué agente la trabaja; al cerrar, devuelve relatedImpact: propuestas que tú revisas, nunca aplicadas solas.
update_tasks / add_verificationsLotes: varias tareas o verificaciones en una sola llamada. Con compact responden solo lo esencial, y con opId un reintento no duplica nada.
add_checklist_item / update_checklist_itemChecklist por tarea: marca hecho o descarta como «No aplica» con motivo (sin borrar ni dar por hecho lo que no se hizo), y convierte un ítem en tarea completa.
create_changelog_entryChangelog estilo Keep a Changelog, por distribución y versión.
release_changelog_versionCorta una versión de las entradas Unreleased.
create_note / create_docNotas y documentación del proyecto, también desde plantilla.
get_doc / update_docLee un documento completo y lo edita; la versión anterior queda en el historial.
create_module / update_moduleMódulos con salud, dependencias y scope multiplataforma.
create_service / create_environment / create_distributionToda la infraestructura, editable.
create_risk / update_riskRiesgos del proyecto: probabilidad, impacto, dueño y mitigación.
log_activity / update_activityAgenda: reuniones, llamadas y seguimientos, con los puntos a revisar agrupados por tema, resultado y siguiente paso al registrarlas.
El plan del proyecto por etapas, y quién hace qué.
list_phases / create_phase / update_phaseFases con fechas calculadas desde el arranque del proyecto, hitos y criterios de aceptación; mover una fecha exige un motivo y conserva la anterior.
delete_phaseBorra una fase creada por error (una fase terminada se marca como hecha, no se borra).
list_membersMiembros del workspace con su permiso y su rol funcional: gestor, product owner, desarrollo o revisión.
Lo que sirve para varios proyectos, y cómo se conecta con el resto.
list_knowledge / get_knowledge / create_knowledge / update_knowledgeBase de conocimiento del workspace: entradas que no pertenecen a un solo proyecto.
link_knowledge_to_project / promote_to_knowledgeVincula o copia una entrada a un proyecto, o promueve una nota o doc a la base.
get_backlinksQué notas, docs, tareas e ideas mencionan a otra con [[wikilinks]].
link_items / list_relationsVínculos manuales entre tareas, reuniones, notas, docs, ideas, riesgos y más.
list_templatesPlantillas base y propias para notas y documentos.
Lo que falta confirmar antes de cerrar, con pruebas a la vista.
add_verification / list_verifications / update_verificationUna confirmación por plataforma (web, iOS, Android, API) con instrucciones concretas; la tarea se cierra sola al aprobar la última.
verify_with_agentUn agente confirma una verificación que admite revisión por IA.
add_attachmentEvidencia —imagen, video o código— ligada a una tarea, nota, idea, doc o pieza de contenido.
Para compartir el avance y no perder el hilo.
create_client_portal_linkLink del portal de tu cliente, sin cuenta: avance, fases que decidas mostrar, documentos públicos y contenido por aprobar. Uno nuevo reemplaza al anterior.
log_time / list_time_entriesHoras trabajadas por tarea, base de los reportes de horas.
set_task_reminderRecordatorio con hora sobre una tarea.
get_standupQué movió cada persona en un periodo.
Captura, conversa y convierte — incluidas las sugerencias que la IA genera tras cada commit.
create_idea / update_ideaIdeas con prioridad, fecha y tareas ligadas.
convert_idea_to_taskDe idea a tarea con un solo paso.
add_idea_commentComentarios en la conversación de una idea.
list_suggestionsSugerencias de IA pendientes (tareas, changelog, paridad).
accept_suggestion / dismiss_suggestionAceptar o descartar sugerencias desde el agente.
La agenda editorial completa, también automatizable.
create_content / update_contentPublicaciones con plataforma, formato y fecha programada.
create_campaign / update_campaignCampañas con presupuesto y periodo.
create_channel / list_channelsCanales de distribución del contenido.
connect_postproxy_channel / publish_content_postproxyConecta y publica de verdad en Facebook, Instagram o TikTok.
list_distributionsDistribuciones del proyecto para planear por plataforma.
Corridas reales en tus runners — la única forma válida de dar algo por verificado.
create_agent_runDispara una corrida (qa: lint/tests/build/E2E; security: npm audit + gitleaks; performance: build size + Lighthouse en las 4 categorías y Core Web Vitals) en una rama.
get_agent_runEstatus real: queued, running, passed, failed, error, cancelled.
create_agent / update_agent / list_agentsAgentes por stack, kind y proyecto, con URLs y umbrales de performance.
Varias llamadas en una sola acción de alto nivel.
init_projectProyecto nuevo con categorías, distribuciones y flujo de estatus conectado.
apply_stage_playbookMódulo + tareas de plantilla para una etapa completa.
merge_task / unmerge_taskFusiona duplicados sin perder historial.
Un comando sincroniza una carpeta de tu vault con la base de conocimiento de tu workspace, en los dos sentidos. Obsidian sigue siendo donde escribes; Orquestra es el respaldo, la búsqueda y el contexto que usa tu asistente.
Córrelo desde una carpeta ya conectada con setup: de ahí salen tu cuenta y tu workspace. No gasta créditos de IA.
La primera vez no escribe nada: lista qué notas e imágenes subiría y bajaría, y por qué. Para aplicarlo repite el comando con --apply; después sincroniza directo, y --dry-run vuelve a la vista previa.
Cada .md es una entrada de la base de conocimiento, así que los [[wikilinks]] funcionan igual en los dos lados. Se añade un bloque de propiedades con orquestraId y las etiquetas; tus otras propiedades se conservan.
Si una nota cambió en los dos lados gana la más reciente, y la otra versión se guarda junto al archivo como Nombre.conflict.md.
Una nota que borras del vault se vuelve a bajar. Una nota con orquestraId que ya no existe en Orquestra solo se reporta.
Los que incrustas con ![[foto.png]] o  se suben como adjuntos de la entrada y se bajan en otra máquina en la misma ruta, sin pisar archivos que ya tengas. Si una imagen cambia, se reemplaza su versión anterior en Orquestra.
$ npx orquestra-mcp@latest vault sync ./MiVault
Vault: /Users/tu/MiVault
Orquestra: 12 entradas · Vault: 14 notas · Primera sincronización
Modo: VISTA PREVIA -- no se escribe nada todavía
NOTAS -- 4 cambios
↓ Bajar de Orquestra al vault (1)
• Guía de despliegue -- nueva en Orquestra
↑ Crear en Orquestra (notas nuevas del vault) (3)
IMÁGENES Y VIDEOS -- cambios
↑ Subir a Orquestra (2, 1.4 MB)
• Attachments/flujo.png (900 KB, en "Onboarding")
Siguiente paso: revisa la lista y aplica con
orquestra-mcp vault sync ./MiVault --apply
--applyEscribe los cambios (obligatorio la primera vez).--dry-runSolo muestra el plan, aunque ya hayas sincronizado antes.--no-attachmentsSincroniza solo el texto de las notas.--verboseLista también lo que ya está al día.--helpMuestra la ayuda del comando.Límites de hoy: imágenes png, jpg, gif y webp de hasta 15 MB; videos mp4, mov y webm de hasta 500 MB. Otros archivos (pdf, audio…) se avisan y no se sincronizan. Los archivos quedan respaldados y vuelven a tu vault, pero la web todavía no los muestra dentro de la entrada.
Una extensión de solo lectura que consume la misma API que el servidor MCP. Toma la tarea actual del folio en el nombre de la rama (feat/orq-123-algo da ORQ-123), o la última En progreso, y muestra su estatus, checklist y verificaciones, un dashboard del proyecto y qué agente trabaja en cada tarea. El login se hace en el navegador con Orquestra: Conectar; no necesita el MCP instalado, aunque si ya corriste setup en la carpeta, reutiliza esa conexión.
Versión inicial, aún fuera del Marketplace: se instala desde el archivo con code --install-extension orquestra-vscode-latest.vsix o desde Extensiones, «Instalar desde VSIX…».
Descargar la extensión (.vsix)Necesitas una cuenta de Orquestra y Node 18+. El resto lo hace npx orquestra-mcp@latest setup.