Conecte seu agente via MCP (BYO Agent)

Só no servidor na nuvem — conecte seu próprio agente de IA (Claude Code, Cursor, Codex CLI…) ao seu servidor na nuvem do Blave Agent pelo servidor MCP (Model Context Protocol): ele roda na sua própria assinatura, sem taxa de Blave AI.

Última atualização 2026-08

Como conectar? Abra a área de trabalho, clique em "Mais" no fim da barra lateral e vá em "Configurações" › "Conexões". Em "Conecte seu agente via MCP", clique em "Gerar código de acesso", depois em "Copiar mensagem" e cole no agente que você usa — isso completa a configuração (seu servidor precisa estar em execução). Esta página lista o formato da configuração e as ressalvas de cada ferramenta; é escrita para humanos e para agentes enviados aqui para ler os detalhes de configuração. Três fatos essenciais:

  • Endpoint MCP: https://mcp.blave.org/mcp (transporte HTTP).
  • Autenticação: header HTTP Authorization: Bearer <YOUR_ACCESS_CODE>.
  • O código de acesso é exibido apenas uma vez, na geração; enquanto seu servidor está rodando, você pode regenerá-lo ou revogá-lo a qualquer momento (o código antigo é invalidado imediatamente).

Como configuro cada ferramenta?

Claude Code

claude mcp add --scope user --transport http blave https://mcp.blave.org/mcp --header "Authorization: Bearer <YOUR_ACCESS_CODE>"

Rode em um terminal. --scope user torna a configuração global (o padrão local se aplica só ao diretório do projeto atual). Depois de regenerar o código de acesso, rode primeiro claude mcp remove blave, adicione de novo (uma entrada com o mesmo nome não é sobrescrita) e reinicie o Claude Code.

Codex CLI

[mcp_servers.blave]
url = "https://mcp.blave.org/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_ACCESS_CODE>" }

Cole em ~/.codex/config.toml. Use o formato de cabeçalho de tabela mostrado acima — uma chave de uma linha com pontos, colada depois de outra [section], fica aninhada na seção errada.

Cursor

{
  "mcpServers": {
    "blave": {
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Cole em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global). Se o arquivo já tiver mcpServers, mescle a entrada blave em vez de substituir o arquivo inteiro.

Gemini CLI

gemini mcp add --scope user --transport http blave https://mcp.blave.org/mcp --header "Authorization: Bearer <YOUR_ACCESS_CODE>"

Rode em um terminal. --scope user é obrigatório: o escopo padrão é o projeto, e rodar no diretório home gera erro. Depois de regenerar o código de acesso, basta rodar de novo — ele sobrescreve.

Antigravity

{
  "mcpServers": {
    "blave": {
      "serverUrl": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Abra a configuração pelo painel do agente: … → MCP Servers → Manage MCP Servers → View raw config (o caminho do arquivo varia por versão). Se já tiver mcpServers, mescle a entrada blave.

VS Code Copilot

{
  "servers": {
    "blave": {
      "type": "http",
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Cole em .vscode/mcp.json (workspace) ou rode MCP: Open User Configuration para o arquivo de nível de usuário. Note que a chave de nível superior é servers, não mcpServers.

Cline

{
  "mcpServers": {
    "blave": {
      "type": "streamableHttp",
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Abra o JSON de configurações do MCP Servers no painel do Cline e cole. type precisa estar em camelCase streamableHttp — nem http nem streamablehttp funcionam.

opencode

{
  "mcp": {
    "blave": {
      "type": "remote",
      "url": "https://mcp.blave.org/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Cole em opencode.json. Mantenha "oauth": false — isso desativa explicitamente a detecção automática de OAuth para que a autenticação por header com código de acesso seja usada.

Warp

{
  "blave": {
    "url": "https://mcp.blave.org/mcp",
    "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
  }
}

Settings → AI → MCP Servers (ou Warp Drive → MCP Servers) → Add e cole. O nível superior é diretamente o nome do servidor — sem o wrapper mcpServers.

Windsurf

{
  "mcpServers": {
    "blave": {
      "serverUrl": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Cole em ~/.codeium/windsurf/mcp_config.json. Note que o campo de url se chama serverUrl. (O produto está sendo renomeado: a documentação agora o chama de Devin Desktop; esta configuração se aplica ao agente legado Cascade.)

Trae

{
  "mcpServers": {
    "blave": {
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ACCESS_CODE>" }
    }
  }
}

Adicione manualmente nas configurações do MCP e cole o JSON, ou escreva em .trae/mcp.json na raiz do projeto.

Não consegue conectar, ou as ações são bloqueadas?

  • Ações bloqueadas por permissões: adicione mcp__blave em permissions.allow (no modo auto do Claude Code, também libere Bash(ssh:*)), ou use o modo padrão.
  • O novo código de acesso não faz efeito: depois de regenerar, reinicie a sessão do agente (reinicie a ferramenta ou abra uma nova conversa) — conexões existentes não pegam o novo código.
  • A mudança de configuração do Claude Code não tem efeito: uma entrada com o mesmo nome no escopo local tem prioridade sobre user. Rode claude mcp get blave para ver qual escopo está ativo e remova o que você não quer.
  • Já existe um servidor com o mesmo nome: o Claude Code gera erro e não sobrescreve — rode claude mcp remove blave primeiro; o Gemini CLI simplesmente sobrescreve ao rodar de novo.

Conectado — o que o agente deve fazer?

  1. Chame get_ssh_access primeiro para obter credenciais SSH de curta duração (15 minutos; basta chamar de novo quando expirar).
  2. Depois de conectar via SSH no servidor, leia o AGENTS.md na raiz do workspace /opt/blave-agent/workspace e siga as instruções: use lib/ para backtests e ordens, não mexa em control/.
  3. Ative o SSH multiplexing (os parâmetros estão no usage retornado por get_ssh_access) para que os próximos comandos pulem o handshake.
A seguir
Início rápido Dois jeitos de rodar: o app para desktop, grátis e de código aberto, com seu próprio Claude Code ou Codex; ou um servidor na nuvem que continua rodando com o computador desligado. Portfólio de trading ao vivo Como as estratégias operam com dinheiro real: valores em dólares, reconciliação automática, fechar tudo e o kill switch.
Comece com o Blave Agent