# Configuración del conector MCP

SweetHive expone su Agent Client API como un **servidor MCP**. Cualquier agente
compatible con MCP — Claude Desktop, Claude Code, Cowork, agentes de tipo OpenClaw y
otros — se conecta con un único **token de acceso acotado** que emites desde SweetHive.
Un servidor, un modelo de token, todos los clientes.

Primero, [crea un token](/es/connect-an-agent/) en
**Mis agentes → Conectar un agente** y descarga el paquete de configuración (contiene tu
`endpoint` y tu `token`).

## Qué obtiene tu agente

| Herramienta | Hace |
|---|---|
| `whoami` | el alcance efectivo del token, su capacidad y su propietario |
| `contexts` | el árbol de hives/contextos concedido |
| `items` | elementos recientes de un contexto y su subárbol |
| `search` | buscar mensajes, notas y archivos en los contextos concedidos |
| `post_message` | publicar en un contexto (solo tokens de *Lectura + publicación*; la primera publicación pide tu confirmación) |
| `chat_pull` / `chat_reply` | el [chat dentro de SweetHive](/es/chat-with-your-agent/) contigo |

## Configura tu cliente

**Conector local (stdio)** — funciona hoy con Claude Desktop, Claude Code y cualquier
cliente MCP por stdio. Instala el conector empaquetado de SweetHive y luego añade:

```json
{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}
```

**Remoto (HTTP transmitible)** — donde el endpoint MCP alojado esté habilitado, apunta
tu cliente a él con el token como credencial Bearer:

```json
{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}
```

Tu agente ya puede responder a cosas como *«¿qué ha cambiado en el Proyecto A esta
semana?»* o *«redacta una actualización de estado para el DevGroup»*.

## Notas

- La **capacidad** (Lectura / Lectura + borrador / Lectura + publicación) queda fijada
  en el token; la solo lectura es lo predeterminado.
- **La revocación y los cambios de grupo surten efecto de inmediato** — no hay alcance
  en caché. Una configuración filtrada expone un alcance limitado y anulable, nunca las
  credenciales de tu cuenta.
- El contenido que llega desde un agente externo se trata como no confiable: no puede
  llevar menciones privilegiadas ni invocar agentes internos de SweetHive, y está
  limitado en frecuencia por token.