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.
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 y transiciones de estatus validadas.
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.
Necesitas una cuenta de Orquestra y Node 18+. El resto lo hace npx orquestra-mcp@latest setup.