7.7

🤖 Integración IA — Conectar Claude y ChatGPT

Paso a paso: conectar Claude, ChatGPT y Claude Code CLI con tu cuenta de sTraderZ.com

1. Requisitos

La integración de IA está disponible a partir del plan Basic (no en el plan gratuito). Conectas tu cliente de IA con tu cuenta de sTraderZ.com mediante OAuth — el cliente obtiene únicamente acceso de lectura a tus datos de trading.

Endpoint MCP
https://straderz.com/api/mcp.php

⚠️ La URL debe ser exactamente esta — con .php, sin barra al final.

💎

A partir del plan Basic

No disponible en el plan gratuito.

👁️

Solo lectura

Scope read — sin ejecución de trades.

🔓

Revocable en cualquier momento

Página de cuenta «Integraciones IA».

Al conectar por primera vez se abre un diálogo de autorización. Allí confirmas el scope read (acceso de lectura). Las conexiones existentes se pueden consultar y revocar en cualquier momento en la página de cuenta Integraciones IA.

2. Conectar Claude (claude.ai)

🤖
Claude · claude.ai
Conector MCP
  1. Abrir claude.ai → SettingsIntegrationsAdd more
  2. En el campo «MCP Server URL» introducir: https://straderz.com/api/mcp.php
  3. Hacer clic en Connect → el navegador abre la página de inicio de sesión/consentimiento de sTraderZ.com
  4. Confirmar el scope read (acceso de lectura a las 10 herramientas)
  5. De vuelta en claude.ai el servidor aparece como activo → probar en el chat: «Muéstrame mis últimos 5 trades»
Importante: La URL debe ser exactamente https://straderz.com/api/mcp.php (con .php, sin barra al final).

3. Conectar ChatGPT (Custom GPT)

💬
ChatGPT · Custom GPT
OpenAPI Actions

Los Custom GPT de ChatGPT usan OpenAPI/Actions (no MCP/JSON-RPC). Para ello existe un adaptador REST independiente — el endpoint MCP para Claude no se ve afectado.

  1. Abrir ChatGPT → Explore GPTsCreate → pestaña ConfigureAdd actions
  2. En el campo «Schema» introducir la URL: https://straderz.com/api/mcp-openapi-schema.php → ChatGPT importa el schema automáticamente (las 10 herramientas aparecen como Actions)
  3. Authentication → OAuth → introducir los siguientes valores:
    • Client ID + Secretcopiar desde la página de administración de sTraderZ
    • Authorization URLhttps://straderz.com/oauth/authorize.php
    • Token URLhttps://straderz.com/oauth/token.php
    • Scoperead
  4. Guardar → probar en el chat del GPT: «Muéstrame mis últimos 5 trades»
Nota: Las Actions de ChatGPT requieren una cuenta verificada en platform.openai.com.

4. Conectar Claude Code CLI

💻
Claude Code CLI
Servidor MCP local

Configuración en ~/.claude/settings.json (o localmente en el proyecto .claude/settings.json):

settings.json
{
  "mcpServers": {
    "straderz": {
      "type": "http",
      "url": "https://straderz.com/api/mcp.php",
      "headers": {
        "Authorization": "Bearer <tu-access-token>"
      }
    }
  }
}
Obtener el token: Abrir en el navegador https://straderz.com/oauth/authorize.php?client_id=...&scope=read y completar el flujo OAuth. Introducir el Access Token resultante en el archivo settings.json. Como Claude Code admite servidores MCP HTTP con Bearer Tokens estáticos, no se necesita ningún comando de autenticación CLI adicional. El token es válido 90 días (renovación desde la página de cuenta).

Verificación en el terminal:

bash
claude mcp list
# → straderz: https://straderz.com/api/mcp.php (connected)

Ejemplo de uso:

bash
claude "¿Cuál es mi ganancia realizada en 2025?"

5. Herramientas disponibles (Referencia)

✅ 10 herramientas de lectura · solo scope read

Todas las herramientas son exclusivamente de lectura (scope read). Sin ejecución de trades, sin mutaciones en el broker.

HerramientaScopeDescripción
list_accountsreadTodas las cuentas de broker vinculadas
get_portfolio_overviewreadPortfolio completo, posiciones, ganancias
list_positionsreadPosiciones abiertas por cuenta
list_tradesreadÚltimos N trades (con filtro)
get_trade_detailreadDetalles completos de un ciclo de trade
get_performancereadMétricas de rendimiento (período seleccionable)
get_tax_reportreadResumen del informe fiscal (año seleccionable)
get_cashflowreadIngresos/retiros, depósito neto, movimientos de efectivo
list_dividendsreadHistorial de dividendos incl. retención fiscal
get_allocationreadDesglose por clase de activo / sector / divisa