LINE MCP Server

Remote MCP Server สำหรับเชื่อมต่อ LINE Messaging API เข้ากับ Claude Cowork (และ Claude ทุก client) ผ่านโปรโตคอล MCP แบบ Streamable HTTP — สั่งให้ Claude ส่งข้อความ LINE, ดูโปรไฟล์ผู้ใช้ และเช็คโควต้าได้จากในแชทโดยตรง

สร้างมาเพื่อใช้สาธิตในห้องเรียนและงานจริง deploy บน Render ได้ทันที

คุณสมบัติ (Tools ที่มีให้)

push_course_card ใส่แค่ title, description, imageUrl, price, buttonLabel, buttonUrl ระบบจะประกอบ Flex bubble ให้เอง — ส่วนที่ไม่ได้ใส่จะถูกตัดออกอัตโนมัติ

multicast_from_csv Claude เป็นผู้อ่านไฟล์ CSV (จาก Drive หรือเครื่อง) แล้วส่งเนื้อหาเข้ามา ตัว server จะมองหาคอลัมน์ชื่อ userId อัตโนมัติ (หรือระบุชื่อคอลัมน์เองได้) แล้ว batch ส่งทีละ 500 พร้อมตัดค่าซ้ำและกรอง userId ที่รูปแบบผิดออกให้

Related MCP server: MCP LINE Server

สถาปัตยกรรมที่ควรเข้าใจก่อน

Claude เชื่อมต่อ Remote MCP Server จาก Cloud ของ Anthropic ไม่ใช่จากเครื่องของเรา ดังนั้น server ตัวนี้ต้องเข้าถึงได้ผ่าน Public Internet เสมอ — รันแบบ localhost จะใช้กับ Claude ไม่ได้ จึงต้อง deploy ขึ้น Render (หรือ cloud อื่น) ก่อน

Claude Cowork
      │  HTTPS (Streamable HTTP) จาก Anthropic Cloud
      ▼
LINE MCP Server บน Render   ← โปรเจกต์นี้
      │  LINE Messaging API + Channel Access Token
      ▼
LINE Platform → ผู้ใช้ / กลุ่ม LINE

สิ่งที่ต้องเตรียม

1. LINE Channel Access Token (แบบ long-lived)

   • ไปที่ LINE Developers Console

   • สร้าง Provider → สร้าง Channel แบบ Messaging API

   • ไปที่แท็บ Messaging API แล้ว Issue ค่า Channel access token (long-lived)

2. บัญชี Render (ใช้ free tier ได้)

3. บัญชี GitHub สำหรับเก็บโค้ด

โครงสร้างโปรเจกต์

line-mcp-server/
├── src/
│   ├── config/
│   │   └── env.ts          # โหลดและตรวจสอบ environment variables
│   ├── line/
│   │   ├── client.ts       # LINE Messaging API client (fetch wrapper)
│   │   ├── flex.ts         # helper สร้างการ์ดประกาศคอร์ส (Flex bubble)
│   │   ├── csv.ts          # สกัด userId จาก CSV (dedup + validate)
│   │   └── types.ts        # type ของ LINE API
│   ├── mcp/
│   │   └── server.ts       # สร้าง McpServer + ลงทะเบียน tools ทั้ง 8 ตัว
│   ├── http/
│   │   └── app.ts          # Express + Streamable HTTP transport + session
│   ├── utils/
│   │   └── array.ts        # util แบ่ง array เป็น chunk สำหรับ batch
│   └── index.ts            # entry point
├── render.yaml             # Render Blueprint สำหรับ deploy อัตโนมัติ
├── .nvmrc                  # pin Node 22 (เลี่ยงปัญหา corepack ใน Node 25+)
├── .env.example
├── package.json
└── tsconfig.json

รันในเครื่อง (Local)

# 1) ติดตั้ง dependencies
corepack enable
pnpm install

# 2) ตั้งค่า environment variables
cp .env.example .env
# แก้ไฟล์ .env ใส่ LINE_CHANNEL_ACCESS_TOKEN และ MCP_SECRET

# 3) รันแบบ dev (auto-reload)
pnpm dev

# ตรวจสอบว่า server ขึ้น
curl http://localhost:3000/
# => {"status":"ok","service":"line-messaging-mcp"}

Deploy บน Render

