---
title: "Añade un servidor MCP a Claude Code y Codex"
description: "Ejecuta claude mcp add --transport http en Claude Code o codex mcp add --url en Codex y luego inicia sesión. Probamos los dos con el servidor MCP de LogBrew."
canonical: "https://logbrew.co/es/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# Añade un servidor MCP a Claude Code y Codex

Ejecuta `claude mcp add --transport http` en Claude Code o `codex mcp add --url` en Codex y luego inicia sesión. Probamos los dos con el servidor MCP de LogBrew.

Probado el 10 de noviembre de 2026 con Claude Code 2.1.319 y Codex CLI 0.167.0

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday es el fundador de LogBrew. Desarrolla LogBrew con Claude Code y Codex todos los días.

Canonical: https://logbrew.co/es/guides/mcp-server-claude-code-codex

## 1 servidor MCP, 2 agentes

Servidor MCP de LogBrew `https://logbrew.co/mcp`

Herramientas `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| Guardado en | `~/.claude.json` | `~/.codex/config.toml` |
| Antes de iniciar sesión | `Needs authentication` | `Not logged in` |

## Claude Code

### Añade el servidor

Ejecútalo en la carpeta de tu proyecto. Claude Code añade el servidor solo para este proyecto y lo guarda en `~/.claude.json`.

```bash
claude mcp add --transport http logbrew https://logbrew.co/mcp
```

Salida

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to local config
```

### Compártelo o úsalo en todas partes

`--scope project` escribe `.mcp.json` en la raíz del proyecto, así tu equipo recibe el servidor a través de Git. `--scope user` lo añade a todos tus proyectos.

```bash
claude mcp add --transport http logbrew --scope user https://logbrew.co/mcp
```

Salida

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to user config
```

### Comprueba el servidor

Claude Code comprueba cada servidor que lista. Antes de que inicies sesión, un servidor con OAuth muestra `Needs authentication`. Un servidor de `.mcp.json` muestra `Pending approval` hasta que lo apruebes en una sesión.

```bash
claude mcp list
```

Salida

```text
Checking MCP server health…

logbrew: https://logbrew.co/mcp (HTTP) - ! Needs authentication
```

### Inicia sesión

Escribe `/mcp` en una sesión, elige el servidor y aprueba el acceso en el navegador. Desde la terminal, `claude mcp login logbrew` hace lo mismo. Por SSH, añade `--no-browser`.

```bash
/mcp
```

## Codex

### Añade el servidor

Codex escribe una tabla `[mcp_servers.logbrew]` en `~/.codex/config.toml`. Si el servidor usa OAuth, Codex empieza el inicio de sesión al momento y abre tu navegador.

```bash
codex mcp add logbrew --url https://logbrew.co/mcp
```

Salida

```text
Added global MCP server 'logbrew'.
Detected OAuth support. Starting OAuth flow…
```

### Inicia sesión más tarde o por SSH

Si cierras la pestaña del navegador, inicia sesión más tarde con este comando. Por SSH, añade `--no-browser`, abre en otro ordenador la URL que aparece y pega la URL de redirección completa en la terminal.

```bash
codex mcp login logbrew
```

### Comprueba el servidor

Antes de que inicies sesión, la columna `Auth` muestra `Not logged in`. Escribe `/mcp` en una sesión abierta de Codex para ver tus servidores activos.

```bash
codex mcp list
```

Salida

```text
Name     Url                     Bearer Token Env Var  Status   Auth
logbrew  https://logbrew.co/mcp  -                     enabled  Not logged in
```

## Lo que vimos al probarlo

Ejecutamos todos los comandos de esta página en macOS, con carpetas de configuración desechables definidas con `CLAUDE_CONFIG_DIR` y `CODEX_HOME`, así que ninguna configuración real cambió.

En Claude Code, cada `claude mcp add` mostró el archivo que cambió. Después, `claude mcp list` mostró `Needs authentication` para el servidor nuevo y `Pending approval` para el de `.mcp.json`.

En Codex, `codex mcp add` mostró `Detected OAuth support. Starting OAuth flow…` y después una URL de inicio de sesión. Habíamos bloqueado el navegador para la prueba, así que Codex nos pidió copiar la URL a mano. Cuenta con que se abra una pestaña del navegador cuando añadas un servidor que usa OAuth.

En los dos agentes paramos antes de la pantalla de consentimiento. Los pasos de inicio de sesión de esta página siguen la documentación de Claude Code y Codex.

## Soluciona invalid transport en mcp_servers

Codex se detiene con `invalid transport` en `mcp_servers.logbrew` cuando una tabla de servidor no tiene ni `url` ni `command`. Obtuvimos exactamente este error con una tabla `[mcp_servers.logbrew]` vacía.

Dale a cada tabla 1 de los 2. Usa `url` para un servidor remoto y `command` para uno local. Una tabla con los dos también falla, con `url is not supported for stdio`. Una línea `type = "http"` al estilo de Claude no hace daño, porque Codex la ignora.

El reporte #40715 muestra el mismo mensaje en la app de escritorio de ChatGPT en Windows, para una entrada `mcp_servers.codex_app` que el usuario nunca escribió. El 26 de agosto de 2026, un ingeniero de OpenAI escribió que el equipo estaba trabajando en una solución. El reporte sigue abierto.

Salida

```text
Error: failed to load bootstrap configuration

