LINE Bot MCP — Casos de uso, Instalar & Demo en vivo

Name: LINE Bot MCP Server
Author: line

Por qué usarlo

Características clave

Push, reply, multicast, broadcast y narrowcast todos compatibles
Mensajes Flex enriquecidos — tarjetas, botones, carruseles — definidos mediante JSON
Obtén perfil de usuario (nombre visible, foto) por userId
Funciona con Cuentas Oficiales de LINE (token de acceso de canal)
Localizado para mercados JP/TW/TH/ID donde LINE es dominante

Demo en vivo

Cómo se ve en la práctica

line-bot.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "-y",
        "@line/line-bot-mcp-server"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "-y",
        "@line/line-bot-mcp-server"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "-y",
        "@line/line-bot-mcp-server"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "-y",
        "@line/line-bot-mcp-server"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "line-bot",
      "command": "npx",
      "args": [
        "-y",
        "@line/line-bot-mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "line-bot": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@line/line-bot-mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add line-bot -- npx -y @line/line-bot-mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: LINE Bot

Envía una alerta de operaciones formateada a un ingeniero en guardia vía LINE

👤 Equipos SRE con base en JP/TW donde LINE es el paginador estándar ⏱ ~25 min intermediate

Cuándo usarlo: Quieres que las alertas de Sentry/Prometheus notifiquen a ingenieros específicos en LINE con una tarjeta Flex ordenada, no un muro de texto.

Requisitos previos

Cuenta Oficial de LINE + token de acceso de canal — developers.line.biz → Channel → Messaging API → Emitir token
El userId del ingeniero (de los eventos webhook de tu bot) — Captura userId de un evento follow o message; almacena en tu base de datos de usuarios

Flujo

Diseña la burbuja Flex

Diseña una burbuja Flex Message para una alerta de Sentry: encabezado (título del problema), cuerpo (cantidad de eventos, lanzamiento, usuarios afectados), botones (Abrir en Sentry, Reconocer).✓ Copiado

→ JSON Flex válido que Claude puede validar
Envía al usuario en guardia

Envía este mensaje Flex al userId U1234567890abcdef con altText 'Alerta Sentry: <title>'.✓ Copiado

→ messageId devuelto, sin 400
Maneja el respaldo si el usuario bloqueó el bot

Si el envío falla con 400 (usuario bloqueado), haz multicast a los userIds en guardia secundarios en su lugar y registra el error original.✓ Copiado

→ Ruta de respaldo elegante

Resultado: Una alerta pulida y accionable en LINE dentro de 2 segundos del evento subyacente.

Errores comunes

altText requerido y limitado a 400 caracteres — los envíos fallan silenciosamente sin él — Siempre incluye altText; mantenlo bajo 400 caracteres resumiendo el Flex
Enviar sin que el usuario sea amigo del bot falla con 400 — Solo envía a userIds que capturaste de un evento webhook real — no puedes adivinarlos

Combinar con: sentry

Transmite una actualización mensual de productos a todos los seguidores

👤 Equipos de marketing con presencia de Cuenta Oficial de LINE ⏱ ~20 min intermediate

Cuándo usarlo: Una vez al mes, envías un resumen a todos los seguidores con 3 elementos principales y enlaces profundos.

Requisitos previos

Cuota de mensajería suficiente — Verifica la cuota actual con getMessageQuota; los LINE Push Messages se miden por plan

Flujo

Verifica la cuota antes de enviar

Obtén el consumo de cuota de mensajes actual y restante. Confirma que tenemos al menos <follower_count> mensajes restantes.✓ Copiado

→ Número de cuota restante
Compone un carrusel Flex

Construye un carrusel Flex con 3 burbujas (título, imagen, botón CTA). Entradas: [tema, URL de imagen, enlace] × 3.✓ Copiado

→ JSON del carrusel Flex válido
Transmite

Transmite este carrusel a todos los seguidores con altText '<marca> actualización mensual'.✓ Copiado

→ 200 OK, requestId para auditoría

Resultado: Una transmisión mensual con marca para toda la base de seguidores con seguimiento de clics a través de tus enlaces de redirección.

Errores comunes

Las transmisiones son costosas — una lista grande puede agotar la capa gratuita en un envío — Para contenido no urgente considera narrowcast con un segmento; o actualiza el plan antes de enviar

Deja que Claude publique un resumen de standup en el grupo LINE del equipo

👤 Equipos donde el standup diario vive en un grupo de LINE ⏱ ~20 min intermediate

Cuándo usarlo: Cada mañana a las 9, resume la actividad de Linear/Sentry de ayer y publica un resumen corto.

Requisitos previos

groupId del chat objetivo — Captura de un evento join o message cuando el bot se añade al grupo

Flujo

Ensambla el resumen aguas arriba

Extrae los PRs fusionados de Linear de ayer y los nuevos problemas principales de Sentry. Resume en 5 puntos.✓ Copiado

→ Markdown de 5 puntos limpio
Envía al grupo

Envía un mensaje de texto (sin markdown; LINE no representa markdown) al groupId Cxxxxx con los 5 puntos como líneas simples.✓ Copiado

→ 200 OK
Reconoce fallos ruidosamente

Si el envío falla (el bot fue expulsado del grupo), escribe el error en /logs/line-standup.log y notifícame por correo electrónico.✓ Copiado

→ Rastro de auditoría en caso de fallo

Resultado: Un resumen de standup diario confiable que se auto-repara silenciosamente y te alerta si se rompe.

Errores comunes

El bot eliminado del grupo falla silenciosamente el envío — Suscríbete a eventos webhook leave y marca el grupo como inactivo en tu BD
Los mensajes de texto de LINE no representan Markdown ni HTML — Usa texto simple con emoji, o cambia a un mensaje Flex para formato enriquecido

Combinar con: sentry · linear

Realiza un narrowcast de una campaña a un segmento geográfico o de comportamiento

👤 Equipos de crecimiento que ejecutan envíos dirigidos ⏱ ~20 min advanced

Cuándo usarlo: Quieres notificar solo a seguidores del área de Tokio sobre un evento presencial, no a toda tu lista.

Requisitos previos

Audiencia definida en el Administrador de Cuentas Oficiales de LINE — Crea una audiencia (geo, etiqueta o lista userId cargada) en la interfaz del Administrador de Cuentas Oficiales

Flujo

Enumera audiencias

Enumera todas las audiencias en nuestra Cuenta Oficial de LINE. Muestra nombre, tamaño, última actualización.✓ Copiado

→ Catálogo de audiencias
Compone mensaje específico del segmento

Construye una tarjeta Flex para el encuentro de Tokio — ubicación, fecha, CTA. Adapta el texto para usuarios del área de Tokio.✓ Copiado

→ JSON Flex dirigido
Realiza narrowcast

Realiza narrowcast de este Flex a audienceId <id>. Confirma que la solicitud fue aceptada.✓ Copiado

→ 202 Aceptado + requestId

Resultado: Campañas precisas con menor costo por impresión y mayor tasa de clics.

Errores comunes

Narrowcast a audiencia < 50 falla por razones de privacidad — Si el segmento es pequeño, recurre a envío individual a la lista de usuarios en su lugar

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

line-bot + sentry

Auto-envía una alerta Flex al usuario en guardia cuando aparece un problema crítico de Sentry

Cuando un nuevo problema de Sentry en el proyecto web-prod supera 100 eventos en 5 minutos, envía una alerta Flex al usuario en guardia de LINE.✓ Copiado

line-bot + linear

Notifica un grupo de LINE cuando se crea un problema P0 de Linear

Cuando un problema de Linear está etiquetado como P0, envía un mensaje de texto al groupId Cxxxx con el título y URL.✓ Copiado

line-bot + monday

Envía un resumen diario de elementos de monday.com vencidos hoy

Cada mañana a las 9am, recopila mis elementos de monday.com vencidos hoy, formatea como carrusel Flex, envía a mi usuario de LINE.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
push_message	to: userId\|groupId\|roomId, messages: Message[]	Envía a un id de destinatario conocido	1 cargo de mensaje
multicast	to: userId[], messages: Message[]	Mismo mensaje a <=500 usuarios específicos	1 cargo por destinatario
broadcast	messages: Message[]	Transmite a todos los seguidores; confirma cuota primero	1 cargo por seguidor
narrowcast	messages, recipient (audience object), filter?	Envíos dirigidos por audiencia	1 cargo por destinatario
get_profile	userId	Personaliza un mensaje con el nombre visible del usuario	gratuito
get_message_quota		Antes de cualquier broadcast/narrowcast	gratuito

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: El API de LINE se mide en mensajes, no en solicitudes. Capa gratuita: 500 mensajes push gratuitos/mes (prueba de desarrollador) o 200/mes (plan light).
Tokens por llamada: Mensaje de texto: ~200 tokens de solicitud. Mensaje Flex: 500–2000 tokens dependiendo de la complejidad de la burbuja.
Monetario: Plan light gratuito (200 msg/mes), Estándar ¥5,000/mes (hasta 30k msg), Pro ¥15,000/mes (45k+).
Consejo: Usa reply_message siempre que sea posible — las respuestas son GRATUITAS. Solo envía cuando no tengas un replyToken.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Token de acceso de canal (larga duración, Messaging API)

Almacenamiento de credenciales: CHANNEL_ACCESS_TOKEN y CHANNEL_SECRET en variables de entorno

Salida de datos: Todas las llamadas a api.line.me y api-data.line.me

No conceder nunca: Secreto de canal a código del lado del cliente — es solo para verificación de firma webhook

Rota CHANNEL_ACCESS_TOKEN si se filtra — los atacantes pueden transmitir spam en tu Cuenta Oficial.
Siempre verifica firmas de webhook de LINE con CHANNEL_SECRET antes de confiar en userIds de eventos.

Resolución de problemas

Errores comunes y soluciones

401 Token de acceso de canal inválido

Token expirado o revocado. Re-emite en developers.line.biz → Channel → Messaging API.

Verificar: curl -H 'Authorization: Bearer $CHANNEL_ACCESS_TOKEN' https://api.line.me/v2/bot/info

400 La propiedad altText debe especificarse

Todo mensaje no texto (imagen, Flex) requiere altText. Añádelo.

400 El usuario no ha añadido la Cuenta Oficial de LINE como amigo

No puedes enviar a userIds arbitrarios — solo a los que mensajearon/siguieron tu bot. Usa replyToken en su lugar para este destinatario.

429 Límite mensual alcanzado

Alcanzaste tu cuota de plan. Actualiza el plan o espera hasta el próximo mes; las respuestas siguen siendo gratuitas.

Verificar: Llama a get_message_quota

Alternativas

LINE Bot vs otros

Alternativa	Cuándo usarla	Contrapartida
Slack MCP	El equipo está en Slack (la mayoría de Europa/NA)	Audiencia diferente; LINE gana para consumidores JP/TW/TH
Telegram MCP	El objetivo del bot son usuarios de Telegram	Dominio geográfico diferente; sin cuotas de Cuenta Oficial/broadcast
WhatsApp Cloud API MCP	Necesitas llegar a consumidores de SEA/LATAM	Incorporación de BSP más pesada; aprobación de plantillas más estricta

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills