Configurar MCP en la terminal
Esta guía muestra cómo cargar los servidores MCP de NEO (playwright, jira, azure-devops) desde la línea de comandos de cada asistente. Es útil si trabajás en la terminal, o si preferís un comando antes que editar un archivo a mano. Antes de empezar, revisá en Configurar los MCP qué servidores necesitás y qué datos van en cada uno.
| Asistente | Comando para agregar | Archivo donde queda | Cómo verificar |
|---|---|---|---|
| Claude Code CLI | claude mcp add |
.mcp.json o ~/.claude.json |
/mcp · claude mcp list |
| Codex CLI | codex mcp add |
~/.codex/config.toml |
/mcp · codex mcp list |
| GitHub Copilot CLI | /mcp add |
~/.copilot/mcp-config.json o .mcp.json |
/mcp show <nombre> |
Claude Code CLI
La CLI y la extensión de VS Code usan la misma configuración: lo que agregás acá aparece también en el IDE (y en la pestaña Code de Claude Desktop).
Agregar los servidores
Las opciones van antes del nombre, y el -- separa el comando que lanza el servidor:
# Playwright — en el proyecto (queda en .mcp.json)
claude mcp add --transport stdio --scope project playwright -- npx -y @playwright/mcp@latest --browser chromium
# Jira
claude mcp add --transport stdio --scope project \
--env JIRA_URL=https://tu-sitio.atlassian.net/ \
--env JIRA_USERNAME=tu.email@empresa.com \
--env JIRA_API_TOKEN=<token> \
--env CONFLUENCE_URL=https://tu-sitio.atlassian.net/wiki \
--env CONFLUENCE_USERNAME=tu.email@empresa.com \
--env CONFLUENCE_API_TOKEN=<token> \
--env READ_ONLY_MODE=true \
jira -- uvx mcp-atlassian
# Azure DevOps
claude mcp add --transport stdio --scope project \
--env AZURE_DEVOPS_ORG_URL=https://dev.azure.com/tu-org \
--env AZURE_DEVOPS_AUTH_METHOD=pat \
--env AZURE_DEVOPS_PAT=<token> \
azure-devops -- npx -y @tiberriver256/mcp-server-azure-devops
Si ya tenés el JSON armado, podés pasarlo entero con claude mcp add-json <nombre> '<json>'.
¿Qué alcance elegir? (--scope)
--scope |
Dónde queda | Recomendado para |
|---|---|---|
project |
.mcp.json en la raíz del repositorio |
NEO (verificá que .mcp.json esté en .gitignore si tiene tokens) |
local (el que se usa si no ponés nada) |
~/.claude.json, solo para ese proyecto |
Probar algo sin tocar el repositorio |
user |
~/.claude.json, para todos los proyectos |
Servidores que usás siempre, como playwright |
No cargues el mismo servidor en dos alcances distintos (ver Incidente 2).
Verificar y administrar
claude mcp list # lista los servidores y su estado
claude mcp get playwright # detalle de un servidor
claude mcp remove jira # quitar un servidor
Dentro de una sesión de claude, el comando /mcp muestra si cada servidor está Connected, Failed o Pending approval. Los servidores de .mcp.json piden aprobación la primera vez. Si te equivocaste al responder, podés volver a preguntar con claude mcp reset-project-choices.
Codex CLI
Codex CLI comparte la configuración con la extensión de Codex y con la app de escritorio de ChatGPT (~/.codex/config.toml).
Agregar los servidores
codex mcp add playwright -- npx -y @playwright/mcp@latest --browser chromium
codex mcp add jira \
--env JIRA_URL=https://tu-sitio.atlassian.net/ \
--env JIRA_USERNAME=tu.email@empresa.com \
--env JIRA_API_TOKEN=<token> \
--env CONFLUENCE_URL=https://tu-sitio.atlassian.net/wiki \
--env CONFLUENCE_USERNAME=tu.email@empresa.com \
--env CONFLUENCE_API_TOKEN=<token> \
--env READ_ONLY_MODE=true \
-- uvx mcp-atlassian
codex mcp add azure-devops \
--env AZURE_DEVOPS_ORG_URL=https://dev.azure.com/tu-org \
--env AZURE_DEVOPS_AUTH_METHOD=pat \
--env AZURE_DEVOPS_PAT=<token> \
-- npx -y @tiberriver256/mcp-server-azure-devops
Si preferís editar el archivo a mano (por ejemplo, para usar env_vars y no escribir el token), el formato TOML está en Codex en VS Code.
Verificar
codex mcp list
Dentro de una sesión de codex, /mcp muestra los servidores conectados.
GitHub Copilot CLI
Dónde se guarda
| Archivo | Alcance |
|---|---|
~/.copilot/mcp-config.json |
Todos tus proyectos |
.mcp.json o .github/mcp.json en la raíz del repositorio |
Ese proyecto (tiene prioridad sobre la configuración de usuario) |
Como Copilot CLI también lee
.mcp.jsondel repositorio, el mismo archivo que usaNEOcon Claude Code puede servir para Copilot CLI. Probá primero con/mcp show playwright: puede que ya esté todo.
Agregar los servidores
Dentro de una sesión de copilot, escribí /mcp add: se abre un formulario para cargar el nombre, el comando, los argumentos y las variables de entorno.
O editá ~/.copilot/mcp-config.json directamente. La clave raíz es mcpServers y el tipo de un servidor local es "local":
{
"mcpServers": {
"playwright": {
"type": "local",
"command": "npx",
"args": ["-y", "@playwright/mcp@latest", "--browser", "chromium"],
"env": {},
"tools": ["*"]
},
"jira": {
"type": "local",
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://tu-sitio.atlassian.net/",
"JIRA_USERNAME": "tu.email@empresa.com",
"JIRA_API_TOKEN": "<token>",
"READ_ONLY_MODE": "true"
},
"tools": ["*"]
}
}
}
"tools": ["*"] habilita todas las herramientas del servidor.
Verificar
/mcp show playwright
La configuración de Copilot CLI es la que también usa la GitHub Copilot app de escritorio.
Katalon Studio (servidor remoto)
katalon-studio es un servidor remoto (HTTP) que publica Katalon Studio: se agrega con --transport http y la URL, sin comando. Guía completa: Configurar el MCP de Katalon Studio.
# Claude Code CLI
claude mcp add --transport http --scope project katalon-studio \
http://127.0.0.1:33699/mcp/stream \
--header "Authorization: Bearer <token>"
# Codex CLI
codex mcp add katalon-studio --url http://127.0.0.1:33699/mcp/stream \
--bearer-token-env-var KATALON_MCP_TOKEN
Usá la URL que muestra tu Katalon Studio. Si el server no pide token, omití --header / --bearer-token-env-var. Para GitHub Copilot CLI, agregá el bloque con "type": "http" y "url" al mismo archivo de configuración.
Katalon Studio tiene que estar abierto con el proyecto de la suite, y el handshake tarda ~30 segundos: definí
MCP_TIMEOUT=60000antes de abrir el asistente.
Problemas comunes en la terminal
| Lo que ves | Por qué puede pasar | Qué hacer |
|---|---|---|
claude mcp add toma los argumentos del servidor como opciones propias |
Falta el -- antes del comando del servidor |
Poner -- justo antes de npx / uvx |
| El servidor quedó en el alcance equivocado | Se usó el alcance por defecto (local) en vez de project |
Quitarlo con claude mcp remove y volver a agregarlo con --scope project |
| El token quedó en el historial de la terminal | Se pasó con --env en la línea de comandos |
Limpiar el historial, o cargar el token en el archivo o como variable de entorno |
uvx: command not found |
uv no está instalado | Instalar uv (docs.astral.sh/uv) y abrir una terminal nueva |