วิธีที่ 1: ใช้ Blueprint (แนะนำ — เร็วที่สุด)

1. Push โค้ดทั้งหมดขึ้น GitHub repository

2. ที่ Render Dashboard กด New + → Blueprint

3. เลือก repository ที่ push ไป — Render จะอ่าน render.yaml ให้อัตโนมัติ

4. กรอกค่า LINE_CHANNEL_ACCESS_TOKEN (ค่า MCP_SECRET จะถูกสุ่มให้เอง)

5. กด Apply แล้วรอ deploy เสร็จ

วิธีที่ 2: ตั้งค่าเอง (Manual)

1. New + → Web Service → เชื่อม GitHub repo

2. ตั้งค่าตามนี้:

   • Runtime: Node

   • Build Command: corepack enable && pnpm install --frozen-lockfile

   • Start Command: pnpm start

   • Health Check Path: /

3. แท็บ Environment เพิ่มตัวแปร:

   • LINE_CHANNEL_ACCESS_TOKEN = token จาก LINE

   • MCP_SECRET = สตริงสุ่มยาว ๆ ที่เดายาก (เช่น openssl rand -hex 16)

4. กด Create Web Service

เมื่อ deploy เสร็จจะได้ URL เช่น https://line-mcp-server.onrender.com

เพิ่มเป็น Custom Connector ใน Claude Cowork

1. หา URL ของ MCP endpoint จากค่าด้านบน — รูปแบบคือ:

   https://<ชื่อ-app>.onrender.com/mcp/<MCP_SECRET>

   สำคัญ: ต่อท้ายด้วย /mcp/<MCP_SECRET> เสมอ (เปิดดูค่า MCP_SECRET ที่ Render สุ่มให้ได้ในแท็บ Environment)

2. ใน Claude เปิด Settings → Connectors → กดปุ่ม + ข้าง Connectors

3. กรอก:

   • Name: LINE Messaging

   • URL: URL จากข้อ 1

4. กด Add แล้วเปิดใช้งาน connector ในแชทผ่านปุ่ม + → Connectors

5. ทดลองสั่ง เช่น "ส่งข้อความหา userId Uxxxx ว่าสวัสดีครับ"

ตัวอย่างคำสั่งที่ใช้ tools ใหม่

• การ์ดประกาศคอร์ส: "ส่งการ์ดคอร์ส React.js Basic to Intermediate ราคา ฿4,900 รูปจาก ปุ่มลิงก์ไป itgenius.co.th/react ไปยัง groupId Cxxxx"

• multicast จาก CSV: "อ่าน userId จากไฟล์ students.csv แล้วส่งข้อความแจ้งเตือนคลาสพรุ่งนี้หาทุกคน" (Claude อ่านไฟล์เองแล้วส่งเข้า multicast_from_csv)

• Flex แบบกำหนดเอง: "ส่ง Flex carousel โปรโมต 3 คอร์สนี้..." (Claude ออกแบบ Flex JSON แล้วส่งผ่าน push_flex_message)

หมายเหตุด้านความปลอดภัยและข้อจำกัด

• ป้องกัน endpoint เสมอ — Custom Connector เป็นบริการที่ Anthropic ยังไม่ได้ตรวจสอบ ควรตั้ง MCP_SECRET ทุกครั้ง เพราะ secret ที่ฝังใน path ทำหน้าที่เหมือนกุญแจเข้า server

• อย่า commit token ลง git — .env ถูก ignore ไว้แล้ว ใส่ค่าจริงผ่าน Render Environment เท่านั้น

• Free tier ของ Render จะ sleep หลังไม่มีทราฟฟิก ~15 นาที — request แรกหลัง sleep จะช้า (cold start ~50 วินาที) ถ้าใช้ในห้องเรียนจริงแนะนำ upgrade เป็น paid plan หรือยิง health check กันหลับ

• หากต้องการความปลอดภัยระดับ production เต็มรูปแบบ ควรเปลี่ยนไปใช้ OAuth 2.0 แทน path-based secret

อ้างอิง

• LINE Messaging API Reference — https://developers.line.biz/en/reference/messaging-api/

• MCP TypeScript SDK — https://github.com/modelcontextprotocol/typescript-sdk

• Custom Connectors via Remote MCP — https://support.claude.com/en/articles/11175166

• Render Blueprint Spec — https://render.com/docs/blueprint-spec