navi MCP

Navi MCP Server - Real-Time Google Sheets Integration

MCP (Model Context Protocol) Server untuk AI Agent Navi di ElevenLabs. Server ini mengintegrasikan 3 Google Sheets sebagai backend data real-time untuk costume rental business.

📋 Arsitektur Sistem

Google Sheets (3 sheets)
    ↓ (Apps Script Web API - JSON)
MCP Server (Node.js di VPS)
    ↓ (stdio)
ElevenLabs Agent (Navi)
    ↓
Customer

🗂️ Data Sources

1. Stock Sheet

Kolom: Costume, ImageURL, Tagline/CosplayLevel, Tier, RYS, Size Available, ETA S, ETA M, ETA L, ETA XL, Includes

2. Reservation Sheet

Kolom: Nama, Cosplay, Size, Tier, RYS, Additional, Price, Tanggal

3. Price Catalog Sheet

Kolom: Cosplay, Series, Brand, Tier, RYS, PPR, Purchase

🛠️ Setup & Installation

Step 1: Setup Google Sheets Apps Script

Untuk setiap sheet, buat Apps Script dengan kode berikut:

function doGet() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var data = sheet.getDataRange().getValues();
  var headers = data[0];
  var result = [];
  
  for (var i = 1; i = 18
- npm
- VPS dengan akses SSH
- Domain/IP VPS accessible dari ElevenLabs

### Steps

1. Clone/upload project ke VPS

scp -r navi-mcp user@your-vps-ip:/home/user/

2. SSH ke VPS

ssh user@your-vps-ip

3. Install dependencies

cd /home/user/navi-mcp npm install

4. Test run

npm start

5. Setup PM2 untuk auto-restart (optional)

npm install -g pm2 pm2 start mcp-server.js --name navi-mcp pm2 save pm2 startup

## 🔒 Security Notes

- Apps Script URLs yang di-deploy sebagai "Anyone" bisa diakses publik
- Pastikan tidak ada sensitive data di sheet yang di-expose
- Pertimbangkan rate limiting jika traffic tinggi
- Untuk production, gunakan authentication di Apps Script

## 📝 Troubleshooting

### Error: Cannot find module '@modelcontextprotocol/sdk'

rm -rf node_modules package-lock.json npm install

### Error: fetch failed / CORS
- Pastikan Apps Script sudah di-deploy dengan akses "Anyone"
- Test URL di browser, harus return JSON array

### ElevenLabs tidak bisa connect ke MCP
- Pastikan path absolut ke mcp-server.js benar
- Check logs di ElevenLabs MCP console
- Test manual: `node mcp-server.js` di terminal

## 📚 Resources

- [Model Context Protocol Docs](https://modelcontextprotocol.io/)
- [ElevenLabs MCP Guide](https://elevenlabs.io/docs/mcp)
- [Google Apps Script Web Apps](https://developers.google.com/apps-script/guides/web)

## 📄 License

ISC

---

**Dibuat untuk UAS - Integrasi AI Agent dengan Real-Time Data Backend**