Guías

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA llamar herramientas que expone un servidor. El servidor MCP de Inovacc es un programa, inovacc mcp serve, que se ejecuta en tu máquina con esta documentación incorporada, para que tu asistente pueda consultar los productos, endpoints y guías de Inovacc y responder citando sus fuentes.

Funciona con cualquier cliente compatible con MCP, entre ellos Cursor, Claude Code, VS Code (GitHub Copilot), Windsurf, Cline, Claude Desktop, los IDE de JetBrains, Codex CLI y Gemini CLI.

Para que tu agente haga toda la configuración por sí mismo, dale esta línea:

Fetch and execute the appropriate instructions to set me up for Inovacc from https://developer.inovacc.dev/agent-setup/prompt.md

Capacidades

Con el servidor conectado, tu asistente puede:

• buscar en la documentación: secciones de contrato, productos, guías e inicios rápidos
• explorar endpoints: la sección de contrato de cualquier método y ruta, como POST /v1/vector/query
• obtener el inicio rápido de un producto: URL base, encabezados y un esqueleto de curl
• decirte de qué versión de la documentación está respondiendo

No ejecuta solicitudes ni toca tu cuenta. El servidor es de solo lectura, no necesita clave de API y responde con la documentación incorporada en el programa.

Requisitos previos

• Windows en x86_64. macOS y Linux llegarán; todavía no hay fecha.
• Un cliente compatible con MCP de la lista de abajo.
• Los archivos de la versión del programa inovacc. El repositorio es privado hasta el lanzamiento: descarga la versión que te comparta tu contacto en Inovacc.

Instala la CLI de inovacc

1. Descarga inovacc-windows-x86_64.exe y inovacc-windows-x86_64.exe.sha256 de la versión.
2. Comprueba la descarga en PowerShell. Los dos valores deben ser idénticos:

(Get-FileHash .\inovacc-windows-x86_64.exe -Algorithm SHA256).Hash.ToLower()
Get-Content .\inovacc-windows-x86_64.exe.sha256

3. Cambia el nombre del archivo a inovacc.exe y colócalo en una carpeta de tu PATH.
4. Abre una terminal nueva y verifica:

inovacc docs version

La salida tiene esta forma; los números de versión cambian con cada versión:

embedded   2026.10.09-0
installed  none
active     embedded 2026.10.09-0
previous   none
published  unknown; run `inovacc docs update --check`
data dir   C:\Users\<you>\AppData\Local\Inovacc\knowledge

Conecta tu editor o tu aplicación de chat

Todos los clientes necesitan los mismos tres datos: el transporte es stdio, el comando es inovacc y los argumentos son mcp y serve. Reinicia el cliente después de cambiar su configuración.

Cursor

Crea .cursor/mcp.json en un proyecto, o ~/.cursor/mcp.json para todos los proyectos:

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Claude Code

1claude mcp add inovacc -- inovacc mcp serve

El -- separa las opciones propias de Claude del comando que ejecuta el servidor. Por defecto el servidor se agrega en el ámbito local: disponible solo para ti, en el proyecto actual. Elige otro ámbito con -s antes del nombre:

1
2claude mcp add -s project inovacc -- inovacc mcp serve
claude mcp add -s user inovacc -- inovacc mcp serve

project escribe .mcp.json en la raíz del proyecto, compartido con todas las personas que usan el repositorio. user deja el servidor disponible en todos tus proyectos.

VS Code (GitHub Copilot)

Crea .vscode/mcp.json en un espacio de trabajo, o ejecuta MCP: Open User Configuration para tu perfil de usuario:

1
2
3
4
5
6
7
8
9{
  "servers": {
    "inovacc": {
      "type": "stdio",
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Importante: .vscode/mcp.json usa servers, no mcpServers. La documentación de VS Code indica "type": "stdio" en sus ejemplos de stdio, así que esta página también lo hace. Un .mcp.json en la raíz de un proyecto usa mcpServers, como los demás clientes.

Windsurf

La documentación de Windsurf ahora está con Devin Desktop. Agrega el servidor a mcp_config.json, en %APPDATA%\devin\mcp_config.json en Windows:

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Cline

En el panel de Cline, haz clic en el icono de servidores MCP de la barra superior, abre la pestaña Configure y haz clic en Configure MCP Servers. Agrega el servidor al archivo de ajustes que se abre (cline_mcp_settings.json):

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Claude Desktop

Abre el menú de Claude, luego Settings, la pestaña Developer y Edit Config. El archivo es %APPDATA%\Claude\claude_desktop_config.json en Windows:

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Cierra Claude Desktop por completo y vuelve a abrirlo. Si la aplicación no encuentra inovacc, da la ruta completa de inovacc.exe como comando, con cada barra invertida duplicada en JSON.

IDE de JetBrains

Abre Settings | Tools | AI Assistant | Model Context Protocol (MCP), haz clic en Add, elige el tipo de conexión STDIO e ingresa:

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Haz clic en OK y luego en Apply.

Codex CLI

1codex mcp add inovacc -- inovacc mcp serve

o escríbelo en ~/.codex/config.toml (un proyecto de confianza puede usar .codex/config.toml):

[mcp_servers.inovacc]
command = "inovacc"
args = ["mcp", "serve"]

Importante: Codex usa TOML y mcp_servers, no JSON ni mcpServers.

Gemini CLI

1gemini mcp add inovacc inovacc mcp serve

o agrega el servidor a ~/.gemini/settings.json (un proyecto puede usar .gemini/settings.json):

1
2
3
4
5
6
7
8{
  "mcpServers": {
    "inovacc": {
      "command": "inovacc",
      "args": ["mcp", "serve"]
    }
  }
}

Cualquier otro cliente

Usa el transporte stdio con el comando inovacc y los argumentos mcp y serve. Consulta la documentación de MCP de tu cliente para saber dónde va.

Verifica tu configuración

Pregunta a tu asistente: "What does POST /v1/vector/query take?" Una configuración que funciona responde desde el contrato y nombra el documento del que salió y la versión del conocimiento.

Sin un asistente, busca desde la terminal:

1inovacc docs search "vector query"

Cada resultado muestra el id del documento, su título y su cita (repositorio, ruta y commit de origen).

Solución de problemas

• No se encuentra inovacc. La carpeta que contiene inovacc.exe no está en tu PATH, o la terminal se abrió antes de que lo cambiaras. Abre una terminal nueva. En la configuración del cliente puedes dar la ruta completa de inovacc.exe como comando.
• El cliente no lista el servidor. Reinicia el cliente por completo y luego comprueba que el comando de su configuración se ejecuta en una terminal: inovacc mcp serve debe quedar esperando en silencio una entrada (pulsa Ctrl+C para salir).
• Las respuestas parecen antiguas. Ejecuta inovacc docs version para ver qué se usa y qué está publicado, y luego inovacc docs update.
• Windows SmartScreen muestra una advertencia al primer uso. Hoy el programa no está firmado con un certificado de código, así que Windows puede mostrar "Windows protegió tu PC". Comprueba la suma de verificación como se describe arriba antes de decidir ejecutarlo.

Herramientas MCP disponibles

Mantén la documentación al día

El programa trae la documentación con la que se compiló y puede instalar documentación más nueva y firmada sin necesidad de un programa nuevo.

1
2
3
4inovacc docs version      # embedded, installed, active, previous and published versions
inovacc docs update       # download, verify and install the newest published documentation
inovacc docs update --check
inovacc docs rollback     # go back to the previous installed documentation

• La documentación se publica en paquetes firmados. Un paquete solo se instala si su tamaño, su SHA-256 y su firma Ed25519 son correctos, y se rechaza un paquete que no sea más nuevo que el que está en uso, de modo que no se pueda forzar una versión anterior.
• La comprobación automática se ejecuta como máximo una vez cada 24 horas, nunca retrasa una respuesta, no instala nada y, como mucho, imprime una línea que avisa de que existe una versión más nueva.
• Hasta el lanzamiento, las actualizaciones te llegan por la versión que te comparta tu contacto en Inovacc.

Referencia de configuración

Preguntas frecuentes

¿Necesito una clave de API? No. El servidor solo lee documentación y nunca usa tu cuenta.

¿Envía mis preguntas a algún lugar? No. Las preguntas se responden en tu máquina. El único uso de red es la comprobación automática de documentación más nueva, como máximo una vez al día, que puedes desactivar.

¿Puede mi asistente llamar a la API de Inovacc a través de él? No. Le explica al asistente cómo funciona un endpoint y cómo llamarlo; no hace la llamada.

¿Existe un servidor MCP alojado? Hay un servidor remoto en https://mcp.inovacc.dev planificado. Todavía no existe.

¿Qué plataformas son compatibles? Hoy, Windows x86_64. macOS y Linux llegarán, sin fecha todavía.

Ver también

• Autenticación: los encabezados que lleva toda llamada a la API.
• Referencia de la API: cada producto y sus endpoints.
• llms.txt: la misma documentación como índice para modelos de lenguaje.