Conecta tu agente vía MCP (BYO Agent)

Solo servidor en la nube — conecta tu propio agente de IA (Claude Code, Cursor, Codex CLI…) a tu servidor en la nube de Blave Agent a través de su servidor MCP (Model Context Protocol): corre con tu propia suscripción, sin cargo de Blave AI.

¿Cómo te conectas? Abre el espacio de trabajo, haz clic en "Más" al final de la barra lateral y ve a "Configuración" › "Conexiones". En "Conecta tu agente vía MCP", haz clic en "Generar código de acceso", luego en "Copiar mensaje" y pégalo al agente que uses — eso completa la configuración (tu servidor debe estar en ejecución). Esta página detalla el formato de la configuración y las advertencias de cada herramienta; está escrita tanto para humanos como para agentes enviados aquí a leer los detalles de configuración. Tres datos clave:

• Endpoint MCP: https://mcp.blave.org/mcp (transporte HTTP).
• Autenticación: encabezado HTTP Authorization: Bearer <YOUR_ACCESS_CODE>.
• El código de acceso se muestra solo una vez al generarlo; mientras tu servidor esté en ejecución, puedes regenerarlo o revocarlo en cualquier momento (el código anterior se invalida de inmediato).

¿Cómo configuro cada herramienta?

Claude Code

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

Ejecuta en una terminal. --scope user lo hace global (el valor predeterminado local solo aplica al directorio del proyecto actual). Tras regenerar el código de acceso, primero ejecuta claude mcp remove blave, vuelve a añadirlo (una entrada con el mismo nombre no se sobrescribe) y reinicia Claude Code.

Codex CLI

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

Pega en ~/.codex/config.toml. Usa la forma de encabezado de tabla mostrada arriba — una clave de una línea con puntos pegada después de otra [section] queda anidada bajo la sección equivocada.

Cursor

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

Pega en .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global). Si el archivo ya tiene mcpServers, combina la entrada blave en lugar de reemplazar todo el archivo.

Gemini CLI

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

Ejecuta en una terminal. --scope user es obligatorio: el ámbito predeterminado es de proyecto, y ejecutarlo en tu directorio personal da error. Tras regenerar el código de acceso, simplemente vuelve a ejecutarlo — se sobrescribe.

Antigravity

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

Abre la configuración desde el panel del agente: … → MCP Servers → Manage MCP Servers → View raw config (la ruta del archivo varía según la versión). Si ya tiene mcpServers, combina la entrada blave.

VS Code Copilot

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

Pega en .vscode/mcp.json (workspace) o ejecuta MCP: Open User Configuration para el archivo a nivel de usuario. Nota que la clave de nivel superior es servers, no mcpServers.

Cline

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

Abre el JSON de configuración de MCP Servers desde el panel de Cline y pégalo. type debe ser camelCase streamableHttp — ni http ni streamablehttp funcionan.

opencode

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

Pega en opencode.json. Mantén "oauth": false — desactiva explícitamente la detección automática de OAuth para que se use la autenticación por encabezado con código de acceso.

Warp

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

Settings → AI → MCP Servers (o Warp Drive → MCP Servers) → Add, y luego pega. El nivel superior es directamente el nombre del servidor — sin envoltorio mcpServers.

Windsurf

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

Pega en ~/.codeium/windsurf/mcp_config.json. Nota que el campo de url se llama serverUrl. (El producto está siendo renombrado: la documentación ahora lo llama Devin Desktop; esta configuración aplica al agente Cascade heredado.)

Trae

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

Añade manualmente en la configuración de MCP y pega el JSON, o escríbelo en .trae/mcp.json en la raíz del proyecto.

¿No puedes conectar, o las acciones se bloquean?

• Acciones bloqueadas por permisos: añade mcp__blave a permissions.allow (en el modo automático de Claude Code también permite Bash(ssh:*)), o usa el modo predeterminado.
• El nuevo código de acceso no surte efecto: tras regenerarlo, reinicia la sesión del agente (reinicia la herramienta o abre una conversación nueva) — las conexiones existentes no captan el código nuevo.
• El cambio de configuración de Claude Code no tiene efecto: una entrada con el mismo nombre en el ámbito local tiene prioridad sobre user. Ejecuta claude mcp get blave para ver qué ámbito está activo y elimina el que no quieras.
• Ya existe un servidor con el mismo nombre: Claude Code da error y no sobrescribe — ejecuta primero claude mcp remove blave; Gemini CLI simplemente sobrescribe al volver a ejecutar.

Conectado — ¿qué debe hacer el agente?

1. Llama primero a get_ssh_access para obtener credenciales SSH de corta duración (15 minutos; simplemente vuelve a llamar cuando expiren).
2. Tras conectarte por SSH al servidor, lee AGENTS.md en la raíz del espacio de trabajo /opt/blave-agent/workspace y síguelo: usa lib/ para backtests y órdenes, no toques control/.
3. Activa la multiplexación SSH (los parámetros están en el uso devuelto por get_ssh_access) para que los comandos siguientes se salten el handshake.