Integrasi Model Context Protocol (MCP)

Travel Impact Model (TIM) API mendukung Model Context Protocol (MCP), standar terbuka yang dirancang agar agen AI dan Model Bahasa Besar (LLM) dapat 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 mengirim 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 Anda, 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/outputnya.
  • tools/call: Menjalankan alat tertentu dengan argumen yang diberikan.

Alat yang Tersedia

Fungsi berikut tersedia sebagai alat:

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

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

Berintegrasi dengan Agen AI

Konfigurasi aplikasi AI populer menggunakan petunjuk ini. Ganti YOUR_API_KEY dengan kunci API Travel Impact Model 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 Additional options di panel Agent > MCP Servers > Manage MCP Servers.

  2. Di bagian atas panel Manage MCP Servers yang terbuka, klik View raw config 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 Manage MCP servers, lalu 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
  • Premium Economy: 531,14 kg CO2e
  • Bisnis: 1.416,38 kg CO2e
  • Pertama: 1.770,48 kg CO2e

Penerbangan ini memiliki perkiraan dampak kontrail sedang.

Pengguna: Berapa emisi standar dari Zurich ke Boston?

Agen: Emisi karbon 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