Integrasi Model Context Protocol (MCP)

Travel Impact Model (TIM) API mendukung Model Context Protocol (MCP), sebuah standar terbuka yang dirancang untuk agen AI dan Model Bahasa Besar (LLM) untuk berinteraksi dengan API dan alat. Dengan menggunakan endpoint MCP, agen AI dapat menemukan dan menggunakan kemampuan TIM API secara dinamis untuk menghitung emisi penerbangan.

Untuk mengetahui informasi selengkapnya tentang protokol, lihat Spesifikasi Model Context Protocol.

Endpoint

Endpoint MCP untuk Travel Impact Model API adalah:

https://travelimpactmodel.googleapis.com/mcp

Semua interaksi MCP dilakukan dengan mengirimkan permintaan POST JSON-RPC 2.0 ke endpoint ini.

Autentikasi

Endpoint MCP menggunakan metode autentikasi yang sama dengan Travel Impact Model API standar. Anda harus memberikan kunci API yang valid dari project Google Cloud, dan memastikan "Travel Impact Model API" diaktifkan.

Metode MCP Inti

Interaksi dengan endpoint MCP terutama menggunakan dua metode:

  • tools/list: Menemukan alat yang tersedia, deskripsinya, dan skema JSON input/output-nya.
  • tools/call: Menjalankan alat tertentu dengan argumen yang diberikan.

Alat yang Tersedia

Fungsi berikut diekspos sebagai alat:

  • compute_flight_emissions: Mengambil emisi terperinci untuk penerbangan mendatang tertentu.
  • compute_typical_flight_emissions: Mengambil emisi umum antara pasangan bandara, tanpa memerlukan detail penerbangan tertentu.
  • compute_scope3_flight_emissions: Mengambil emisi untuk penerbangan historis, yang sesuai untuk pelaporan Cakupan 3.

Skema yang tepat untuk input dan output disediakan dalam respons tools/list.

Mengintegrasikan dengan Agen AI

Konfigurasi aplikasi AI populer menggunakan petunjuk ini. Ganti YOUR_API_KEY dengan kunci Travel Impact Model API Anda.

Gemini CLI

Untuk mengonfigurasi Gemini CLI, ikuti langkah-langkah berikut:

  1. Buat file ekstensi di ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Simpan konten berikut dalam file:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Luncurkan Gemini CLI dengan menjalankan gemini di terminal Anda.

  4. Jalankan /mcp list untuk memverifikasi bahwa server travel-impact-model dikonfigurasi dan alatnya tersedia.

Antigravity

Untuk mengonfigurasi Antigravity agar menggunakan server MCP:

  1. Di Antigravity, klik menu Opsi tambahan di panel Agent > Server MCP > Kelola Server MCP.

  2. Di bagian atas panel Kelola Server MCP yang terbuka, klik Lihat konfigurasi mentah untuk mengedit file mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Kembali ke Kelola server MCP dan klik Refresh.

Contoh Interaksi

Setelah dikonfigurasi, Anda dapat berinteraksi dengan TIM API melalui agen AI menggunakan bahasa alami.

Pengguna: Berapa emisi untuk penerbangan LX 52 dari Zurich ke Boston?

Agen: Perkiraan emisi karbon per penumpang untuk penerbangan Swiss International Air Lines LX 52 dari Zurich (ZRH) ke Boston (BOS) untuk hari ini, 25 Maret 2026, adalah sebagai berikut:

  • Ekonomi: 354,10 kg CO2e
  • Ekonomi Premium: 531,14 kg CO2e
  • Bisnis: 1.416,38 kg CO2e
  • Pertama: 1.770,48 kg CO2e

Penerbangan ini memiliki perkiraan dampak kontrail yang sedang.

Pengguna: Berapa emisi umum dari Zurich ke Boston?

Agen: Emisi karbon umum per penumpang untuk penerbangan dari Zurich (ZRH) ke Boston (BOS) adalah sebagai berikut:

  • Ekonomi: 415,41 kg CO2e
  • Ekonomi Premium: 582,00 kg CO2e
  • Bisnis: 1.473,95 kg CO2e
  • Pertama: 1.817,35 kg CO2e