> ## 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 Zapia

> Conectá GoCliente con Zapia para consultar tus clientes y vencimientos en lenguaje natural, con una API key de solo lectura.

Con Zapia podés preguntarle por tus clientes y vencimientos sin abrir GoCliente, por ejemplo "¿qué vence esta semana?" o "pasame los datos de González". La conexión usa el [servidor MCP](/integraciones/mcp) de GoCliente.

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

## Conectarlo paso a paso

**1. Creá la API key en GoCliente**

Entrá a [API Tokens](https://app.gocliente.com/dashboard/api-tokens) y tocá **Nuevo token**. Elegí el preset **Solo lectura**, o tildá a mano solo **Leer clientes** y **Leer obligaciones**. Copiá la clave apenas se crea: después no se puede volver a ver.

**2. Pedí el conector en Zapia**

Entrá a [app.zapia.com/connectors](https://app.zapia.com/connectors) y tocá **Solicitar conector**.

**3. Poné el nombre**

En el nombre escribí `gocliente`.

**4. Pasale la dirección del MCP**

Pegá `https://app.gocliente.com/api/mcp` como URL del servidor.

**5. Pegá la API key**

Cuando Zapia pida la API key, pegá la que creaste en el paso 1.

## Qué puede hacer Zapia

La conexión es **de solo lectura**: Zapia puede consultar clientes y vencimientos, pero no puede crear, cambiar ni borrar nada en tu estudio. Con los permisos que tildaste en el paso 1, las herramientas disponibles son:

| Herramienta | Qué hace |
| - | - |
| `buscar_clientes` | Busca clientes por nombre, RUT o email. |
| `contactos_del_cliente` | Personas de contacto de un cliente. |
| `historial_del_cliente` | Quién hizo qué sobre un cliente. |
| `listar_obligaciones` | Vencimientos tributarios con su estado. |

> [!NOTE]
>
> El preset **Solo lectura** incluye todos los permisos de lectura, no solo clientes y vencimientos. Si querés que Zapia vea únicamente eso, tildá a mano **Leer clientes** y **Leer obligaciones**.

## Seguridad

> [!WARNING]
>
> La API key es un secreto. No la compartas, no la pegues en chats ni en documentos y no la subas a repositorios.

* **Con tus permisos.** Zapia actúa como la persona que creó la API key, y deja de funcionar si esa persona sale del estudio.
* **Revocala cuando haga falta.** Si dudás de que alguien más la tenga, o dejás de usar Zapia, entrá a [API Tokens](https://app.gocliente.com/dashboard/api-tokens) y revocala. El acceso se corta en el momento; después podés crear otra.
* **Último uso.** En **API Tokens** ves cuándo se usó cada clave por última vez.

## Si algo no anda

**Zapia ofrece conectar por API REST en vez de MCP.** GoCliente tiene servidor MCP, así que elegí esa opción o pedile a Zapia que use un servidor MCP. Pasale el enlace a esta guía y a la de [asistentes (MCP)](/integraciones/mcp), que explican la dirección y cómo se manda la API key.

**Zapia dice que la clave no es válida.** Revisá que la hayas copiado completa, sin espacios, y que no esté revocada en **API Tokens**. Si se perdió, creá una nueva.

**Zapia no encuentra algo que tenés en GoCliente.** Confirmá en **API Tokens** que la clave tenga los permisos de lectura de clientes y de obligaciones.

Si necesitás más herramientas, como tareas o cobranza, creá una clave con esos permisos de lectura. Para escribir en GoCliente desde un asistente, mirá la guía de [asistentes (MCP)](/integraciones/mcp).


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