---
title: "Agentes de código y editores"
description: "Conecta Claude Code, Codex, Cursor, VS Code, OpenCode y Windsurf al servidor MCP de TwexAPI iniciando sesión o con una API key."
---

Todos los clientes de abajo se conectan al mismo servidor, `https://api.twexapi.io/mcp`, mediante Streamable HTTP. La mayoría puede iniciar sesión con tu cuenta de TwexAPI: agregas solo la URL y el cliente abre el navegador para que apruebes el acceso. Usa una API key si el cliente no admite inicio de sesión MCP o si prefieres una key.

| Cliente | Iniciar sesión con TwexAPI | API key | Probado por TwexAPI |
| --- | --- | --- | --- |
| [Claude Code](#claude-code) | Sí | Sí | No |
| [Cursor](#cursor) | Sí | Sí | Sí |
| [Codex](#codex) | Sí | Sí | No |
| [VS Code](#vs-code) | Sí | Sí | No |
| [OpenCode](#opencode) | Sí | Sí | No |
| [Windsurf](#windsurf) | Sin confirmar | Sí | No |

"Probado" significa que ejecutamos el flujo completo, desde el inicio de sesión hasta una llamada a una herramienta, con ese cliente. Los demás métodos de inicio de sesión siguen el soporte de autorización MCP que documenta cada proveedor. Si el inicio de sesión falla, usa una API key. Para Claude.ai, Claude Desktop y ChatGPT, consulta la [descripción del servidor MCP](/mcp/overview#claude-ai-and-claude-desktop) y [ChatGPT](/mcp/chatgpt).

:::tip
  Guarda las API keys en variables de entorno, no en archivos de configuración que subas al repositorio. Crea una key en el [dashboard de TwexAPI](https://twexapi.io/dashboard).
:::

<a id="claude-code"></a>

## Claude Code

Agrega el servidor:

```bash
claude mcp add --transport http twexapi https://api.twexapi.io/mcp
```

Luego ejecuta `/mcp` en una sesión de Claude Code, elige `twexapi` y selecciona **Authenticate** para aprobar el acceso en el navegador. Agrega `--scope project` para compartir el servidor con tu equipo mediante `.mcp.json`; cada persona inicia sesión con su propia cuenta.

Para usar una API key, pon el header en `.mcp.json`. Claude Code expande `${TWEXAPI_API_KEY}` desde tu entorno:

```json
{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="cursor"></a>

## Cursor

Agrégalo a `~/.cursor/mcp.json` (todos los proyectos) o a `.cursor/mcp.json` (un proyecto):

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

Abre **Settings → MCP**. El servidor muestra **Needs authentication**. Selecciona **Authenticate**, aprueba el acceso en el navegador y permite que el navegador abra Cursor. El servidor queda listo cuando muestra tres herramientas activas.

Para usar una API key:

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="codex"></a>

## Codex

Agrega el servidor e inicia sesión:

```bash
codex mcp add twexapi --url https://api.twexapi.io/mcp
codex mcp login twexapi
codex mcp list
```

La CLI, la app y la extensión del IDE de Codex comparten la misma configuración en `~/.codex/config.toml`:

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
```

Para usar una API key, indica la variable de entorno que la contiene. Codex la envía como `Authorization: Bearer`:

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
bearer_token_env_var = "TWEXAPI_API_KEY"
```

<a id="vs-code"></a>

## VS Code

Ejecuta **MCP: Add Server** desde la paleta de comandos y elige **HTTP**, o agrégalo a `.vscode/mcp.json`:

```json
{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

Inicia el servidor y aprueba la solicitud de inicio de sesión que aparece en el navegador.

Para usar una API key, deja que VS Code te la pida una vez y la guarde de forma segura:

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "twexapi-key",
      "description": "TwexAPI API key",
      "password": true
    }
  ],
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${input:twexapi-key}"
      }
    }
  }
}
```

<a id="opencode"></a>

## OpenCode

Agrégalo a `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

OpenCode detecta que el servidor requiere inicio de sesión y abre el navegador. Si no lo hace, ejecuta `opencode mcp auth twexapi`. Revisa el estado con `opencode mcp list` y usa `opencode mcp debug twexapi` si la conexión falla.

Para usar una API key, desactiva el inicio de sesión automático:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="windsurf"></a>

## Windsurf

Todavía no hemos confirmado el inicio de sesión en Windsurf, así que usa una API key. Agrégala a `~/.codeium/windsurf/mcp_config.json` (abre este archivo desde el menú MCP de Cascade para ver la ubicación en tu versión):

```json
{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

## Otros clientes

Cualquier cliente que implemente la autorización MCP (OAuth 2.1 con PKCE y registro dinámico de clientes) puede iniciar sesión agregando solo la URL del servidor. Si no, envía tu API key con el header `x-api-key` o con `Authorization: Bearer YOUR_API_KEY`. Si estás creando tu propio cliente, consulta [OAuth para clientes MCP](/mcp/oauth).

## Comprueba la conexión

- El servidor muestra `explore`, `twexapi_request` y `twexapi_write`. `twexapi_write` no aparece si no tienes acceso de escritura.
- Pídele a tu agente: "Usa TwexAPI explore para encontrar endpoints de tendencias." `explore` no usa créditos, así que funciona antes de recargar.
- La nueva conexión aparece en **Authorized apps** (apps autorizadas) del [dashboard](https://twexapi.io/dashboard).

| Problema | Solución |
| --- | --- |
| `401` o "Needs authentication" | Vuelve a ejecutar el inicio de sesión del cliente (`/mcp` en Claude Code, **Authenticate** en Cursor, `codex mcp login` u `opencode mcp auth`). |
| La página de consentimiento dice que no tienes API key | Crea una key en el dashboard y vuelve a seleccionar **Approve** dentro de 10 minutos. |
| La página de consentimiento dice que no tienes créditos | Recarga y vuelve a seleccionar **Approve** dentro de 10 minutos. |
| Las llamadas a herramientas devuelven "No credits left on this TwexAPI account" | Recarga en el dashboard. La conexión en sí está bien. |
| Falta `twexapi_write` | Te conectaste en modo de solo lectura. Revoca la app en el dashboard y vuelve a conectarte dejando marcada la casilla de escritura. |

Cuando reportes un problema, incluye el nombre y la versión del cliente, la hora UTC y, si puedes verlo, el header de respuesta `X-Request-Id`.