Caused by:
    invalid transport
    in `mcp_servers.logbrew`
```

## Limita herramientas y tiempos de espera en Codex

`enabled_tools` deja solo las herramientas que indiques y `disabled_tools` quita herramientas después. `startup_timeout_sec` y `tool_timeout_sec` valen 10 y 60 segundos por defecto. El servidor de LogBrew tiene 2 herramientas, `search` y `execute`. `codex mcp get logbrew` mostró cada valor que definimos.

```bash
[mcp_servers.logbrew]
url = "https://logbrew.co/mcp"
enabled_tools = ["search", "execute"]
startup_timeout_sec = 20
```

## Edita a mano la configuración de Claude Code

Este es el `.mcp.json` que escribió `--scope project` en nuestra prueba. Claude Code pide a cada persona que apruebe el servidor la primera vez que arranca en ese proyecto.

```bash
{
  "mcpServers": {
    "logbrew": {
      "type": "http",
      "url": "https://logbrew.co/mcp"
    }
  }
}
```

## Preguntas frecuentes

### ¿Claude Code admite servidores MCP remotos?

Sí. Usa `--transport http` con la URL del servidor. Si el servidor usa OAuth, Claude Code te pide iniciar sesión con `/mcp` o `claude mcp login`.

### ¿Dónde guarda Claude Code los servidores MCP?

Los servidores locales y de usuario van en `~/.claude.json`. Los de proyecto van en `.mcp.json`, en la raíz del proyecto.

### ¿Dónde guarda Codex los servidores MCP?

En `~/.codex/config.toml`, o en `.codex/config.toml` si es un proyecto de confianza.

### ¿Cómo elimino un servidor MCP?

Ejecuta `claude mcp remove logbrew` o `codex mcp remove logbrew`. En Claude Code, ejecuta antes `claude mcp logout logbrew` si también quieres revocar el token.

## Deja que tu agente lea los errores de producción

El servidor MCP de LogBrew da a Claude Code, Codex y cualquier otro cliente MCP los errores, logs y trazas de los proyectos que apruebes. Solo lee, salvo que permitas más. Empieza con el generoso plan gratuito, sin tarjeta.

[Conectar tu agente](https://logbrew.co/es/agents)

## Fuentes

- [Claude Code docs, Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Codex docs, Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
- [openai/codex#40715](https://github.com/openai/codex/issues/40715)

## Más guías para agentes de programación con IA

- [Usa AGENTS.md en Claude Code y Codex](https://logbrew.co/es/guides/agents-md)
- [Soluciona el error 529 overloaded y el error 429 de rate limit en Claude](https://logbrew.co/es/guides/claude-overloaded-rate-limit-error)
- [Cómo solucionar errores en Claude Code, Codex y JavaScript del navegador](https://logbrew.co/es/guides)