@myhero/mcp-server

Servidor MCP para HERO: permite que herramientas de IA como Claude Desktop, Cursor, Claude Code y cualquier cliente MCP stdio lean y escriban tus documentos, proyectos y tablas de HERO.

Inicio rápido

Añádelo a la configuración MCP de tu herramienta de IA:

{
  "mcpServers": {
    "hero": {
      "command": "npx",
      "args": ["-y", "@myhero/mcp-server"],
      "env": {
        "HERO_API_KEY": "hero_at_your_token_here"
      }
    }
  }
}

Genera el token en app.myhero.so → Settings → MCP Tokens.

Para obtener una configuración paso a paso con Claude Desktop, Cursor, Claude Code y otros, consulta la guía completa en myhero.so/mcp-setup.

Qué hace

Documentos

• Leer cualquier documento: contenido completo, texto sin formato, metadatos o solo los títulos de las secciones

• Buscar en todos tus espacios de trabajo y proyectos

• Crear nuevos documentos, renombrarlos, moverlos, duplicarlos o eliminarlos

• Tomar instantáneas, listar cada bloque en un documento, saltar a una sección por su numeración

• Ediciones quirúrgicas: cambia un solo párrafo, encabezado, elemento de lista o tabla sin reescribir el resto con el esquema de bloques completo de HERO.

Cláusulas y estructura legal

• Leer, listar y editar cláusulas, subcláusulas y definiciones dentro de contratos y acuerdos

• Encontrar cada documento que haga referencia a una cláusula o término definido determinado

• Extraer la explicación de una definición directamente del documento al que pertenece

Proyectos, carpetas y espacios de trabajo

• Listar tus espacios de trabajo, proyectos, carpetas y los documentos dentro de ellos

• Crear proyectos, renombrarlos, organizar documentos en carpetas

• Mover o copiar documentos entre proyectos de forma masiva

Tablas

• Crear tablas, añadir o eliminar columnas y filas, establecer valores dinámicos.

• Leer tablas completas, buscar filas, columnas o celdas específicas por nombre

• Actualizar celdas una por una o por lotes

• Hacer referencia a filas desde dentro de los documentos para que el documento se mantenga sincronizado con la tabla

Plantillas y marcadores de posición

• Crear plantillas de documentos reutilizables con marcadores de posición dinámicos que se extraen de tus tablas

• Cuando los datos de la tabla subyacente cambian, cada documento que hace referencia a ella se actualiza automáticamente

Autenticación

Dos formas de autenticarse:

1. Token de acceso personal (variable de entorno HERO_API_KEY): recomendado para configuraciones sin interfaz (headless).

2. Inicio de sesión OAuth: omite la variable de entorno y el puente abrirá tu navegador en el primer uso. Los tokens se guardan en ~/.hero/credentials.json.

Gestiona y revoca tokens o sesiones en app.myhero.so → Settings → MCP Tokens.

Variables de entorno

Fuente

El código fuente se encuentra en github.com/Unwynd-io/hero-mcp. Se aceptan problemas y solicitudes de extracción (pull requests).