> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gocliente.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar un asistente (MCP)

> Usá GoCliente desde Claude, Cursor y otros asistentes con un servidor MCP y un token de acceso.

GoCliente tiene un servidor **MCP** (Model Context Protocol) remoto. Te permite pedirle a un asistente cosas como "¿quién me debe más este mes?" o "creá una tarea para el viernes con el IVA de González", y que lo haga en tu estudio. No hay nada que instalar: el asistente se conecta por internet con un token.

## Conectarlo

<Steps>
  <Step title="Creá un token">
    Entrá a **API Tokens** y tocá **Nuevo token**. Para empezar, elegí el preset **Solo lectura**: el asistente va a poder consultar pero no cambiar nada. Más adelante podés crear otro con permisos de escritura.
  </Step>

  <Step title="Copiá el comando">
    Al crear el token, GoCliente te muestra el comando listo con tu token adentro. Copialo en ese momento: después no se puede volver a ver.
  </Step>

  <Step title="Conectalo a tu asistente">
    Pegá el comando en la terminal (Claude Code) o cargá la dirección y el encabezado en la configuración de tu asistente.
  </Step>
</Steps>

La dirección del servidor es `https://app.gocliente.com/api/mcp`.

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http gocliente https://app.gocliente.com/api/mcp \
    --header "Authorization: Bearer gck_..."
  ```

  ```json Cursor y otros clientes theme={null}
  {
    "mcpServers": {
      "gocliente": {
        "url": "https://app.gocliente.com/api/mcp",
        "headers": { "Authorization": "Bearer gck_..." }
      }
    }
  }
  ```
</CodeGroup>

## Qué puede hacer el asistente

El asistente solo ve las herramientas que corresponden a los permisos de tu token.

| Herramienta | Qué hace | Permiso |
| - | - | - |
| `buscar_clientes` | Busca clientes por nombre, RUT o email. | `clients:read` |
| `historial_del_cliente` | Muestra quién hizo qué sobre un cliente. | `clients:read` |
| `crear_cliente` | Crea un cliente y avisa si el RUT ya existe. | `clients:write` |
| `editar_cliente` | Cambia datos de un cliente. | `clients:write` |
| `listar_tareas` | Lista las tareas que no son privadas. | `tasks:read` |
| `crear_tarea` | Crea una tarea con las mismas reglas que en la app. | `tasks:write` |
| `actualizar_tarea` | Edita, completa, reabre o mueve una tarea. | `tasks:write` |
| `listar_obligaciones` | Vencimientos tributarios con su estado. | `obligations:read` |
| `facturacion_del_mes` | Honorarios facturados, cobrados y pendientes del mes. | `billing:read` |
| `estado_de_cobranza` | Quién está al día, quién debe y cuánto. | `billing:read` |
| `registrar_cobro` | Registra un cobro de un cliente. Con `addIva` decidís si suma el IVA 22 %; si no, lo define el Tipo de honorario del cliente. | `billing:write` |
| `listar_notas` / `crear_nota` | Lee y crea notas de seguimiento. | `notes:read` / `notes:write` |
| `listar_eventos_del_calendario` | Eventos de tu calendario en un rango. | `calendar:read` |
| `crear_evento_del_calendario` | Crea un evento en tu calendario. | `calendar:write` |
| `listar_equipo` | Integrantes del estudio y sus roles. | `org:read` |

## Seguridad

<Warning>
  Un token de escritura le permite al asistente **cambiar datos reales** de tu estudio. Usá uno de solo lectura mientras probás, revisá lo que el asistente propone antes de aprobar cada acción y revocá el token si dejás de usarlo.
</Warning>

* **Con tus permisos.** Cada acción se hace como la persona que creó el token, con sus permisos en GoCliente. Si no puede editar tareas, el asistente tampoco.
* **Queda registrado.** Los cambios aparecen en la auditoría a nombre de quien creó el token.
* **Se corta solo.** Si esa persona deja de pertenecer al estudio, el token deja de funcionar.
* **Límite de uso.** Hay un tope de pedidos por minuto para evitar abusos.
* **No hay borrados.** El asistente no puede eliminar clientes, tareas ni cobros.

Podés ver el último uso de cada token, y revocarlo cuando quieras, en **API Tokens**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.