Cómo conectar Plivo a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Plivo, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Plivo + Gemini

Deja que tu IA trabaje con Plivo: consulta saldo y precios, envía SMS y MMS, haz llamadas y revisa los registros de llamadas, cuelga llamadas en curso, lista grabaciones y transcripciones, busca y consulta números de teléfono, y envía y comprueba códigos de un solo uso con Verify.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN

Paso 1 — Obtener credenciales

1. Inicia sesión en la consola de Plivo en https://cx.plivo.com.
2. Copia de la página de resumen el Auth ID (empieza por MA, o por SA en una subcuenta) y el Auth Token. Una subcuenta (Account → Subaccounts) limita a qué puede llegar el conector.
3. Pégalos en PLIVO_AUTH_ID y PLIVO_AUTH_TOKEN e instala el conector.
4. Comprueba la configuración con plivo_get_account: muestra la cuenta, el modo de facturación y el crédito disponible.

Una cuenta de prueba sirve para leer; para enviar y llamar hace falta crédito y, en prueba, números verificados.

Quién ve qué: el Auth Token actúa para toda la cuenta de Plivo y puede gastar su saldo. Comparte el servidor MCP solo con personas que puedan gastar dinero en ella. Los registros de mensajes y llamadas, los números de teléfono, las grabaciones y las transcripciones son datos personales, y cualquiera que tenga el enlace de una grabación puede escucharla.

Cuesta dinero y llega a personas reales, así que la IA pregunta antes: Plivo cobra plivo_send_message (SMS y MMS, por parte de mensaje y destinatario), plivo_make_call (por minuto) y plivo_send_verification (por verificación, más el SMS o la llamada). Antes de cada una, la IA te muestra remitente, destinatario y contenido, con el precio de plivo_get_pricing si lo pides, y espera tu sí. plivo_lookup_number se cobra por consulta, así que la IA te dice cuántos números y cuánto cuesta antes de consultar más de unos pocos.

Desactivadas al instalar: plivo_buy_number, que alquila un número con una cuota de alta y una cuota mensual hasta que se libera; buscar con plivo_search_available_numbers es gratis. plivo_hangup_call también está desactivada: corta una llamada en curso, y Plivo termina todas las llamadas en curso de la cuenta si falta el id de la llamada. Un administrador las activa de forma deliberada; después la IA te muestra el número con sus costes, o la llamada con sus números y hora de inicio, y solo actúa cuando lo confirmas.

SMS: plivo_send_message devuelve un message_uuid; plivo_get_message muestra el estado de entrega, las partes facturadas y el precio, y plivo_list_messages resume tu tráfico (sin el texto de los mensajes). Un remitente de EE. UU. o Canadá debe estar registrado para 10DLC o para envíos desde números toll-free; si no, los mensajes fallan.

Las llamadas necesitan una answer URL: plivo_make_call llama al número y, cuando contestan, consulta tu answer_url, que debe devolver Plivo XML alojado en tu servidor (por ejemplo <Response><Speak>Hola</Speak></Response>). Un time_limit pone tope al coste. Llamadas en curso: plivo_list_live_calls y plivo_get_live_call. Llamadas terminadas: plivo_list_calls y plivo_get_call, con duración, duración facturada, precio y causa de fin. Grabaciones: plivo_list_recordings, plivo_get_recording y plivo_get_transcription cuando se pidió una transcripción (una opción de pago de Plivo) para la grabación.

Verify: plivo_send_verification envía un código de un solo uso por SMS o llamada de voz, plivo_validate_verification comprueba el código que escribió la persona (cada intento cuenta para el límite de intentos) y plivo_get_verification muestra el estado y los cargos.

Números y horas: envía los números en E.164 (+34612345678); Plivo los lista sin el más. Los filtros de tiempo van en UTC con el formato YYYY-MM-DD HH:MM:SS. Las búsquedas de llamadas y grabaciones cubren los últimos 7 días si no das un rango, con un máximo de 30 días por búsqueda.

Límite de peticiones: 300 peticiones cada 5 segundos por cuenta; las llamadas salientes tienen además un límite de llamadas por segundo y otro de llamadas simultáneas (403 Concurrency Limit Breached). Un 429 significa esperar y volver a intentarlo.

Errores comunes: 401: Auth ID o Auth Token incorrectos, o un token que se regeneró. 403: una subcuenta sin acceso o una restricción de IP en API access control. 404: ese mensaje, llamada, grabación o número no existe en esta cuenta. 400: falta un parámetro o no es válido, por ejemplo el formato del número o un remitente que no pertenece a la cuenta. Envíos o llamadas que fallan por saldo bajo: revisa el crédito con plivo_get_account y recarga en la consola.

El conector no cubre plantillas de WhatsApp, conferencias y llamadas con varios participantes, la transferencia de llamadas y el control de grabaciones, applications y endpoints, subcuentas, documentos de cumplimiento ni la liberación de números.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Plivo.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es nuestro saldo en Plivo y cuánto cuesta un SMS saliente a España?"
• "Envía un SMS desde nuestro número de Plivo al +34612345678 confirmando la cita del viernes a las 10:00. Muéstrame antes remitente, destinatario, texto y precio."
• "¿Qué mensajes de ayer no se entregaron o fallaron? Muéstrame los códigos de error y cuánto costaron."
• "Lista las llamadas de los últimos 7 días que duraron más de cinco minutos, con duración facturada, precio y causa de fin."
• "Envía un código de verificación por SMS al +34612345678 y pregúntame antes de enviarlo. Después comprueba el código que me lee el cliente."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT