Saltar a contenido

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.json del repositorio, el mismo archivo que usa NEO con 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=60000 antes 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