Configurar seu cliente

Cada aplicativo chama a mesma coisa por um nome diferente — conector, servidor MCP, MCP server. Abaixo está onde fica esse campo em cada um, e o que colar nele.

O que você vai precisar

Em todos os casos, o dado principal é o endereço do servidor:

https://api.path-trader.com.br/mcp

• Claude, Cursor, VS Code, Gemini CLI e Antigravity entendem OAuth: cole só o endereço e autorize na tela que abrir. Nada de token.
• Claude Code e ChatGPT também aceitam o endereço direto; se o seu preferir token, crie um em Integrações.

Instalar com um clique

No Cursor e no VS Code você não precisa colar nada: o botão abre o editor já com o servidor preenchido. Depois é só autorizar.

Onde fica o campo em cada aplicativo

Claude

Vale para o aplicativo de computador e para o Claude no navegador. É o caminho mais simples: sem token, sem arquivo de configuração.

1. 1

   Abra as configurações

   No aplicativo, use Ctrl+, (ou o menu no canto superior esquerdo → File → Settings). No navegador, use ⌘⇧, ou clique na sua foto de perfil → Settings.

2. 2

   Vá em Conectores

   Na barra lateral das configurações, clique em Connectors (Conectores). Aqui ficam as conexões que você já tem.

3. 3

   Adicione um conector personalizado

   Botão Add no canto superior direito → Add custom connector. Vai abrir uma caixa pedindo a URL do servidor.

4. 4

   Cole o endereço e confirme

   Cole https://api.path-trader.com.br/mcp e clique em Add.

5. 5

   Autorize

   O Claude abre a tela de autorização do Path Trader. Confira o que a conexão poderá fazer e clique em Autorizar.

Claude Code

Um comando no terminal, de dentro de qualquer projeto:

claude mcp add --transport http path-trader https://api.path-trader.com.br/mcp

Prefere usar token em vez de autorizar pelo navegador? Acrescente o cabeçalho:

claude mcp add --transport http path-trader https://api.path-trader.com.br/mcp \
  --header "Authorization: Bearer ptmcp_..."

Cursor

1. 1

   Abra a página Customize

   Na barra lateral do Cursor, vá em Customize e procure a seção de MCP.

2. 2

   Adicione um servidor

   Informe um nome (por exemplo path-trader) e a URL https://api.path-trader.com.br/mcp.

3. 3

   Autorize

   O Cursor abre o navegador na tela de autorização do Path Trader.

Se preferir editar o arquivo, use ~/.cursor/mcp.json (vale para tudo) ou .cursor/mcp.json (só naquele projeto):

{
  "mcpServers": {
    "path-trader": {
      "url": "https://api.path-trader.com.br/mcp"
    }
  }
}

VS Code

1. 1

   Abra a paleta de comandos

   ⇧⌘P no macOS, Ctrl+Shift+P no Windows e Linux.

2. 2

   Rode MCP: Add Server

   Digite MCP: Add Server e escolha o tipo de servidor HTTP quando ele perguntar.

3. 3

   Informe o endereço

   Cole https://api.path-trader.com.br/mcp e dê um nome à conexão.

O comando grava em .vscode/mcp.json no projeto. Para valer em todos os projetos, use MCP: Open User Configuration. O conteúdo é este:

{
  "servers": {
    "path-trader": {
      "type": "http",
      "url": "https://api.path-trader.com.br/mcp"
    }
  }
}

Gemini CLI

Configurado por arquivo: ~/.gemini/settings.json para valer em tudo, ou .gemini/settings.json dentro de um projeto.

{
  "mcpServers": {
    "path-trader": {
      "httpUrl": "https://api.path-trader.com.br/mcp"
    }
  }
}

Na primeira vez que você usar uma ferramenta do Path Trader, o Gemini CLI abre o navegador para você autorizar.

Antigravity

1. 1

   Abra as configurações de MCP

   Configurações → Customizations → Installed MCP Servers → botão Add MCP.

2. 2

   Informe o endereço

   Cole https://api.path-trader.com.br/mcp como servidor e salve.

3. 3

   Autorize

   O Antigravity registra a conexão sozinho e abre a tela de autorização do Path Trader.

Se preferir o arquivo, use ~/.gemini/config/mcp_config.json (global) ou .agents/mcp_config.json (por workspace):

{
  "mcpServers": {
    "path-trader": {
      "serverUrl": "https://api.path-trader.com.br/mcp"
    }
  }
}

ChatGPT

1. 1

   Ative o modo desenvolvedor

   Em Configurações → Segurança, ligue o Modo desenvolvedor. Sem ele, conectores personalizados não aparecem.

2. 2

   Adicione o conector

   Na área de conectores, use o botão de adicionar e informe https://api.path-trader.com.br/mcp.

Testando a conexão

Se preferir confirmar antes de mexer no aplicativo, um token criado em Integrações pode ser testado direto do terminal:

curl -sX POST https://api.path-trader.com.br/mcp \
  -H 'Authorization: Bearer ptmcp_...' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Uma resposta com a lista de ferramentas significa que está tudo certo. 401 indica token inválido ou revogado; 403 indica que o plano da assinatura não é Pro.

Quando não funciona

Primeiras perguntas

• “Quais foram meus trades desta semana no Path Trader?”
• “Qual meu fator de lucro deste mês?”
• “Mostra minha curva de capital dos últimos 90 dias.”
• “Em qual dia da semana eu mais perco?”