Agentes de código y editores

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.

“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 y ChatGPT.

Claude Code

Agrega el servidor:

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:

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

Cursor

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

{
  "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:

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

Codex

Agrega el servidor e inicia sesión:

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:

[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:

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

VS Code

Ejecuta MCP: Add Server desde la paleta de comandos y elige HTTP, o agrégalo a .vscode/mcp.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:

{
  "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}"
      }
    }
  }
}

OpenCode

Agrégalo a opencode.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:

{
  "$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}"
      }
    }
  }
}

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):

{
  "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.

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.

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.