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
NEOson locales: la app tiene que lanzarlos en tu computadora connpxouvx. 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 tocarclaude_desktop_config.json: alcanza con el.mcp.jsondel proyecto, igual que en Claude Code en VS Code. Ylippia-neo-bootstrap-stacklo puede crear por vos.
Opción 1 — Pestaña Code con .mcp.json (recomendada)
- Abrí la app → pestaña Code → elegí la carpeta del repositorio de pruebas.
- Asegurate de que exista
.mcp.jsonen la raíz del proyecto, con la configuración de referencia y tus valores reales. - Abrí una sesión nueva: los servidores del proyecto se cargan al iniciar.
- Para verificar, usá el botón + → Connectors (o
/mcpen 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.
- 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 |
- Pegá los servidores con la clave raíz
mcpServers. Es el mismo formato que.mcp.json, pero sin el campotype:
{
"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>"
}
}
}
}
- 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.
- 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.jsony.mcp.json) con el mismo nombre, la pestaña Code se conecta una sola vez y usa la definición declaude_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 deNEOse 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:
- Abrí la app → Codex → Settings → MCP servers → Add server.
- Elegí STDIO.
- Completá el nombre (
playwright), el comando (npx) y los argumentos (-y @playwright/mcp@latest --browser chromium). Agregá las variables de entorno si esjiraoazure-devops. - 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:
- Configurá los servidores como en GitHub Copilot CLI:
~/.copilot/mcp-config.jsonpara todos tus proyectos, o.mcp.json/.github/mcp.jsonen la raíz del repositorio. - 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.