# Conectar tu agente

Necesitas un token (mira [Tokens y permisos](https://docs.bisonagents.com/mcp/tokens/)). En cada configuración reemplaza `bsn_TU_TOKEN` por el tuyo. La URL del servidor es `https://mcp.bisonagents.com`.

> **Cuida tu token:** Trátalo como una contraseña: no lo pegues en chats, repositorios ni capturas. Si se filtra, revócalo desde Ajustes y crea otro.

## Claude Code

Ejecuta este comando en tu terminal:

```bash
claude mcp add --transport http bison https://mcp.bisonagents.com --header "Authorization: Bearer bsn_TU_TOKEN"
```

## Cursor

Agrégalo en `~/.cursor/mcp.json` (o `.cursor/mcp.json` dentro de un proyecto):

```json
{
  "mcpServers": {
    "bison": {
      "url": "https://mcp.bisonagents.com",
      "headers": {
        "Authorization": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## VS Code

Agrégalo en `.vscode/mcp.json`. La clave raíz es `servers`, no `mcpServers`:

```json
{
  "servers": {
    "bison": {
      "type": "http",
      "url": "https://mcp.bisonagents.com",
      "headers": {
        "Authorization": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## Claude Desktop

En Ajustes → Conectores → Agregar conector personalizado, pega la URL y, si ves «Encabezados de solicitud», agrega `Authorization` con el valor de abajo. Si no aparece esa sección, usa este puente en `claude_desktop_config.json`:

```text
URL: https://mcp.bisonagents.com
Authorization: Bearer bsn_TU_TOKEN

{
  "mcpServers": {
    "bison": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bisonagents.com",
        "--header",
        "Authorization:${BISON_AUTH}"
      ],
      "env": {
        "BISON_AUTH": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## Gemini CLI

Ejecuta este comando en tu terminal:

```bash
gemini mcp add --transport http --header "Authorization: Bearer bsn_TU_TOKEN" bison https://mcp.bisonagents.com
```

## Codex

Guarda el token en una variable de entorno (`BISON_TOKEN`) y agrégalo en `~/.codex/config.toml`:

```toml
[mcp_servers.bison]
url = "https://mcp.bisonagents.com"
bearer_token_env_var = "BISON_TOKEN"

# export BISON_TOKEN=bsn_TU_TOKEN
```

## ChatGPT

Por ahora no hay configuración para ChatGPT: sus conectores personalizados solo aceptan OAuth, que Bison todavía no ofrece. Mientras tanto usa alguno de los clientes de arriba.

## Comprobar la conexión

Con `curl` puedes pedir la lista de herramientas. Si tu token es válido, responde con un JSON que las enumera:

```bash
curl -s https://mcp.bisonagents.com \
  -H "Authorization: Bearer bsn_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Si algo falla, revisa [Límites y errores](https://docs.bisonagents.com/mcp/limites-y-errores/): ahí está cada respuesta posible y qué hacer.