# Inovacc MCP El [Model Context Protocol](https://modelcontextprotocol.io) (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: ```text 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: ```powershell (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: ```powershell inovacc docs version ``` La salida tiene esta forma; los números de versión cambian con cada versión: ```text 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\\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: ```json { "mcpServers": { "inovacc": { "command": "inovacc", "args": ["mcp", "serve"] } } } ``` ### Claude Code ```sh claude 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: ```sh claude 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: ```json { "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: ```json { "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`): ```json { "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: ```json { "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: ```json { "mcpServers": { "inovacc": { "command": "inovacc", "args": ["mcp", "serve"] } } } ``` Haz clic en **OK** y luego en **Apply**. ### Codex CLI ```sh codex mcp add inovacc -- inovacc mcp serve ``` o escríbelo en `~/.codex/config.toml` (un proyecto de confianza puede usar `.codex/config.toml`): ```toml [mcp_servers.inovacc] command = "inovacc" args = ["mcp", "serve"] ``` **Importante:** Codex usa TOML y `mcp_servers`, no JSON ni `mcpServers`. ### Gemini CLI ```sh gemini mcp add inovacc inovacc mcp serve ``` o agrega el servidor a `~/.gemini/settings.json` (un proyecto puede usar `.gemini/settings.json`): ```json { "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: ```sh inovacc 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 | Herramienta | Qué hace | |---|---| | `search_documentation` | Búsqueda de texto completo en secciones de contrato, capacidades, inicios rápidos y guías | | `get_document` | Un documento completo, por id, con su procedencia | | `get_api_reference` | La sección de contrato de un endpoint, como `POST /v1/vector/query` | | `list_products` | Los productos y capacidades con documentación, y cuántos documentos tiene cada uno | | `get_quickstart` | URL base, endpoints, permisos, los encabezados que necesita toda llamada y un esqueleto de curl | | `get_knowledge_version` | Qué paquete de documentación responde: versión, hora de compilación, commits fijados y cantidad de documentos | ## 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. ```sh inovacc 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 | Ajuste | Qué hace | |---|---| | `INOVACC_KNOWLEDGE_DIR` | La carpeta donde se guarda la documentación instalada. Por defecto en Windows: `%LOCALAPPDATA%\Inovacc\knowledge` | | `INOVACC_NO_UPDATE_CHECK` | Ponlo en `1` para desactivar la comprobación automática de documentación más nueva. La opción `--no-update-check` hace lo mismo para una ejecución | | `INOVACC_UPDATE_URL` | La dirección del `latest.json` de donde se leen las actualizaciones; debe ser HTTPS | ## 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](/es/guides/authentication/): los encabezados que lleva toda llamada a la API. - [Referencia de la API](/es/reference/): cada producto y sus endpoints. - [llms.txt](/llms.txt): la misma documentación como índice para modelos de lenguaje.