Saltar a contenido

Configurar MCP en apps de escritorio

Esta guía muestra cómo cargar los servidores MCP de NEO (playwright, jira, azure-devops) cuando trabajás con una app de escritorio en lugar de un editor de código. Antes de empezar, revisá en Configurar los MCP qué servidores necesitás y qué datos van en cada uno.

App ¿Sirve para NEO? Dónde se configura
Claude Desktop ✅ Tanto en el chat como en la pestaña Code claude_desktop_config.json y, en la pestaña Code, también .mcp.json
ChatGPT Desktop ✅ A través de Codex dentro de la app · ❌ en el chat común ~/.codex/config.toml
GitHub Copilot app ✅ La configuración del repositorio o de Copilot CLI, más la de la app
Microsoft Copilot (Windows) ❌ No hay documentación para agregar servidores MCP propios

Recordá: los tres servidores de NEO son locales: la app tiene que lanzarlos en tu computadora con npx o uvx. Por eso tenés que tener instalados Node.js y, si usás Jira, uv, aunque trabajes solo con la app de escritorio.


Claude Desktop

Claude Desktop tiene dos formas de trabajo, y los MCP se comportan distinto en cada una:

Pestaña Qué es Qué configuración de MCP lee
Chat El chat de Claude Solo claude_desktop_config.json
Code Claude Code dentro de la app de escritorio (la opción B de Primeros pasos) .mcp.json del proyecto, ~/.claude.json y también claude_desktop_config.json

Para trabajar con NEO, lo habitual es la pestaña Code, abierta sobre la carpeta del proyecto. En ese caso no hace falta tocar claude_desktop_config.json: alcanza con el .mcp.json del proyecto, igual que en Claude Code en VS Code. Y lippia-neo-bootstrap-stack lo puede crear por vos.

Opción 1 — Pestaña Code con .mcp.json (recomendada)

  1. Abrí la app → pestaña Code → elegí la carpeta del repositorio de pruebas.
  2. Asegurate de que exista .mcp.json en la raíz del proyecto, con la configuración de referencia y tus valores reales.
  3. Abrí una sesión nueva: los servidores del proyecto se cargan al iniciar.
  4. Para verificar, usá el botón + → Connectors (o /mcp en la sesión).

Opción 2 — claude_desktop_config.json (chat y pestaña Code)

Sirve cuando querés usar los servidores también desde el chat, o tenerlos disponibles en todos los proyectos.

  1. Abrí la app → menú Claude → Settings → Developer → Edit Config. Se abre el archivo:
Sistema Ruta
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
  1. Pegá los servidores con la clave raíz mcpServers. Es el mismo formato que .mcp.json, pero sin el campo type:
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium"]
    },
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://tu-sitio.atlassian.net/",
        "JIRA_USERNAME": "tu.email@empresa.com",
        "JIRA_API_TOKEN": "<token>",
        "CONFLUENCE_URL": "https://tu-sitio.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "tu.email@empresa.com",
        "CONFLUENCE_API_TOKEN": "<token>",
        "READ_ONLY_MODE": "true"
      }
    },
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/tu-org",
        "AZURE_DEVOPS_AUTH_METHOD": "pat",
        "AZURE_DEVOPS_PAT": "<token>"
      }
    }
  }
}
  1. Cerrá la app por completo y volvé a abrirla. Cerrar la ventana no alcanza: en Windows, salí también desde el ícono de la bandeja del sistema.
  2. Verificá: botón + (en el cuadro de mensaje) → Connectors → Manage connectors. Los servidores tienen que figurar ahí.

Si un servidor está en los dos lugares (claude_desktop_config.json y .mcp.json) con el mismo nombre, la pestaña Code se conecta una sola vez y usa la definición de claude_desktop_config.json. Para no confundirte, cargá cada servidor en un solo lugar.

La CLI y la extensión de VS Code no leen claude_desktop_config.json. Un servidor que cargaste solo ahí no aparece en Claude Code fuera de la app de escritorio.

