# Servidores MCP (VPower)

**MCP** (*Model Context Protocol*) es un estándar abierto para que un agente de IA use herramientas de otros sistemas. Un **servidor MCP** publica una lista de herramientas (por ejemplo, *buscar un cliente*, *consultar stock*, *crear un ticket*), cada una con su descripción y sus parámetros.

Si conectas un servidor MCP a tu agente de voz ⚡ VPower, el agente lee esas herramientas al empezar cada llamada y las usa como cualquier otra función: decide cuándo hace falta, le pasa los datos y usa la respuesta para seguir la conversación.

> 💡 Muchas plataformas ya ofrecen su servidor MCP (CRMs, gestores de tickets, bases de conocimiento, herramientas de automatización). Con MCP no tienes que crear una función por cada acción: conectas el servidor una vez y el agente tiene todas sus herramientas.

---

## Cuándo usar MCP y cuándo otra función

| Si… | Usa |
|---|---|
| El sistema que quieres conectar ya tiene un servidor MCP | **Servidor MCP** |
| Tienes tu propia API y quieres que el agente la llame | [Función con tu API (webhook)](funciones-webhook.md) |
| No tienes servidor y quieres escribir la lógica en JavaScript | [Función de código](funciones-de-codigo.md) |

---

## Conectar un servidor MCP

En la ficha del agente: **Funciones → + Agregar función → MCP → Servidor MCP**.

| Campo | Qué poner |
|---|---|
| **Nombre** | Un nombre corto para reconocerlo, por ejemplo `crm` o `documentacion`. |
| **URL del servidor** | La dirección del servidor MCP, que siempre empieza con `https://`. Por ejemplo `https://servidor.ejemplo.com/mcp`. |
| **Autorización** *(opcional)* | Si el servidor pide una clave, escríbela completa, por ejemplo `Bearer tu_token`. Se envía en la cabecera `Authorization`. |
| **Herramientas permitidas** *(opcional)* | Los nombres de las herramientas que el agente puede usar, separados por coma. Si lo dejas vacío, puede usar todas. |
| **Cuándo usarlo** *(opcional)* | Una frase que ayuda al agente a saber para qué sirve, por ejemplo *"para consultar el estado de los pedidos"*. |

### Probar la conexión

Antes de guardar, toca **🔌 Probar conexión**. Anunzi se conecta al servidor y te muestra la lista de herramientas que ofrece, con su descripción. Desde esa lista puedes marcar cuáles quieres permitir: se completan solas en **Herramientas permitidas**.

Si la prueba falla, revisa la URL y la autorización (ver [Problemas comunes](#problemas-comunes)).

Después **guarda** y **publica** la versión para que se use en las llamadas.

---

## Recomendaciones

* **Permite solo las herramientas que el agente necesita.** Muchos servidores MCP traen decenas de herramientas. Cuantas menos tenga el agente, más rápido y preciso elige la correcta.
* **Evita herramientas que borren o cambien datos** si el agente no las necesita (por ejemplo, *eliminar cliente*). Déjalas fuera de la lista de permitidas.
* **Indica en el prompt cuándo usarlas.** Por ejemplo: *"Cuando la persona pregunte por un pedido, búscalo con la herramienta de pedidos antes de responder."*
* **Prueba en texto.** **Probar en texto** de la ficha muestra cada herramienta que usa el agente, con los datos que le mandó y lo que respondió el servidor.

---

## Requisitos técnicos

* La URL debe ser **https** y pública (no se aceptan direcciones de redes internas).
* Transporte: **Streamable HTTP**. Si la URL termina en `/sse`, se usa el transporte **SSE**.
* El servidor tiene que responder rápido: el agente lo consulta durante la llamada. Al empezar, la conexión espera hasta 8 segundos.
* Puedes conectar más de un servidor MCP al mismo agente.
* Disponible en agentes ⚡ VPower.

---

## Problemas comunes

**"Probar conexión" no muestra herramientas.** Revisa que la URL sea la del servidor MCP (suele terminar en `/mcp` o `/sse`) y no la de la página web del servicio.

**Error de autorización (401 o 403).** La clave no es correcta o le falta el prefijo. Muchos servidores esperan `Bearer ` antes del token.

**El agente no usa las herramientas.** Revisa que estén en **Herramientas permitidas** (o que el campo esté vacío) y agrega en el prompt cuándo debe usarlas. Recuerda publicar la versión.