# Configurar seu cliente

> Onde fica o campo de servidor MCP em cada aplicativo, passo a passo.

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:

```text
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](/docs/ia/mcp/tokens).

## 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.

- [Instalar no Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=path-trader&config=eyJ1cmwiOiJodHRwczovL2FwaS5wYXRoLXRyYWRlci5jb20uYnIvbWNwIn0=): Abre o Cursor e adiciona o Path Trader aos servidores MCP.
- [Instalar no VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=path-trader&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.path-trader.com.br%2Fmcp%22%7D): Abre o VS Code e adiciona o Path Trader aos servidores MCP.

> **Nota:** Nos outros aplicativos ainda é preciso informar o endereço manualmente — o passo a passo de cada um está abaixo.

## Onde fica o campo em cada aplicativo

| Aplicativo | Caminho até o campo |
| :-- | :-- |
| Claude (aplicativo e navegador) | Configurações → **Conectores** → **Adicionar** → *Adicionar conector personalizado* |
| Claude Code | Pelo terminal, com `claude mcp add` |
| Cursor | Barra lateral → **Customize** → MCP, ou o arquivo `~/.cursor/mcp.json` |
| VS Code | Paleta de comandos → **MCP: Add Server**, ou o arquivo `.vscode/mcp.json` |
| Gemini CLI | O arquivo `~/.gemini/settings.json` |
| Antigravity | Configurações → **Customizations** → *Installed MCP Servers* → **Add MCP** |
| ChatGPT | Configurações → **Segurança** → ativar *Modo desenvolvedor* → conectores |

> **Cada um chama a chave de um jeito:** Ao editar o arquivo de configuração à mão, repare no nome do campo da URL: é `url` no Cursor e no VS Code, `httpUrl` no Gemini CLI e `serverUrl` no Antigravity. Usar o nome errado faz o cliente ignorar o servidor sem dar erro.

> **Nota:** Esses menus mudam com frequência. Se algo não estiver onde descrevemos, procure por “conectores” ou “MCP” nas configurações do aplicativo — o campo é sempre um só, o endereço do servidor.

## 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. **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. **Vá em Conectores**
   Na barra lateral das configurações, clique em **Connectors** (Conectores). Aqui ficam as conexões que você já tem.
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. **Cole o endereço e confirme**
   Cole `https://api.path-trader.com.br/mcp` e clique em *Add*.
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**.

> **Escolha quais ferramentas liberar:** Depois de conectar, abra o conector nas configurações do Claude para ligar e desligar ferramentas individualmente — útil se você quer leitura mas não quer que ele apague nada.

## Claude Code

Um comando no terminal, de dentro de qualquer projeto:

```bash
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:

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

## Cursor

1. **Abra a página Customize**
   Na barra lateral do Cursor, vá em **Customize** e procure a seção de MCP.
2. **Adicione um servidor**
   Informe um nome (por exemplo `path-trader`) e a URL `https://api.path-trader.com.br/mcp`.
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):

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

## VS Code

1. **Abra a paleta de comandos**
   `⇧⌘P` no macOS, `Ctrl+Shift+P` no Windows e Linux.
2. **Rode MCP: Add Server**
   Digite `MCP: Add Server` e escolha o tipo de servidor HTTP quando ele perguntar.
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:

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

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

> **Atenção:** Aqui a chave é `httpUrl`, não `url`. Com `url` o Gemini CLI trata o servidor como SSE e a conexão não sobe.

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

## Antigravity

1. **Abra as configurações de MCP**
   **Configurações** → **Customizations** → *Installed MCP Servers* → botão **Add MCP**.
2. **Informe o endereço**
   Cole `https://api.path-trader.com.br/mcp` como servidor e salve.
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):

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

## ChatGPT

1. **Ative o modo desenvolvedor**
   Em **Configurações → Segurança**, ligue o *Modo desenvolvedor*. Sem ele, conectores personalizados não aparecem.
2. **Adicione o conector**
   Na área de conectores, use o botão de adicionar e informe `https://api.path-trader.com.br/mcp`.

> **Atenção:** Conectores personalizados não estão disponíveis em todos os planos do ChatGPT, e a OpenAI muda esse requisito com frequência. Se a opção não aparecer nem com o modo desenvolvedor ligado, o seu plano provavelmente não a inclui.

## Testando a conexão

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

```bash
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

| Sintoma | Causa provável |
| :-- | :-- |
| O aplicativo diz que não encontrou o servidor | Endereço incompleto. Precisa terminar em `/mcp` e começar com `https://`. |
| A tela de autorização abre e dá erro | A solicitação expira em 10 minutos. Comece de novo pelo aplicativo. |
| Conectou, mas o assistente diz que não tem ferramentas | A conexão pode ter sido revogada em Integrações, ou a assinatura deixou de ser Pro. |
| Pede login do Path Trader toda vez | O navegador está bloqueando cookies do app. Autorize numa janela normal, não anônima. |

## 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?”

---

Página original: https://www.path-trader.com.br/docs/ia/mcp/clientes