> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración de MCP en Claude Code

> Configuración del MCP remoto nativo, autorización en el navegador, verificación de herramientas y solución de problemas

Esta página trata el MCP nativo en Claude Code. El servicio remoto usa Streamable HTTP y OAuth en el navegador, sin necesidad de EvoLink CLI. Para ejecutar comandos y habilidades, usa la [guía de la CLI](https://evolink.ai/docs/es/cli/claude-code.md), que es independiente.

## Conecta el MCP remoto

Para las herramientas nativas, usa **Streamable HTTP + OAuth** con esta URL del servidor:

```text theme={null}
https://mcp.evolink.ai/mcp
```

No hace falta instalar la CLI. Haz una copia de seguridad de la configuración existente, fusiona solo EvoLink y conserva los demás servicios. Elige entre el registro mediante comandos y el registro manual.

**1. Añade el servidor HTTP**

En una terminal que tenga Claude Code instalado, ejecuta:

```bash theme={null}
claude mcp add --transport http --scope user evolink https://mcp.evolink.ai/mcp
```

`--scope user` hace que esta conexión esté disponible en todos los proyectos del usuario actual. Añadirla solo confirma que la configuración se ha escrito.

**2. Inicia sesión dentro de Claude Code**

En la conversación de Claude Code, introduce el siguiente comando de sesión y selecciona la opción de autenticación de EvoLink:

```text theme={null}
/mcp
```

Completa el inicio de sesión y la autorización en el navegador, y después comprueba la conexión en Claude Code. Este comando de sesión no es un comando normal de shell.

**3. Comprueba las herramientas y verifica gratis**

```bash theme={null}
claude mcp list
```

Si se te pide, aprueba dentro de Claude Code la conexión de proyecto pendiente. En una sesión nueva, envía el prompt de verificación de más abajo y confirma que recibes el saldo y los modelos reales.

Para la configuración de proyecto, fusiona esto en `.mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "evolink": {
      "type": "http",
      "url": "https://mcp.evolink.ai/mcp"
    }
  }
}
```

No pongas este bloque en `.claude/settings.local.json`; el comando anterior gestiona el ámbito de usuario. Consulta la [documentación de Claude Code](https://code.claude.com/docs/en/mcp).

Tras la autorización, envía esto en el chat del agente:

```text theme={null}
Usa EvoLink para consultar el saldo de mi cuenta y buscar los modelos de imagen disponibles. No generes nada todavía.
```

**Éxito**: las llamadas reales a `check_balance` y `search_models` devuelven resultados. Verifica estas herramientas en la conexión MCP real.

## Actualizaciones, desconexión y solución de problemas

EvoLink se encarga de actualizar el servidor MCP alojado. Después de cambiar la configuración, vuelve a cargar la sesión real del cliente. Cuando haga falta, vuelve a autorizar con la opción de OAuth de ese cliente. Para desconectar, desactiva EvoLink, cierra sesión o elimínalo en la configuración de MCP del host; conserva los demás servidores.

| Síntoma | Acción |
| - | - |
| La URL está añadida, pero no hay herramientas | Activa la conexión, completa la autorización, vuelve a cargar la sesión y comprueba la política de la organización |
| 401 o se requiere autenticación | Vuelve a autorizar esta conexión MCP y conserva los identificadores de las tareas originales |
| 403 o herramienta denegada | Comprueba los permisos del host, el estado de la cuenta y de la clave, y los errores de red |
| Tiempo de espera agotado o respuesta perdida | Consulta y recupera la operación original en lugar de volver a generar |
| Solo aparece un enlace o la vista previa está gris | Abre y entrega el original sin rehacerlo automáticamente |

Consulta [Costos, acceso y solución de problemas de MCP](https://evolink.ai/docs/es/mcp/billing.md#faq). Lee el [flujo de trabajo de creación](https://evolink.ai/docs/es/mcp/overview.md#workflows) antes de enviar; el formato de las llamadas está en la [referencia de herramientas de MCP](https://evolink.ai/docs/es/mcp/tools.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.