Katalon Studio

katalon-studio es un servidor remoto (HTTP). Para NEO, usalo desde la pestaña Code con el .mcp.json del proyecto (Opción 1), que admite "type": "http". No lo cargues en claude_desktop_config.json: esa configuración está pensada para servidores locales. Detalle en Configurar el MCP de Katalon Studio.

Si algo falla en Claude Desktop

Lo que ves Qué hacer
El servidor no aparece Reiniciar la app por completo y revisar que el JSON sea válido (una coma de más rompe todo el archivo)
Falla con ENOENT y aparece ${APPDATA} en el error (Windows) Agregar en el env de ese servidor: "APPDATA": "C:\\Users\\<tu-usuario>\\AppData\\Roaming\\"
Querés ver el error exacto Logs en %APPDATA%\Claude\logs (Windows) o ~/Library/Logs/Claude (macOS): mcp.log y mcp-server-<nombre>.log

Claude Desktop también permite instalar servidores como extensiones (archivos .mcpb, desde Settings → Extensions) y agregar conectores remotos (Settings → Connectors → Add custom connector). Los servidores de NEO se cargan con la configuración JSON de arriba.


ChatGPT Desktop

En la app de ChatGPT hay dos lugares distintos donde aparecen los MCP, y solo uno sirve para NEO:

Dónde Qué servidores acepta ¿Sirve para NEO?
Codex dentro de la app de escritorio Locales (STDIO) y remotos ✅ Sí
Chat de ChatGPT (conectores / developer mode) Solo remotos: una URL HTTPS pública ❌ No: los servidores de NEO son locales

Configurar Codex en la app de escritorio

La app de escritorio comparte la configuración con Codex CLI y la extensión de Codex. Si ya lo configuraste en uno, ya está en los tres.

Por interfaz:

  1. Abrí la app → Codex → Settings → MCP servers → Add server.
  2. Elegí STDIO.
  3. Completá el nombre (playwright), el comando (npx) y los argumentos (-y @playwright/mcp@latest --browser chromium). Agregá las variables de entorno si es jira o azure-devops.
  4. Save y después Restart.

Por archivo: editá ~/.codex/config.toml (en Windows, %USERPROFILE%\.codex\config.toml) con el formato TOML que está en Codex en VS Code.

¿Y el chat de ChatGPT?

El chat común solo se conecta a servidores remotos (una URL HTTPS con el protocolo Streamable HTTP), que se agregan activando el developer mode en Settings → Security and login y después desde Plugins → +. Los servidores de NEO se ejecutan en tu computadora, así que no se pueden conectar al chat. Para usar NEO con OpenAI, usá Codex.


GitHub Copilot app (de escritorio)

GitHub tiene una app de escritorio de Copilot (Windows, macOS y Linux) pensada para trabajar con agentes, que soporta servidores MCP y skills.

Según la documentación de GitHub, la app toma los servidores MCP ya configurados en el repositorio o en Copilot CLI, y permite agregar más desde su propia configuración. En la práctica:

  1. Configurá los servidores como en GitHub Copilot CLI: ~/.copilot/mcp-config.json para todos tus proyectos, o .mcp.json / .github/mcp.json en la raíz del repositorio.
  2. Abrí el repositorio en la app y revisá su configuración de MCP para confirmar que los servidores aparecen.

Esta app es nueva y su documentación todavía no tiene un paso a paso detallado de MCP. Si algo no coincide con lo que ves en pantalla, la configuración de Copilot CLI es la referencia más estable.

La app de escritorio GitHub Desktop (la de manejar repositorios) es otra cosa: no encontramos que soporte servidores MCP.


Microsoft Copilot (app de Windows)

No encontramos documentación oficial que permita agregar servidores MCP propios en la app de Microsoft Copilot para Windows, así que hoy no la recomendamos para NEO. En el ecosistema de Microsoft, Copilot con MCP está disponible en los IDE: ver GitHub Copilot en Visual Studio y GitHub Copilot en VS Code.