# Servidor MCP de Zipnova Envíos

Zipnova Envíos dispone de un servidor MCP (Model Context Protocol) para poder interactuar con cuentas de envíos a través de un agente de AI como Claude, ChatGPT y otros. Esta guía muestra cómo conectar el servidor MCP de Zipnova con las herramientas de desarrollo de IA más populares.

{% hint style="info" %}
El servidor MCP de Zipnova se encuentra actualmente en Beta, con lo cual pueden esperarse cambios en las herramientas y agregados de funcionalidad mientras profundizamos en su desarrollo.
{% endhint %}

### Instrucciones de configuración

A continuación podrás ver las instrucciones de conexión según tu cliente de AI:

{% tabs %}
{% tab title="Claude Code" %}

1. En tu terminal, corre el siguiente comando para instalar el servidor MCP de Zipnova, según el país de tu cuenta.

{% code title="ARGENTINA" %}

```
claude mcp add --transport http zipnova-ar https://mcp.zipnova.com.ar/mcp
```

{% endcode %}

{% code title="CHILE" %}

```
claude mcp add --transport http zipnova-cl https://mcp.zipnova.cl/mcp
```

{% endcode %}

{% code title="MÉXICO" %}

```
claude mcp add --transport http zipnova-mx https://mcp.zipnova.com.mx/mcp
```

{% endcode %}

2. Inicia Claude Code y corre el comando `/mcp` , busca el MCP de Zipnova en la lista y elige la opción para iniciar la autenticación.
3. Completa los pasos de la autenticación. Al finalizar, las herramientas del MCP estarán disponibles para usar.
   {% endtab %}

{% tab title="Claude Desktop" %}
En Claude.ai o Claude Desktop, dirígete a la configuración de personalización, luego [conectores](https://claude.ai/customize/connectors),  y agrega un **nuevo conector personalizado.**

La URL del servidor, según el país de tu cuenta, es:

{% code title="ARGENTINA" %}

```
https://mcp.zipnova.com.ar/mcp
```

{% endcode %}

{% code title="CHILE" %}

```
https://mcp.zipnova.cl/mcp
```

{% endcode %}

{% code title="MÉXICO" %}

```
https://mcp.zipnova.com.mx/mcp
```

{% endcode %}
{% endtab %}

{% tab title="VSCode" %}

1. En VS Code, abre la paleta de comandos:

   macOS :Command + Shift + P\
   Windows/Linux :Ctrl + Shift + P
2. Escriba "MCP: Agregar servidor" en la paleta de comandos.
3. Selecciona "HTTP" para conectarse a un servidor MCP remoto.
4. Introduce la URL del servidor MCP:\
   Argentina: `https://mcp.zipnova.com.ar/mcp`\
   Chile: `https://mcp.zipnova.cl/mcp`\
   México: `https://mcp.zipnova.com.mx/mcp`
5. Introduce un nombre para la conexión (por ejemplo, "Zipnova").

VS Code te pedirá que abras una página de inicio de sesión. Completa el proceso de inicio de sesión con sus credenciales de Zipnova.
{% endtab %}

{% tab title="Otros" %}
En tu cliente de AI, utiliza estos parámetros para conectarte al servidor MCP remoto de Zipnova:

* URL:\
  Argentina: `https://mcp.zipnova.com.ar/mcp`\
  Chile: `https://mcp.zipnova.cl/mcp`\
  México: `https://mcp.zipnova.com.mx/mcp`
* Transporte: HTTP
  {% endtab %}
  {% endtabs %}

### Herramientas disponibles

Una vez conectado al servidor MCP, tendrás acceso a una serie de herramientas para interactuar con tu cuenta. Las mismas están limitadas en permisos a lo que tu usuario puede hacer en la cuenta.

* Cotizar y crear envíos
* Buscar y ver detalle de envíos, incluyendo el tracking y documentación de despacho
* Buscar y ver detalle de ordenes
* Buscar y gestionar recolecciones programadas
* Gestionar productos y SKUs


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zipnova.com/envios/mcp/servidor-mcp-de-zipnova-envios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
