---
title: Conéctate con un token de API
description: >-
  El camino para CLIs, pipelines de CI y configuraciones sin interfaz gráfica.
  Crea un token con permisos limitados en Ali y pégalo en un comando de
  instalación o en un archivo de configuración.
sidebar:
  icon: key
---
Un token de API es un secreto estático que identifica tu cuenta ante el servidor MCP. Úsalo cuando no hay un navegador para ejecutar el flujo de OAuth: un pipeline de CI, un servidor, un script, o cualquier cliente que solo sabe enviar un encabezado.

Abre **Connect MCP**, quédate en la pestaña **Connect** y elige **Terminal or config file**.

![La pestaña Connect con el método de terminal seleccionado, mostrando el comando de instalación y el archivo de configuración](/images/mcp/terminal-steps.webp)

Al igual que con el flujo de OAuth, primero elige tu cliente en la fila **Editor**. El comando de instalación y el fragmento de configuración de abajo se reescriben para el cliente que elegiste, incluyendo la ruta de su archivo de configuración.

## Crea el token

Presiona **Create token** en el primer paso. El panel te pide tres cosas.

![El panel de nuevo token de API, con un nombre, una fecha de expiración y permisos por recurso](/images/mcp/new-token.webp)

**Name.** Algo que reconozcas en seis meses. "CI pipeline" o "Laptop de Claude Code" es mejor que "token 3".

**Expires.** Treinta días, noventa días, o nunca. Prefiere una fecha de expiración real para cualquier cosa que viva en una laptop. Reserva **Never** para infraestructura que realmente monitoreas.

**Permissions.** Una fila por recurso, cada una configurada como **No access**, **Read** o **Edit**. Todo empieza en Read. Desactiva lo que el cliente no vaya a necesitar, y solo sube una fila a Edit cuando el cliente realmente tenga que cambiar datos. Dashboard es la única excepción: es una superficie de solo lectura, así que se queda en read incluso si configuras la fila como Edit.

Presiona **Create token** y Ali te lo muestra una sola vez.

![El panel de token listo, con el secreto y los fragmentos listos para pegar](/images/mcp/token-ready.webp)

:::warning[Cópialo ahora]
El secreto se muestra exactamente una vez, justo después de crearlo. Ali guarda un hash, no el token, así que nadie puede recuperarlo después, ni siquiera soporte. Si lo pierdes, revoca el token y crea otro.
:::

Ese mismo panel ya trae los dos fragmentos que necesitas, con el token ya incluido, además de un selector de **Editor** para que puedas cambiar entre clientes sin volver a la pantalla anterior.

## Instálalo

El primer fragmento es un comando de instalación de una línea para el cliente que elegiste:

```bash Terminal
claude mcp add ali --transport http --header="Mcp-Authorization:<YOUR_API_TOKEN>" https://api.ali-space.com/mcp
```

Cambia `claude` por `cursor`, `windsurf` u `openrouter` si estás configurando alguno de esos, y reemplaza `<YOUR_API_TOKEN>` con el token que acabas de copiar. El panel hace esa sustitución por ti cuando copias desde la pantalla de token listo.

Si prefieres editar la configuración a mano, el segundo fragmento es lo mismo en JSON:

```json ~/.claude.json
{
  "mcpServers": {
    "ali": {
      "url": "https://api.ali-space.com/mcp",
      "headers": {
        "Mcp-Authorization": "<YOUR_API_TOKEN>"
      }
    }
  }
}
```

El archivo vive en un lugar diferente para cada cliente. Ali muestra la ruta correcta arriba del fragmento:

| Client | Config file |
| --- | --- |
| Claude y Claude Code | `~/.claude.json` |
| Cursor | `~/.cursor/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| OpenRouter | `~/.openrouter/mcp.json` |

Reinicia el cliente después de editar el archivo a mano. El comando de instalación no necesita reinicio.

:::tip
En CI, no pegues el token en el archivo de configuración. Ponlo en un secreto e inyéctalo como variable de entorno, luego arma el encabezado a partir de esa variable.
:::

## Gestión de tokens

Cada token que creaste vive en la pestaña **API tokens**.

![La pestaña API tokens, con dos tokens activos listados junto con sus accesos](/images/mcp/tokens.webp)

Cada tarjeta muestra el nombre, el prefijo del secreto para que puedas distinguir los tokens entre sí, cuándo expira, cuándo se usó por última vez, y los recursos que puede leer y editar. **New token** en la esquina superior derecha abre el mismo panel.

El menú a la derecha de una tarjeta revoca el token. Un token revocado deja de funcionar de inmediato y se queda en la lista, marcado como revocado, para que conserves el registro de lo que existió.

Una tarjeta que dice "never used" semanas después de haberla creado merece una segunda mirada. O el cliente nunca se conectó, o se conectó con un token diferente.

## A dónde ir ahora

<CardGroup cols={2}>
  <Card title="Conéctate con OAuth" href="/mcp/oauth" icon="zap">
    El camino de un solo clic, para cualquier cosa con un panel de conector.
  </Card>
  <Card title="Permisos" href="/mcp/permissions" icon="shield">
    Qué cubren read y edit, recurso por recurso.
  </Card>
</CardGroup>