🤖 Integração de IA — Conectar Claude e ChatGPT

Passo a passo: conectar Claude, ChatGPT e Claude Code CLI com a tua conta sTraderZ.com

Neste Capítulo

1 Requisitos 2 Conectar Claude (claude.ai) 3 Conectar ChatGPT (Custom GPT) 4 Conectar Claude Code CLI 5 Ferramentas disponíveis (Referência)

1. Requisitos

A integração de IA está disponível a partir do plano Basic (não no plano gratuito). Conectas o teu cliente de IA com a tua conta sTraderZ.com via OAuth — o cliente obtém então apenas acesso de leitura aos teus dados de trading.

Endpoint MCP

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

⚠️ O URL deve ser exatamente este — com .php, sem barra no final.

💎

A partir do plano Basic

Não disponível no plano gratuito.

👁️

Apenas leitura

Scope read — sem execução de trades.

🔓

Revogável a qualquer momento

Página de conta «Integrações de IA».

Na primeira ligação abre-se um diálogo de autorização. Aí confirmas o scope read (acesso de leitura). As ligações existentes podem ser consultadas e revogadas a qualquer momento na página de conta Integrações de IA.

2. Conectar Claude (claude.ai)

🤖

Claude · claude.ai

Conector MCP

Abrir claude.ai → Settings → Integrations → Add more
No campo «MCP Server URL» inserir: https://straderz.com/api/mcp.php
Clicar em Connect → o browser abre a página de login/consentimento do sTraderZ.com
Confirmar o scope read (acesso de leitura às 10 ferramentas)
De volta no claude.ai o servidor aparece como ativo → testar no chat: «Mostra-me os meus últimos 5 trades»

Importante: O URL deve ser exatamente https://straderz.com/api/mcp.php (com .php, sem barra no final).

3. Conectar ChatGPT (Custom GPT)

💬

ChatGPT · Custom GPT

OpenAPI Actions

Os Custom GPT do ChatGPT utilizam OpenAPI/Actions (não MCP/JSON-RPC). Para isso existe um adaptador REST separado — o endpoint MCP para Claude não é afetado.

Abrir ChatGPT → Explore GPTs → Create → separador Configure → Add actions
No campo «Schema» inserir o URL: https://straderz.com/api/mcp-openapi-schema.php → ChatGPT importa o schema automaticamente (todas as 10 ferramentas aparecem como Actions)
Authentication → OAuth → inserir os seguintes valores:
- Client ID + Secretcopiar da página de administração do sTraderZ
- Authorization URLhttps://straderz.com/oauth/authorize.php
- Token URLhttps://straderz.com/oauth/token.php
- Scoperead
Guardar → testar no chat do GPT: «Mostra-me os meus últimos 5 trades»

Nota: As Actions do ChatGPT requerem uma conta verificada em platform.openai.com.

4. Conectar Claude Code CLI

💻

Claude Code CLI

Servidor MCP local

Configuração em ~/.claude/settings.json (ou localmente no projeto em .claude/settings.json):

settings.json

{"mcpServers":{"straderz":{"type":"http","url":"https://straderz.com/api/mcp.php","headers":{"Authorization":"Bearer <o-teu-access-token>"}}}}

Obter o token: Abrir no browser https://straderz.com/oauth/authorize.php?client_id=...&scope=read e completar o fluxo OAuth. O token é válido 90 dias (renovação pela página de conta).

Verificação no terminal:

bash

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

Exemplo de utilização:

bash

claude "Qual é o meu lucro realizado em 2025?"

5. Ferramentas disponíveis (Referência)

✅ 10 ferramentas de leitura · apenas scope read

Todas as ferramentas são exclusivamente de leitura (scope read). Sem execução de trades, sem mutações no broker.

Ferramenta	Scope	Descrição
`list_accounts`	read	Todas as contas de broker vinculadas
`get_portfolio_overview`	read	Portfolio completo, posições, ganhos
`list_positions`	read	Posições abertas por conta
`list_trades`	read	Últimos N trades (com filtro)
`get_trade_detail`	read	Detalhes completos de um ciclo de trade
`get_performance`	read	Métricas de desempenho (período selecionável)
`get_tax_report`	read	Resumo do relatório fiscal (ano selecionável)
`get_cashflow`	read	Depósitos/levantamentos, depósito líquido, movimentos de caixa
`list_dividends`	read	Histórico de dividendos incl. retenção na fonte
`get_allocation`	read	Repartição por classe de ativos / setor / moeda