---
title: "Conectar un servidor MCP | mcp.tc"
description: "Añade un servidor MCP a Claude Code, claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code y otros clientes: inicio de sesión, claves de API y servidores locales."
url: "https://mcp.tc/es/docs/connect"
markdown: "https://mcp.tc/es/docs/connect.md"
lang: "es"
---

# Conectar un servidor MCP

Cómo añadir un servidor de mcp.tc a Claude Code, claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code y otros clientes. Cada paso usa la URL o el paquete propios del servidor, igual que los botones de cada ficha.

## Antes de empezar

En la parte superior de cada ficha verás con qué conectarte: la URL propia del servidor si es remoto, o el comando de instalación si es local. Cuando no pudimos confirmar ninguno de los dos, enlaza a las instrucciones del propio proyecto. Las insignias bajo el nombre indican qué necesita el servidor.

Los pasos de abajo son los que muestra la sección **Configuración** de cada ficha, aquí para cuatro servidores de ejemplo. Elige uno con las pestañas; la elección se aplica a todos los clientes de esta página.

- **Sin cuenta**: [DeepWiki, verificado](https://mcp.tc/es/i/deepwiki), un servidor remoto que cualquiera puede usar, en `https://mcp.deepwiki.com/mcp`.
- **Requiere cuenta**: [Notion, verificado](https://mcp.tc/es/i/notion), un servidor remoto que te pide iniciar sesión con OAuth.
- **Clave de API**: un servidor inventado en `mcp.example.com` que requiere una clave en la cabecera `Authorization`.
- **Local**: [Memory, verificado](https://mcp.tc/es/i/memory), que tu cliente inicia con `npx -y @modelcontextprotocol/server-memory`.

En la página de una ficha, los mismos pasos aparecen ya rellenados para ese servidor, y los botones **Añadir a** hacen el primer paso por ti.

Desde un terminal, [mcp-tc](https://mcp.tc/es/cli), nuestra herramienta de línea de comandos de código abierto, usa los mismos pasos. `npx mcp-tc add deepwiki --client cursor` añade el servidor a tu cliente tal como lo describe la sección **Configuración**: muestra el comando que va a ejecutar o el cambio en tu archivo de configuración, te pide confirmación, hace una copia de seguridad del archivo de configuración antes de escribirlo y deja las claves de API en tu equipo. `npx mcp-tc scan` busca en mcp.tc los servidores de las configuraciones de tus clientes. Por cada servidor envía una sola dirección: su URL https sin credenciales, parámetros de consulta ni partes de la ruta que parezcan claves, o, para un servidor local, el nombre del paquete o la URL del repositorio. Las claves, las cabeceras y las variables de entorno se quedan en tu equipo, y las direcciones privadas nunca se envían.

## Claude Code

Claude Code añade servidores desde el terminal con `claude mcp add`. En una ficha, **Añadir a Claude Code** copia el comando.

### Sin cuenta

1. Ejecútalo en un terminal, en la carpeta de tu proyecto:

```
claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp
```

2. Inicia Claude Code y escribe `/mcp`. **deepwiki** debería aparecer como conectado.

Añade `--scope user` para que esté disponible en todos los proyectos, no solo en este.

### Requiere cuenta

1. Ejecútalo en un terminal, en la carpeta de tu proyecto:

```
claude mcp add --transport http notion https://mcp.notion.com/mcp
```

2. Inicia Claude Code, escribe `/mcp`, elige **notion** y selecciona **Authenticate**. Se abre una ventana del navegador para iniciar sesión en Notion.

Añade `--scope user` para que esté disponible en todos los proyectos, no solo en este.

### Clave de API

1. Ejecútalo en un terminal, en la carpeta de tu proyecto:

```
claude mcp add --transport http example https://mcp.example.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
```

2. Sustituye el marcador por tu clave antes de ejecutarlo, y después compruébalo con `/mcp` dentro de Claude Code.

Añade `--scope user` para que esté disponible en todos los proyectos, no solo en este.

### Local

1. Ejecútalo en un terminal, en la carpeta de tu proyecto:

```
claude mcp add --transport stdio memory -- npx -y @modelcontextprotocol/server-memory
```

2. Inicia Claude Code y escribe `/mcp`. **memory** debería aparecer como conectado.

Añade `--scope user` para que esté disponible en todos los proyectos.

## claude.ai

claude.ai añade servidores remotos como conectores personalizados. **Añadir a claude.ai** abre el formulario del conector con el nombre y la URL rellenados. Un servidor que pide una clave de API también funciona: añade la clave en **Request headers** en el mismo formulario, por ejemplo `Authorization: Bearer YOUR_KEY`. claude.ai no puede iniciar servidores locales, así que las fichas locales no lo ofrecen.

### Sin cuenta

1. Abre el formulario de conectores en claude.ai. Este botón rellena el nombre y la URL por ti:

[Añadir a claude.ai](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=DeepWiki&connectorUrl=https%3A%2F%2Fmcp.deepwiki.com%2Fmcp)

2. Comprueba que la URL es `https://mcp.deepwiki.com/mcp` y haz clic en **Add**.
3. Actívalo en un chat desde el menú de herramientas.

Los planes gratuitos permiten un conector personalizado. En los planes Team y Enterprise lo añade un propietario en **Organization settings → Connectors**.

### Requiere cuenta

1. Abre el formulario de conectores en claude.ai. Este botón rellena el nombre y la URL por ti:

[Añadir a claude.ai](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Notion&connectorUrl=https%3A%2F%2Fmcp.notion.com%2Fmcp)

2. Comprueba que la URL es `https://mcp.notion.com/mcp` y haz clic en **Add**.
3. Haz clic en **Connect** e inicia sesión cuando te lo pida Notion.

Los planes gratuitos permiten un conector personalizado. En los planes Team y Enterprise lo añade un propietario en **Organization settings → Connectors**.

### Clave de API

1. Abre el formulario de conectores en claude.ai. Este botón rellena el nombre y la URL por ti:

[Añadir a claude.ai](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Example&connectorUrl=https%3A%2F%2Fmcp.example.com%2Fmcp)

2. Comprueba que la URL es `https://mcp.example.com/mcp`. En **Request headers**, añade `Authorization: Bearer <YOUR_API_KEY>` con tu clave de Example y luego haz clic en **Add**.
3. Actívalo en un chat desde el menú de herramientas.

Los planes gratuitos permiten un conector personalizado. En los planes Team y Enterprise lo añade un propietario en **Organization settings → Connectors**.

## Claude Desktop

Los servidores remotos van por **Connectors**, los mismos que ves en claude.ai, incluidos los que piden una clave de API en **Request headers**. Los servidores locales van en su archivo de configuración JSON. Para guardar una clave en tu equipo, usa en su lugar el puente `mcp-remote`.

### Sin cuenta

1. Abre **Customize → Connectors**, haz clic en **+ Add** y luego en **Add custom connector**.
2. Llámalo **DeepWiki** y pega esta URL:

```
https://mcp.deepwiki.com/mcp
```

3. Haz clic en **Add**. Sus herramientas aparecen en el menú de herramientas del chat.

El archivo de configuración JSON de Claude Desktop solo inicia servidores locales. Los servidores remotos van por Connectors, y los conectores que añades en claude.ai también aparecen aquí.

### Requiere cuenta

1. Abre **Customize → Connectors**, haz clic en **+ Add** y luego en **Add custom connector**.
2. Llámalo **Notion** y pega esta URL:

```
https://mcp.notion.com/mcp
```

3. Haz clic en **Add**, luego en **Connect**, e inicia sesión cuando te lo pida Notion.

El archivo de configuración JSON de Claude Desktop solo inicia servidores locales. Los servidores remotos van por Connectors, y los conectores que añades en claude.ai también aparecen aquí.

### Clave de API

1. Usa el puente `mcp-remote`, que guarda la clave en este equipo (un conector añadido en claude.ai con la clave en **Request headers** también aparece aquí). Abre **Settings → Developer → Edit Config** y añade:

`claude_desktop_config.json`:

```
{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.example.com/mcp",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}
```

2. Sustituye el marcador por tu clave y reinicia Claude Desktop.

El puente necesita Node.js en tu equipo.

### Local

1. Abre **Settings → Developer → Edit Config**. Se abre `claude_desktop_config.json`. Añade:

`claude_desktop_config.json`:

```
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
```

2. Guarda el archivo y reinicia Claude Desktop.

Necesita Node.js en tu equipo. El archivo está en `~/Library/Application Support/Claude/` en macOS y en `%APPDATA%\Claude\` en Windows.

## ChatGPT

ChatGPT se conecta a los servidores remotos que añades en Plugins. Como claude.ai, no puede iniciar servidores locales ni enviar una cabecera de clave de API.

### Sin cuenta

1. En chatgpt.com, ve a **Plugins**, selecciona **+** y luego **Add custom MCP server**.
2. Escribe un nombre para el servidor.
3. En **Connection**, pega `https://mcp.deepwiki.com/mcp` como URL del servidor y luego, como autenticación, elige **No authentication**.
4. Marca **I understand and want to continue** y luego selecciona **Create as a plugin**.

Poder añadir un servidor MCP personalizado depende de tu plan de ChatGPT y de los permisos de tu espacio de trabajo (en los espacios Business pueden hacerlo los administradores y los propietarios).

### Requiere cuenta

1. En chatgpt.com, ve a **Plugins**, selecciona **+** y luego **Add custom MCP server**.
2. Escribe un nombre para el servidor.
3. En **Connection**, pega `https://mcp.notion.com/mcp` como URL del servidor y luego, como autenticación, elige **OAuth**. ChatGPT te envía a Notion para iniciar sesión.
4. Marca **I understand and want to continue** y luego selecciona **Create as a plugin**.

Poder añadir un servidor MCP personalizado depende de tu plan de ChatGPT y de los permisos de tu espacio de trabajo (en los espacios Business pueden hacerlo los administradores y los propietarios).

## Cursor

**Añadir a Cursor** abre la página de instalación de Cursor con el servidor ya rellenado. También puedes añadirlo a mano en `mcp.json`.

### Sin cuenta

[Añadir a Cursor](https://cursor.com/install-mcp?name=deepwiki&config=eyJ1cmwiOiJodHRwczovL21jcC5kZWVwd2lraS5jb20vbWNwIn0%3D)

O añádelo a mano en `~/.cursor/mcp.json` (todos los proyectos) o en `.cursor/mcp.json` (este proyecto):

`mcp.json`:

```
{
  "mcpServers": {
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}
```

### Requiere cuenta

[Añadir a Cursor](https://cursor.com/install-mcp?name=notion&config=eyJ1cmwiOiJodHRwczovL21jcC5ub3Rpb24uY29tL21jcCJ9)

O añádelo a mano en `~/.cursor/mcp.json` (todos los proyectos) o en `.cursor/mcp.json` (este proyecto):

`mcp.json`:

```
{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

Cursor muestra **Needs authentication** junto al servidor. Haz clic en el botón de al lado para iniciar sesión.

### Clave de API

[Añadir a Cursor](https://cursor.com/install-mcp?name=example&config=eyJ1cmwiOiJodHRwczovL21jcC5leGFtcGxlLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgPFlPVVJfQVBJX0tFWT4ifX0%3D)

O añádelo a mano en `~/.cursor/mcp.json` (todos los proyectos) o en `.cursor/mcp.json` (este proyecto):

`mcp.json`:

```
{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

### Local

[Añadir a Cursor](https://cursor.com/install-mcp?name=memory&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb2RlbGNvbnRleHRwcm90b2NvbC9zZXJ2ZXItbWVtb3J5Il19)

O añádelo a mano en `~/.cursor/mcp.json` (todos los proyectos) o en `.cursor/mcp.json` (este proyecto):

`mcp.json`:

```
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
```

Necesita Node.js en tu equipo.

## VS Code

**Añadir a VS Code** abre el aviso de instalación de VS Code. También puedes ejecutar `code --add-mcp`, o hacer commit de `.vscode/mcp.json` para que todo el que trabaje en el proyecto tenga el servidor.

### Sin cuenta

[Instalar en VS Code](https://vscode.dev/redirect/mcp/install?name=deepwiki&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.deepwiki.com%2Fmcp%22%7D)

O desde un terminal:

```
code --add-mcp '{"name":"deepwiki","type":"http","url":"https://mcp.deepwiki.com/mcp"}'
```

O haz commit del archivo en el repositorio como `.vscode/mcp.json`:

`.vscode/mcp.json`:

```
{
  "servers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}
```

### Requiere cuenta

[Instalar en VS Code](https://vscode.dev/redirect/mcp/install?name=notion&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.notion.com%2Fmcp%22%7D)

O desde un terminal:

```
code --add-mcp '{"name":"notion","type":"http","url":"https://mcp.notion.com/mcp"}'
```

O haz commit del archivo en el repositorio como `.vscode/mcp.json`:

`.vscode/mcp.json`:

```
{
  "servers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

VS Code te pide iniciar sesión la primera vez que se inicia el servidor.

### Clave de API

Añádelo a `.vscode/mcp.json`. VS Code pide la clave la primera vez y la guarda de forma segura:

`.vscode/mcp.json`:

```
{
  "servers": {
    "example": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "api-key",
      "description": "API key",
      "password": true
    }
  ]
}
```

### Local

[Instalar en VS Code](https://vscode.dev/redirect/mcp/install?name=memory&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-memory%22%5D%7D)

O desde un terminal:

```
code --add-mcp '{"name":"memory","type":"stdio","command":"npx","args":["-y","@modelcontextprotocol/server-memory"]}'
```

O haz commit del archivo en el repositorio como `.vscode/mcp.json`:

`.vscode/mcp.json`:

```
{
  "servers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
```

Necesita Node.js en tu equipo.

## Otros clientes

### Devin Desktop (antes Windsurf)

### Sin cuenta

1. Añádelo a `~/.config/devin/mcp_config.json` (macOS y Linux) o a `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```
{
  "mcpServers": {
    "deepwiki": {
      "serverUrl": "https://mcp.deepwiki.com/mcp"
    }
  }
}
```

2. Actualiza la lista de servidores MCP en Cascade.

Devin Desktop es el nuevo nombre de Windsurf. Para los servidores remotos lee `serverUrl` (o `url`).

### Requiere cuenta

1. Añádelo a `~/.config/devin/mcp_config.json` (macOS y Linux) o a `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```
{
  "mcpServers": {
    "notion": {
      "serverUrl": "https://mcp.notion.com/mcp"
    }
  }
}
```

2. Actualiza la lista de servidores MCP en Cascade e inicia sesión cuando te lo pida.

Devin Desktop es el nuevo nombre de Windsurf. Para los servidores remotos lee `serverUrl` (o `url`).

### Clave de API

1. Añádelo a `~/.config/devin/mcp_config.json` (macOS y Linux) o a `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```
{
  "mcpServers": {
    "example": {
      "serverUrl": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

2. Actualiza la lista de servidores MCP en Cascade.

Devin Desktop es el nuevo nombre de Windsurf. Para los servidores remotos lee `serverUrl` (o `url`).

### Local

1. Añádelo a `~/.config/devin/mcp_config.json` (macOS y Linux) o a `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
```

2. Actualiza la lista de servidores MCP en Cascade.

Devin Desktop es el nuevo nombre de Windsurf.

### Codex

### Sin cuenta

```
codex mcp add deepwiki --url https://mcp.deepwiki.com/mcp
```

O edita directamente `~/.codex/config.toml`:

`config.toml`:

```
[mcp_servers.deepwiki]
url = "https://mcp.deepwiki.com/mcp"
```

### Requiere cuenta

```
codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notion
```

O edita directamente `~/.codex/config.toml`:

`config.toml`:

```
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
```

### Clave de API

```
codex mcp add example --url https://mcp.example.com/mcp --bearer-token-env-var EXAMPLE_API_KEY
```

O edita directamente `~/.codex/config.toml`:

`config.toml`:

```
[mcp_servers.example]
url = "https://mcp.example.com/mcp"
bearer_token_env_var = "EXAMPLE_API_KEY"
```

Asigna tu clave a `EXAMPLE_API_KEY` en el shell que ejecuta Codex.

### Local

```
codex mcp add memory -- npx -y @modelcontextprotocol/server-memory
```

O edita directamente `~/.codex/config.toml`:

`config.toml`:

```
[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]
```

Necesita Node.js en tu equipo.

### Gemini CLI

### Sin cuenta

```
gemini mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp
```

Así lo añades al proyecto actual. Añade `-s user` para usarlo en todas partes.

### Requiere cuenta

```
gemini mcp add --transport http notion https://mcp.notion.com/mcp
```

Después, dentro de Gemini CLI, ejecuta `/mcp auth notion` para iniciar sesión.

Así lo añades al proyecto actual. Añade `-s user` para usarlo en todas partes.

### Clave de API

```
gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" example https://mcp.example.com/mcp
```

Así lo añades al proyecto actual. Añade `-s user` para usarlo en todas partes.

### Local

```
gemini mcp add memory npx -- -y @modelcontextprotocol/server-memory
```

Así lo añades al proyecto actual. Añade `-s user` para usarlo en todas partes.

### Cualquier otro cliente

### Sin cuenta

La mayoría de los clientes aceptan esta forma. Algunos llaman de otra manera al campo de la URL: `serverUrl` en Devin Desktop, `httpUrl` en el archivo de ajustes de Gemini CLI.

```
{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}
```

Zed pone los servidores bajo `context_servers` en sus ajustes. Cline necesita `"type": "streamableHttp"`; si no, supone SSE.

¿Tu cliente solo inicia servidores locales? Conéctalo con `npx -y mcp-remote https://mcp.deepwiki.com/mcp`.

### Requiere cuenta

La mayoría de los clientes aceptan esta forma. Algunos llaman de otra manera al campo de la URL: `serverUrl` en Devin Desktop, `httpUrl` en el archivo de ajustes de Gemini CLI.

```
{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

Zed pone los servidores bajo `context_servers` en sus ajustes. Cline necesita `"type": "streamableHttp"`; si no, supone SSE.

¿Tu cliente solo inicia servidores locales? Conéctalo con `npx -y mcp-remote https://mcp.notion.com/mcp`.

### Clave de API

La mayoría de los clientes aceptan esta forma. Algunos llaman de otra manera al campo de la URL: `serverUrl` en Devin Desktop, `httpUrl` en el archivo de ajustes de Gemini CLI.

```
{
  "mcpServers": {
    "example": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

Zed pone los servidores bajo `context_servers` en sus ajustes. Cline necesita `"type": "streamableHttp"`; si no, supone SSE.

¿Tu cliente solo inicia servidores locales? Conéctalo con `npx -y mcp-remote https://mcp.example.com/mcp`.

### Local

La mayoría de los clientes que inician servidores locales aceptan esta forma:

```
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
```

Zed pone los servidores bajo `context_servers` en sus ajustes, con los mismos campos `command`, `args` y `env`.

Necesita Node.js en tu equipo.

## Inicio de sesión, claves de API y servidores locales

### Inicio de sesión (OAuth)

La primera vez que tu cliente se conecta, el servidor pregunta quién eres. Tu cliente abre la página de inicio de sesión del proveedor en un navegador, allí autorizas el acceso y el cliente guarda el token. En Claude Code eso ocurre con `/mcp` y **Authenticate**, en Cursor con **Needs authentication** en sus ajustes de MCP, en Codex con `codex mcp login` y en Gemini CLI con `/mcp auth`.

El token se emite para la URL propia del servidor, y tu cliente solo lo envía allí: el inicio de sesión de MCP vincula cada token a un único servidor (indicadores de recurso OAuth, RFC 8707). Es uno de los motivos por los que cada configuración en mcp.tc usa la URL propia del servidor, y por los que mcp.tc nunca ve tus credenciales.

### Clave de API

Consigue una clave del proveedor. Los fragmentos ponen un marcador como `<YOUR_API_KEY>` en la cabecera que espera el servidor, casi siempre `Authorization: Bearer <YOUR_API_KEY>`. Sustitúyelo en tu propia configuración y mantén ese archivo fuera de los repositorios compartidos. VS Code pide la clave la primera vez y la guarda de forma segura, y Codex la lee de una variable de entorno. En claude.ai y Claude Desktop, añade la clave en **Request headers** al crear el conector personalizado. ChatGPT no puede enviar una cabecera de clave.

Algunos servidores funcionan sin clave y aceptan una para dar más acceso. Su insignia dice **Cuenta opcional**, sus comandos no incluyen la clave y la nota bajo los pasos indica la cabecera en la que enviarla.

### Servidores locales

Tu cliente inicia un servidor local como un programa en tu equipo, con el comando de instalación de su página. El comando determina lo que necesitas tener instalado:

- `npx` requiere Node.js.
- `uvx` requiere uv (Python).
- `pipx` requiere pipx (Python).
- `docker` requiere Docker.
- `dnx` requiere .NET 10.

Un servidor local se ejecuta con los permisos de tu cuenta de usuario, así que lee su lista de herramientas antes de añadirlo. Los ajustes que necesita, claves incluidas, son variables de entorno, y los fragmentos los muestran como marcadores. claude.ai y ChatGPT solo se conectan a servidores remotos, así que no pueden usar los locales.

### Acceso sin confirmar

Un anillo gris y **Acceso sin confirmar** significan que nuestra comprobación no pudo saber si el servidor requiere iniciar sesión. Los pasos usan la URL sin más. Si el servidor pide credenciales, la documentación de su proveedor dice cuáles.

## Qué hace un enlace de mcp.tc en un cliente

El enlace de mcp.tc es la página de la ficha, no la dirección de un servidor. Un navegador recibe la página. Un cliente MCP que se conecta a él recibe en cambio un error: HTTP 409 con un mensaje JSON-RPC que indica la URL propia del servidor (o, para un servidor local, su comando de instalación) y la página. Algunos clientes muestran el mensaje, así que puedes copiar de ahí la dirección correcta; Claude Code solo informa «Failed to connect». Esta es la respuesta que recibe un cliente en `mcp.tc/i/deepwiki` (el mensaje siempre está en inglés, el idioma que esperan los clientes):

`HTTP 409, application/json`:

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "mcp.tc: this link is a page, not an MCP endpoint. Connect to DeepWiki directly with its own URL: https://mcp.deepwiki.com/mcp (no sign-in needed). Setup for each client: https://mcp.tc/i/deepwiki",
    "data": {
      "listing": "https://mcp.tc/i/deepwiki",
      "endpoint": "https://mcp.deepwiki.com/mcp"
    }
  }
}
```

`data.endpoint` contiene la URL propia del servidor, `data.command` el comando de instalación de un servidor local y `data.listing` la página. Un enlace que no está en el directorio responde 404, y una ficha retirada responde 410.

¿Por qué el enlace no envía tu cliente al servidor, ni reenvía las solicitudes? Los SDK de MCP actuales (TypeScript 1.32 y posteriores, Python 1.30 y posteriores) se niegan a ser enviados a otro sitio, y de todos modos un token de inicio de sesión solo funciona en la URL propia del servidor. Reenviar las solicitudes también haría que tu cliente dependiera de mcp.tc, así que cada enlace de mcp.tc es solo una página.

## Solución de problemas

### Mi cliente dice «this link is a page, not an MCP endpoint»

Añadiste el enlace de mcp.tc. Sustitúyelo por la URL de ese mensaje, o copia la URL del recuadro de arriba de la ficha. Para un servidor local, usa en su lugar el comando de instalación.

### El servidor no se conecta

Si la URL que añadiste empieza por `https://mcp.tc/i/`, es el enlace de la página: sustitúyela por la URL propia del servidor que aparece en la ficha. Si no, comprueba que la URL coincide exactamente con la de la ficha, ruta incluida: `https://mcp.deepwiki.com/mcp` y `https://mcp.deepwiki.com` son direcciones distintas. Reinicia el cliente después de editar un archivo de configuración. Una insignia **Falló la última comprobación** en la ficha significa que nuestras comprobaciones diarias también fallan, así que el problema puede estar en el proveedor.

### No para de pedirme que inicie sesión, o responde 401

El servidor requiere iniciar sesión y tu cliente no lo ha completado. En Claude Code, escribe `/mcp`, elige el servidor y selecciona **Authenticate**. En Cursor, abre los ajustes de MCP y usa el botón junto a **Needs authentication**. En Codex, ejecuta `codex mcp login` con el nombre del servidor, y en Gemini CLI `/mcp auth`. Con una clave de API, comprueba que sustituiste el marcador y que la cabecera coincide con la documentación del proveedor.

### Un servidor local no arranca

Ejecuta primero su comando de instalación en un terminal. Si falla ahí, el cliente tampoco puede iniciarlo, y normalmente falta el entorno de ejecución: Node.js para `npx`, uv para `uvx`, Docker para `docker`. Sustituye cada marcador, como `<YOUR_API_KEY>` o `/path/to/allowed/dir`, por un valor real.

### Mi cliente solo inicia servidores locales

Conecta el servidor remoto con `npx -y mcp-remote` seguido de la URL propia del servidor. El puente se ejecuta en tu equipo y requiere Node.js.

### La ficha dice SSE

El servidor usa el antiguo transporte SSE, que algunos clientes ya no admiten. Claude Code acepta `--transport sse`, VS Code `"type": "sse"`, y Codex necesita el puente `mcp-remote`. Los pasos de configuración de la ficha ya usan el correcto.

### Las herramientas de un servidor cambiaron después de añadirlo

Abre su ficha y mira la pestaña **Historial**. Cuando podemos leer las herramientas del servidor, lista las añadidas, eliminadas o modificadas desde nuestra primera lectura, con cada descripción antes y después. Puede que tu cliente siga usando la lista que aprobaste antes, así que compárala con lo que muestra ahora. Para recibir un correo con el próximo cambio, inicia sesión y pulsa **Seguir** en la ficha.

### Algo de la ficha está mal

Usa **Reportar esta ficha** en su página. El texto se escribe con ayuda de IA a partir de los metadatos del propio servidor, así que hay errores, y una persona lee cada reporte.

---
Fuente: https://mcp.tc/es/docs/connect. Versión Markdown para agentes de IA (pide `text/markdown` o añade `.md` a la dirección). Resumen del sitio: https://mcp.tc/llms.txt
